feat(core): add shared uipath metadata key (#1773)

Author: radu-mocanu

packages/uipath-core/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath-core"
-version = "0.5.26"
+version = "0.5.27"
 description = "UiPath Core abstractions"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

packages/uipath-core/src/uipath/core/triggers/__init__.py

@@ -6,9 +6,11 @@
     "UiPathApiTrigger",
     "UiPathIntegrationTrigger",
     "UiPathResumeTriggerName",
+    "UIPATH_METADATA_KEY",
 ]
 
 from uipath.core.triggers.trigger import (
+    UIPATH_METADATA_KEY,
     UiPathApiTrigger,
     UiPathIntegrationTrigger,
     UiPathResumeTrigger,

packages/uipath-core/src/uipath/core/triggers/trigger.py

@@ -6,6 +6,9 @@
 
 from pydantic import BaseModel, ConfigDict, Field
 
+# Reserved key for UiPath-owned metadata embedded in user-visible payloads.
+UIPATH_METADATA_KEY = "__uipath"
+
 
 class UiPathResumeTriggerType(str, Enum):
     """Constants representing different types of resume job triggers in the system."""