dex-connector-clickup 0.1.0__py3-none-any.whl

dex_connector_clickup-0.1.0.dist-info/METADATA

@@ -0,0 +1,21 @@
+Metadata-Version: 2.5
+Name: dex-connector-clickup
+Version: 0.1.0
+Summary: ClickUp connector for Dex Flows
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: dex-connectors-sdk==0.1.0
+Requires-Dist: dex-python-sdk>=1.28.0
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# ClickUp Python connector
+
+The package implements the ClickUp `searchTasks`, `getTask`, `createTask`, `updateTask`, `updateTaskTags`, `addComment`, and `findMemberByEmail` operations for Dex Flows. The `taskEvent` webhook Trigger remains Go-only. Install `dex-connector-clickup==0.1.0` alongside a Dex Python application and load its named connection from Dex project configuration. The connection uses a ClickUp personal API token and resolves it before each provider request.
+
+The [getTask runnable example](examples/get_task/README.md) uses a static `clickup-workspace` connection and a real Dex Worker and Client. Its integration test exercises a retry and an unwired rejection branch against a local ClickUp stand-in. Run from this directory with `uv sync --locked`, then `uv run pytest tests/ examples/get_task/integration_test.py` while `dexcli dev` is running and `DEX_FLOW_SERVICE_ADDRESS` points to it.
+
+`createTask` and `addComment` store a Dex heartbeat checkpoint before an unkeyed write. If a retry sees the checkpoint, it reads back instead of sending the write again; an unconfirmable outcome selects `uncertain`. The provider has no idempotency-key support for these calls. The Python package currently has no live ClickUp authorization or API verification.
+
+`getTask` returns custom field JSON values only when Python can represent their numbers exactly. A value that would lose precision selects `invalidResponse` and identifies the field. `updateTaskTags` bounds its sequence of provider requests to 25 seconds; an incomplete sequence retries.

dex_connector_clickup-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+dex_connectors/clickup/__init__.py,sha256=Eaaa0BjxIgjX3WTXHyLXRh60Sz9fpAsiXza2qoZ2zdg,2707
+dex_connectors/clickup/client.py,sha256=1_ed8nbOiW5T1mhjJdXrQP5ZIX0NvTR-YJ4y8qTBFiU,23257
+dex_connectors/clickup/connection.py,sha256=wFi4Yucb6tYGqUKV6MLyNTV9np84kd-mpiOYRGB1lkw,424
+dex_connectors/clickup/dex-connector.json,sha256=cKiQD2qoPB4xT8ktLsuIPWdL2R4JHPdDt1rcXrJ7hcU,6419
+dex_connectors/clickup/models.py,sha256=kp2R3g5rCEDwyilbmOsRoVIVX-3RPDGgY5H5X7fDJRY,1380
+dex_connectors/clickup/operations.py,sha256=M8SCVE5Mz-2eq5mbL5bZy7ZnRDKgm5AlE6X8Tn0G6yc,41564
+dex_connectors/clickup/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dex_connectors/clickup/steps.py,sha256=ngOlQdc2Qvb9uzhmdlBZOWIJwUTMaIC04tHOOJ4zNj0,667
+dex_connectors/clickup/_generated/__init__.py,sha256=ShfMsAGzSt4xuhCaf20ibgtfXl4pXomZb00ovUw6CeI,66
+dex_connectors/clickup/_generated/config.py,sha256=A2ygvyxiyu7X-WQ2iBV7jEdItNlSNPhtxniVelSGrNA,544
+dex_connectors/clickup/_generated/connection.py,sha256=EN4J1dYeizOhLonHHpitihD6QooRw9hGWdlccUMTOAI,8997
+dex_connectors/clickup/_generated/definitions.py,sha256=dMjE5iVMbL31H-1_uTPH0e0ePD8vjPbR4I_Wu4CCPug,7435
+dex_connectors/clickup/_generated/mock.py,sha256=h1su5PqovNUOd0I1cCY8o2pxHOrQkaXntz7WesaTxXc,24792
+dex_connectors/clickup/_generated/models.py,sha256=_lUiEUxgzn0i4MhTMbSEpxcWcdYWIngmirRLuBg9hAg,24681
+dex_connectors/clickup/_generated/steps.py,sha256=59KdwrQNzAfe7RrmBLEUXV3D9Ssx1ss89kXV_Z0WJe4,18804
+dex_connectors/clickup/_generated/timestamps.py,sha256=Z8VwrE60w-33InIMgEMLiMPTFyRjj6oBq8tUro8Ssi8,3164
+dex_connectors/clickup/clickupmock/__init__.py,sha256=sEODfqQ6BJ0_cxRmH7FUHlzuhGC26jntpGD0cmUtm_U,167
+dex_connector_clickup-0.1.0.dist-info/METADATA,sha256=mQs1D691Ivgp2Tl8kKVMp4-i7bXY2_KCPTFKaXOIbzg,1888
+dex_connector_clickup-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+dex_connector_clickup-0.1.0.dist-info/licenses/LICENSE,sha256=WNj87Zd5micrAShl1LujOPM6PDzDqjlNLrryDZ4hE0M,1070
+dex_connector_clickup-0.1.0.dist-info/RECORD,,

dex_connector_clickup-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dex_connector_clickup-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Super Durable
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dex_connectors/clickup/__init__.py

@@ -0,0 +1,71 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Dex-native ClickUp task operations."""
+
+from .client import Client as Client
+from .client import Config as Config
+from .client import Credentials as Credentials
+from .connection import Connection as Connection
+from .connection import new_connection as new_connection
+from .connection import new_connection_with_operations as new_connection_with_operations
+from .connection import new_project_connection as new_project_connection
+from .models import AddCommentInput as AddCommentInput
+from .models import AddCommentOutput as AddCommentOutput
+from .models import CreateTaskInput as CreateTaskInput
+from .models import CreateTaskOutput as CreateTaskOutput
+from .models import CustomFieldInput as CustomFieldInput
+from .models import CustomFieldValue as CustomFieldValue
+from .models import FindMemberByEmailInput as FindMemberByEmailInput
+from .models import GetTaskInput as GetTaskInput
+from .models import Member as Member
+from .models import SearchTasksInput as SearchTasksInput
+from .models import SearchTasksOutput as SearchTasksOutput
+from .models import Task as Task
+from .models import TaskStatus as TaskStatus
+from .models import UpdateTaskInput as UpdateTaskInput
+from .models import UpdateTaskOutput as UpdateTaskOutput
+from .models import UpdateTaskTagsInput as UpdateTaskTagsInput
+from .models import UpdateTaskTagsOutput as UpdateTaskTagsOutput
+from .models import User as User
+from .steps import new_add_comment_step as new_add_comment_step
+from .steps import new_create_task_step as new_create_task_step
+from .steps import new_find_member_by_email_step as new_find_member_by_email_step
+from .steps import new_get_task_step as new_get_task_step
+from .steps import new_search_tasks_step as new_search_tasks_step
+from .steps import new_update_task_step as new_update_task_step
+from .steps import new_update_task_tags_step as new_update_task_tags_step
+
+__all__ = [
+    "AddCommentInput",
+    "AddCommentOutput",
+    "Client",
+    "Config",
+    "Connection",
+    "CreateTaskInput",
+    "CreateTaskOutput",
+    "Credentials",
+    "CustomFieldInput",
+    "CustomFieldValue",
+    "FindMemberByEmailInput",
+    "GetTaskInput",
+    "Member",
+    "SearchTasksInput",
+    "SearchTasksOutput",
+    "Task",
+    "TaskStatus",
+    "UpdateTaskInput",
+    "UpdateTaskOutput",
+    "UpdateTaskTagsInput",
+    "UpdateTaskTagsOutput",
+    "User",
+    "new_add_comment_step",
+    "new_connection",
+    "new_connection_with_operations",
+    "new_create_task_step",
+    "new_find_member_by_email_step",
+    "new_get_task_step",
+    "new_project_connection",
+    "new_search_tasks_step",
+    "new_update_task_step",
+    "new_update_task_tags_step",
+]

dex_connectors/clickup/_generated/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT

dex_connectors/clickup/_generated/config.py

@@ -0,0 +1,25 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from dataclasses import dataclass
+
+from dex_connectors.sdk import SecretString
+
+
+@dataclass(frozen=True, slots=True)
+class Config:
+
+    max_response_bytes: int = 4194304
+    webhook_max_body_bytes: int = 1048576
+
+setattr(Config, '__module__', 'dex_connectors.clickup.client')
+
+
+@dataclass(frozen=True, slots=True)
+class Credentials:
+
+    api_token: SecretString
+    webhook_secret: SecretString
+
+setattr(Credentials, '__module__', 'dex_connectors.clickup.client')

dex_connectors/clickup/_generated/connection.py

@@ -0,0 +1,175 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from typing import Any
+
+import httpx
+from dex_connectors.sdk import ConnectionRef, Mutation, Query, Call, SecretString
+from dex_connectors.sdk.projectconfig import ConnectionKey, LoadedProject
+
+from ..client import Client, Config, Credentials
+from .definitions import CONNECTOR_ID, ADD_COMMENT_DEFINITION, CREATE_TASK_DEFINITION, FIND_MEMBER_BY_EMAIL_DEFINITION, GET_TASK_DEFINITION, SEARCH_TASKS_DEFINITION, UPDATE_TASK_DEFINITION, UPDATE_TASK_TAGS_DEFINITION
+from ..models import AddCommentInput, AddCommentOutput, CreateTaskInput, CreateTaskOutput, FindMemberByEmailInput, GetTaskInput, Member, SearchTasksInput, SearchTasksOutput, Task, UpdateTaskInput, UpdateTaskOutput, UpdateTaskTagsInput, UpdateTaskTagsOutput
+
+class Connection:
+
+    __slots__ = ('_search_tasks', '_get_task', '_create_task', '_update_task', '_update_task_tags', '_add_comment', '_find_member_by_email', '_client', 'reference')
+
+    def __init__(self,
+        reference: ConnectionRef,
+        search_tasks: Query[SearchTasksInput, SearchTasksOutput],
+        get_task: Query[GetTaskInput, Task],
+        create_task: Mutation[CreateTaskInput, CreateTaskOutput],
+        update_task: Mutation[UpdateTaskInput, UpdateTaskOutput],
+        update_task_tags: Mutation[UpdateTaskTagsInput, UpdateTaskTagsOutput],
+        add_comment: Mutation[AddCommentInput, AddCommentOutput],
+        find_member_by_email: Query[FindMemberByEmailInput, Member],
+        client: Client | None = None,
+    ) -> None:
+        reference.validate()
+        if reference.provider != CONNECTOR_ID or search_tasks is None or get_task is None or create_task is None or update_task is None or update_task_tags is None or add_comment is None or find_member_by_email is None:
+            raise ValueError("ClickUp connection provider and operations are required")
+        if search_tasks.definition().operation != SEARCH_TASKS_DEFINITION.operation:
+            raise ValueError("ClickUp connection operation identity differs")
+        if get_task.definition().operation != GET_TASK_DEFINITION.operation:
+            raise ValueError("ClickUp connection operation identity differs")
+        if create_task.definition().operation != CREATE_TASK_DEFINITION.operation:
+            raise ValueError("ClickUp connection operation identity differs")
+        if update_task.definition().operation != UPDATE_TASK_DEFINITION.operation:
+            raise ValueError("ClickUp connection operation identity differs")
+        if update_task_tags.definition().operation != UPDATE_TASK_TAGS_DEFINITION.operation:
+            raise ValueError("ClickUp connection operation identity differs")
+        if add_comment.definition().operation != ADD_COMMENT_DEFINITION.operation:
+            raise ValueError("ClickUp connection operation identity differs")
+        if find_member_by_email.definition().operation != FIND_MEMBER_BY_EMAIL_DEFINITION.operation:
+            raise ValueError("ClickUp connection operation identity differs")
+        self.reference = reference
+        self._search_tasks = search_tasks
+        self._get_task = get_task
+        self._create_task = create_task
+        self._update_task = update_task
+        self._update_task_tags = update_task_tags
+        self._add_comment = add_comment
+        self._find_member_by_email = find_member_by_email
+        self._client = client
+
+    def search_tasks(self) -> Query[SearchTasksInput, SearchTasksOutput]:
+        return self._search_tasks
+
+    def get_task(self) -> Query[GetTaskInput, Task]:
+        return self._get_task
+
+    def create_task(self) -> Mutation[CreateTaskInput, CreateTaskOutput]:
+        return self._create_task
+
+    def update_task(self) -> Mutation[UpdateTaskInput, UpdateTaskOutput]:
+        return self._update_task
+
+    def update_task_tags(self) -> Mutation[UpdateTaskTagsInput, UpdateTaskTagsOutput]:
+        return self._update_task_tags
+
+    def add_comment(self) -> Mutation[AddCommentInput, AddCommentOutput]:
+        return self._add_comment
+
+    def find_member_by_email(self) -> Query[FindMemberByEmailInput, Member]:
+        return self._find_member_by_email
+
+    async def aclose(self) -> None:
+        if self._client is not None:
+            await self._client.aclose()
+
+    def __repr__(self) -> str:
+        return "clickup.Connection([REDACTED])"
+
+    def __reduce__(self) -> tuple[object, ...]:
+        raise TypeError("ClickUp connections cannot be serialized")
+
+setattr(Connection, '__module__', 'dex_connectors.clickup.connection')
+
+
+def new_connection(client: Client, reference: ConnectionRef) -> Connection:
+    if client is None:
+        raise ValueError("ClickUp client is required")
+    return Connection(reference, client.search_tasks(), client.get_task(), client.create_task(), client.update_task(), client.update_task_tags(), client.add_comment(), client.find_member_by_email(), client)
+
+setattr(new_connection, '__module__', 'dex_connectors.clickup.connection')
+
+
+def new_connection_with_operations(
+    search_tasks: Query[SearchTasksInput, SearchTasksOutput],
+    get_task: Query[GetTaskInput, Task],
+    create_task: Mutation[CreateTaskInput, CreateTaskOutput],
+    update_task: Mutation[UpdateTaskInput, UpdateTaskOutput],
+    update_task_tags: Mutation[UpdateTaskTagsInput, UpdateTaskTagsOutput],
+    add_comment: Mutation[AddCommentInput, AddCommentOutput],
+    find_member_by_email: Query[FindMemberByEmailInput, Member],
+    reference: ConnectionRef,
+) -> Connection:
+    return Connection(reference, search_tasks, get_task, create_task, update_task, update_task_tags, add_comment, find_member_by_email)
+
+setattr(new_connection_with_operations, '__module__', 'dex_connectors.clickup.connection')
+
+
+class _ProjectCredentialSource:
+
+    def __init__(self, project: LoadedProject, key: ConnectionKey) -> None:
+        self.project = project
+        self.key = key
+
+    async def resolve(self, call: Call) -> Credentials:
+        material = await self.project.resolve_credential(self.key, str(call.id))
+        if not isinstance(material, dict):
+            raise ValueError("ClickUp stored credential does not match the connector credential fields")
+        if set(material) - set(('api_token', 'webhook_secret')):
+            raise ValueError("ClickUp stored credential does not match the connector credential fields")
+        api_token = material.get("api_token")
+        if api_token is not None and not (isinstance(api_token, str)):
+            raise ValueError("ClickUp credential api_token has an invalid type")
+        webhook_secret = material.get("webhook_secret")
+        if webhook_secret is not None and not (isinstance(webhook_secret, str)):
+            raise ValueError("ClickUp credential webhook_secret has an invalid type")
+        if not api_token:
+            raise ValueError("ClickUp credential api_token is required")
+        return Credentials(SecretString(api_token), SecretString(webhook_secret or ''))
+
+
+def new_project_connection(
+    project: LoadedProject, connection_name: str, http_client: httpx.AsyncClient | None = None
+) -> Connection:
+    if project is None:
+        raise ValueError("ClickUp connection requires loaded project configuration")
+    reference = ConnectionRef(CONNECTOR_ID, connection_name)
+    reference.validate()
+    key = ConnectionKey(CONNECTOR_ID, connection_name)
+    matching = [
+        entry
+        for entry in project.configuration.connections
+        if entry.connector_id == CONNECTOR_ID and entry.connection_name == connection_name
+    ]
+    if len(matching) != 1:
+        raise ValueError("ClickUp project connection is missing or duplicated")
+    if matching[0].provider != CONNECTOR_ID:
+        raise ValueError("ClickUp project connection provider differs")
+    config = _decode_config(matching[0].configuration)
+    client = Client(config, _ProjectCredentialSource(project, key), http_client)
+    return new_connection(client, reference)
+
+setattr(new_project_connection, '__module__', 'dex_connectors.clickup.connection')
+
+
+def _decode_config(value: dict[str, Any]) -> Config:
+    if set(value) - {"maxResponseBytes", "webhookMaxBodyBytes"}:
+        raise ValueError("ClickUp configuration has unknown fields")
+    config_arguments: dict[str, Any] = {}
+    if "maxResponseBytes" in value and value["maxResponseBytes"] != '':
+        max_response_bytes = value["maxResponseBytes"]
+        if not (type(max_response_bytes) is int):
+            raise ValueError("ClickUp configuration maxResponseBytes has an invalid type")
+        config_arguments['max_response_bytes'] = max_response_bytes
+    if "webhookMaxBodyBytes" in value and value["webhookMaxBodyBytes"] != '':
+        webhook_max_body_bytes = value["webhookMaxBodyBytes"]
+        if not (type(webhook_max_body_bytes) is int):
+            raise ValueError("ClickUp configuration webhookMaxBodyBytes has an invalid type")
+        config_arguments['webhook_max_body_bytes'] = webhook_max_body_bytes
+    return Config(**config_arguments)

dex_connectors/clickup/_generated/definitions.py

@@ -0,0 +1,147 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from datetime import timedelta
+
+from dex_connectors.sdk import (
+    BranchDefinition,
+    MutationDefinition,
+    OperationRef,
+    QueryDefinition,
+    RetryPolicy,
+    StepDefaults,
+    default_connector_step_execute_retry_policy,
+)
+
+CONNECTOR_ID = "clickup"
+PROVIDER = "clickup"
+SEARCH_TASKS_OPERATION_ID = "searchTasks"
+GET_TASK_OPERATION_ID = "getTask"
+CREATE_TASK_OPERATION_ID = "createTask"
+UPDATE_TASK_OPERATION_ID = "updateTask"
+UPDATE_TASK_TAGS_OPERATION_ID = "updateTaskTags"
+ADD_COMMENT_OPERATION_ID = "addComment"
+FIND_MEMBER_BY_EMAIL_OPERATION_ID = "findMemberByEmail"
+ADDED = "added"
+CREATED = "created"
+DEFECT = "defect"
+FOUND = "found"
+INVALID_RESPONSE = "invalidResponse"
+NOT_FOUND = "notFound"
+PROVIDER_REJECTED = "providerRejected"
+SEARCHED = "searched"
+UNCERTAIN = "uncertain"
+UPDATED = "updated"
+
+SEARCH_TASKS_DEFINITION = QueryDefinition(
+    OperationRef(CONNECTOR_ID, SEARCH_TASKS_OPERATION_ID),
+    (
+        BranchDefinition(SEARCHED, "One page of matching tasks was read; it can be empty.", False),
+        BranchDefinition(NOT_FOUND, "The Workspace does not exist or the token's user is not a member of it.", True),
+        BranchDefinition(PROVIDER_REJECTED, "ClickUp conclusively rejected the search, such as an invalid filter or an invalid token.", True),
+        BranchDefinition(INVALID_RESPONSE, "ClickUp returned an invalid or oversized page of tasks.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=default_connector_step_execute_retry_policy(),
+    ),
+)
+
+GET_TASK_DEFINITION = QueryDefinition(
+    OperationRef(CONNECTOR_ID, GET_TASK_OPERATION_ID),
+    (
+        BranchDefinition(FOUND, "The task was read.", False),
+        BranchDefinition(NOT_FOUND, "The task does not exist or the connection cannot see it.", True),
+        BranchDefinition(PROVIDER_REJECTED, "ClickUp conclusively rejected the task read.", True),
+        BranchDefinition(INVALID_RESPONSE, "ClickUp returned an invalid or oversized task.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=default_connector_step_execute_retry_policy(),
+    ),
+)
+
+CREATE_TASK_DEFINITION = MutationDefinition(
+    OperationRef(CONNECTOR_ID, CREATE_TASK_OPERATION_ID),
+    (
+        BranchDefinition(CREATED, "ClickUp created the task; a retried attempt that found its own earlier task in the List reports it instead of creating another.", False),
+        BranchDefinition(NOT_FOUND, "The List does not exist or the connection cannot see it; nothing was created.", True),
+        BranchDefinition(PROVIDER_REJECTED, "ClickUp conclusively rejected the task, such as an unknown status, assignee, or custom field value, or missing permission; nothing was created.", True),
+        BranchDefinition(UNCERTAIN, "An earlier attempt sent the create but its outcome cannot be confirmed and the List shows no single matching task, so the task may exist; the connector never sends it again.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        1,
+        execute_retry=RetryPolicy(timedelta(seconds=1), 2, timedelta(seconds=60), 5, timedelta(seconds=300)),
+    ),
+)
+
+UPDATE_TASK_DEFINITION = MutationDefinition(
+    OperationRef(CONNECTOR_ID, UPDATE_TASK_OPERATION_ID),
+    (
+        BranchDefinition(UPDATED, "ClickUp applied every requested change, including when the task already had those values, and the Value holds the task it returned.", False),
+        BranchDefinition(NOT_FOUND, "The task does not exist or the connection cannot see it.", True),
+        BranchDefinition(PROVIDER_REJECTED, "ClickUp conclusively rejected the change, such as a status that is not in the task's List or missing permission.", True),
+        BranchDefinition(INVALID_RESPONSE, "ClickUp returned an invalid or oversized task after the update, so the change may have been applied.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=default_connector_step_execute_retry_policy(),
+    ),
+)
+
+UPDATE_TASK_TAGS_DEFINITION = MutationDefinition(
+    OperationRef(CONNECTOR_ID, UPDATE_TASK_TAGS_OPERATION_ID),
+    (
+        BranchDefinition(UPDATED, "ClickUp applied every tag change, and the Value holds the task's tags read back.", False),
+        BranchDefinition(NOT_FOUND, "The task does not exist or the connection cannot see it.", True),
+        BranchDefinition(PROVIDER_REJECTED, "ClickUp conclusively rejected a tag change, such as missing permission; earlier changes in the same Step may have been applied.", True),
+        BranchDefinition(INVALID_RESPONSE, "ClickUp returned an invalid or oversized task when its tags were read back; the tag changes were applied.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=default_connector_step_execute_retry_policy(),
+    ),
+)
+
+ADD_COMMENT_DEFINITION = MutationDefinition(
+    OperationRef(CONNECTOR_ID, ADD_COMMENT_OPERATION_ID),
+    (
+        BranchDefinition(ADDED, "The comment is on the task; a retried attempt that found its own earlier comment reports it instead of adding another.", False),
+        BranchDefinition(NOT_FOUND, "The task does not exist or the connection cannot see it; nothing was added.", True),
+        BranchDefinition(PROVIDER_REJECTED, "ClickUp conclusively rejected the comment, such as missing permission; nothing was added.", True),
+        BranchDefinition(UNCERTAIN, "An earlier attempt sent the comment but its outcome cannot be confirmed and the task shows no matching comment, so the comment may exist; the connector never sends it again.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        1,
+        execute_retry=RetryPolicy(timedelta(seconds=1), 2, timedelta(seconds=60), 5, timedelta(seconds=300)),
+    ),
+)
+
+FIND_MEMBER_BY_EMAIL_DEFINITION = QueryDefinition(
+    OperationRef(CONNECTOR_ID, FIND_MEMBER_BY_EMAIL_OPERATION_ID),
+    (
+        BranchDefinition(FOUND, "A member of the Workspace has the email address.", False),
+        BranchDefinition(NOT_FOUND, "No member of the Workspace has the email address, or the token's user is not a member of the Workspace.", True),
+        BranchDefinition(PROVIDER_REJECTED, "ClickUp conclusively rejected the Workspace read.", True),
+        BranchDefinition(INVALID_RESPONSE, "ClickUp returned an invalid or oversized list of Workspaces.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=default_connector_step_execute_retry_policy(),
+    ),
+)