feat!: flip PlatformSettings.agenthub_config default to None

Author: radu-mocanu

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to `uipath_llm_client` (core package) will be documented in this file.
 
+## [1.11.0] - 2026-05-08
+
+### Changed
+- **Behavior change**: `PlatformSettings.agenthub_config` field default flipped from `"agentsruntime"` to `None`. Callers (low-code agent runtimes, eval frameworks, etc.) are now responsible for supplying the correct value per execution mode (`agentsruntime`, `agentsplayground`, `agentsevals`, …). When unset, the `X-UiPath-AgentHub-Config` header is omitted from outgoing requests rather than implicitly billed against the runtime quota. The `UIPATH_AGENTHUB_CONFIG` environment variable still wins when set. Pair with `uipath-langchain-client>=1.10.1` and pass `agenthub_config=` to `get_chat_model` / `get_embedding_model`.
+
 ## [1.10.0] - 2026-04-23
 
 ### Added

README.md

@@ -155,7 +155,8 @@ export UIPATH_ORGANIZATION_ID="your-org-id"
 export UIPATH_TENANT_ID="your-tenant-id"
 export UIPATH_ACCESS_TOKEN="your-access-token"
 
-# Optional: AgentHub configuration for discovery (default: "agentsruntime")
+# Optional: AgentHub configuration for discovery (default: None — header is omitted
+# unless set; pass per-call via the factory ``agenthub_config`` kwarg or this env var)
 export UIPATH_AGENTHUB_CONFIG="agentsruntime"
 
 # Optional: tracing
@@ -190,7 +191,7 @@ export UIPATH_JOB_KEY="your-job-key"
 | `base_url` | `UIPATH_URL` | `str \| None` | `None` | Base URL of the UiPath Platform API |
 | `tenant_id` | `UIPATH_TENANT_ID` | `str \| None` | `None` | Tenant ID for request routing |
 | `organization_id` | `UIPATH_ORGANIZATION_ID` | `str \| None` | `None` | Organization ID for request routing |
-| `agenthub_config` | `UIPATH_AGENTHUB_CONFIG` | `str \| None` | `"agentsruntime"` | AgentHub configuration for discovery |
+| `agenthub_config` | `UIPATH_AGENTHUB_CONFIG` | `str \| None` | `None` | AgentHub configuration for discovery (header omitted when unset) |
 | `process_key` | `UIPATH_PROCESS_KEY` | `str \| None` | `None` | Process key for tracing |
 | `job_key` | `UIPATH_JOB_KEY` | `str \| None` | `None` | Job key for tracing |
 

packages/uipath_langchain_client/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to `uipath_langchain_client` will be documented in this file.
 
+## [1.11.0] - 2026-05-08
+
+### Changed
+- Bumped `uipath-llm-client` floor to `>=1.11.0` to match the core release that flips `PlatformSettings.agenthub_config` default from `"agentsruntime"` to `None`. Callers should now pass `agenthub_config=` to `get_chat_model` / `get_embedding_model` (added in 1.10.1) per execution mode instead of relying on the implicit default.
+
 ## [1.10.1] - 2026-05-08
 
 ### Added

packages/uipath_langchain_client/pyproject.toml

@@ -6,7 +6,7 @@ readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
     "langchain>=1.2.15,<2.0.0",
-    "uipath-llm-client>=1.10.0,<2.0.0",
+    "uipath-llm-client>=1.11.0,<2.0.0",
 ]
 
 [project.optional-dependencies]

packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py

@@ -1,3 +1,3 @@
 __title__ = "UiPath LangChain Client"
 __description__ = "A Python client for interacting with UiPath's LLM services via LangChain."
-__version__ = "1.10.1"
+__version__ = "1.11.0"

src/uipath/llm_client/__version__.py

@@ -1,3 +1,3 @@
 __title__ = "UiPath LLM Client"
 __description__ = "A Python client for interacting with UiPath's LLM services."
-__version__ = "1.10.0"
+__version__ = "1.11.0"

src/uipath/llm_client/settings/platform/settings.py

@@ -64,9 +64,11 @@ class PlatformBaseSettings(UiPathBaseSettings):
     refresh_token: SecretStr | None = Field(default=None, validation_alias="UIPATH_REFRESH_TOKEN")
 
     # AgentHub configuration (used for discovery)
-    agenthub_config: str | None = Field(
-        default="agentsruntime", validation_alias="UIPATH_AGENTHUB_CONFIG"
-    )
+    # Default is None: callers (low-code agent runtimes, eval frameworks, etc.) are
+    # responsible for supplying the correct value per execution mode (e.g.
+    # ``agentsruntime``, ``agentsplayground``, ``agentsevals``). When unset, the
+    # ``X-UiPath-AgentHub-Config`` header is omitted from outgoing requests.
+    agenthub_config: str | None = Field(default=None, validation_alias="UIPATH_AGENTHUB_CONFIG")
 
     # Tracing configuration
     process_key: str | None = Field(default=None, validation_alias=ENV_PROCESS_KEY)

tests/core/features/settings/test_platform.py

@@ -57,15 +57,17 @@ def test_build_base_url_normalized(
             )
             assert "agenthub_/llm/api/chat/completions" in url
 
-    def test_build_auth_headers_has_default_config(self, platform_env_vars, mock_platform_auth):
-        """Test build_auth_headers includes default agenthub_config."""
+    def test_build_auth_headers_omits_agenthub_config_by_default(
+        self, platform_env_vars, mock_platform_auth
+    ):
+        """``agenthub_config`` defaults to None and the header is omitted unless
+        the caller (or ``UIPATH_AGENTHUB_CONFIG``) sets it explicitly."""
         with patch.dict(os.environ, platform_env_vars, clear=True):
             settings = PlatformSettings()
             headers = settings.build_auth_headers()
             assert headers == {
                 "x-uipath-internal-accountid": "test-org-id",
                 "x-uipath-internal-tenantid": "test-tenant-id",
-                "x-uipath-agenthub-config": "agentsruntime",
             }
 
     def test_build_auth_headers_with_tracing(self, platform_env_vars, mock_platform_auth):