UiPath LLM Client [v1.16.2]

[1.16.2] - 2026-07-06

Added

• UiPathLLMErrorCode — a public string enum of stable semantic error codes independent of provider exception types or provider-specific message text. It currently includes UNSUPPORTED_MIME_TYPE.
• UiPathError now carries optional semantic context: error_code (a stable machine-readable identifier, preferably from UiPathLLMErrorCode) and detail (best-effort diagnostic detail from the mapped lower-level error).

Changed

• as_uipath_error now resolves errors with HTTP status as authoritative: the cause chain is scanned for an httpx.Response first, so a real status always outranks a client-side classifier match elsewhere in the chain (which may be incidental __context__ rather than the failure). Only when no response exists anywhere is the error offered to the _CLIENT_SIDE_CLASSIFIERS registry (extension point for future non-HTTP semantic codes, e.g. the unsupported-MIME case). Previously client-side classifiers ran first and could mask an authenticated/rate-limited/server error carrying an unrelated marker.

UiPath LLM Client [v1.16.0]

[1.16.0] - 2026-07-03

Added

• Per-service URL overrides for local development. build_base_url now consults resolve_service_url(endpoint_path) (from uipath.platform.common) before constructing the final URL. When a UIPATH_SERVICE_URL_<SERVICE> env var is set (e.g. UIPATH_SERVICE_URL_AGENTHUB=http://localhost:8080), requests are redirected to that local server with the org/tenant and service prefix stripped. Without an override, behaviour is unchanged — the URL is still {base_url}/{endpoint_path}.

UiPath LLM Client [v1.15.1]

[1.15.1] - 2026-07-03

Changed

• Bumped uipath-platform to >=0.1.91 — 0.1.89/0.1.90 crashed with a circular-import ImportError when importing IdentityService (fixed upstream in UiPath/uipath-python#1787).

UiPath LangChain Client [langchain-v1.16.1]

[1.16.1] - 2026-07-03

Fixed

• import uipath_langchain_client no longer requires the bedrock extra (regression in 1.15.1).

UiPath LangChain Client [langchain-v1.16.0]

[1.16.0] - 2026-07-03

Changed

• Picks up core uipath-llm-client 1.16.0, which adds per-service URL overrides for local development (UIPATH_SERVICE_URL_<SERVICE> env vars). Bumped the uipath-llm-client floor to >=1.16.0.

UiPath LangChain Client [langchain-v1.15.2]

[1.15.2] - 2026-07-03

Changed

• Bumped uipath-llm-client to >=1.15.1, which requires uipath-platform>=0.1.91 (fixes a circular-import crash in 0.1.89/0.1.90).

UiPath LLM Client [v1.15.0]

[1.15.0] - 2026-06-25

Added

• UiPathError — a common root exception for everything the client can raise, re-exported from uipath.llm_client. UiPathAPIError (and therefore every status-specific subclass) now inherits from it, so except UiPathError is a single catch-all across all backends and providers. Fully backward compatible: UiPathAPIError still inherits httpx.HTTPStatusError and all existing handlers keep working.
• as_uipath_error(exc) and the wrap_provider_errors() context manager (in uipath.llm_client.utils.exceptions). They convert a provider/SDK exception into the matching UiPath exception so callers handle one taxonomy regardless of which provider produced the error. The cause chain (__cause__/__context__) is walked for an httpx.Response; when found, its status code is mapped onto the corresponding UiPathAPIError subclass (a 429 → UiPathRateLimitError, a 400 → UiPathBadRequestError, …) so semantic handling is identical across providers — including providers (e.g. Google) that wrap the response-bearing error one level down. When no response is available anywhere in the chain (client-side validation errors, connection failures) the UiPathError root is returned. The original provider exception is preserved as __cause__.

Changed

• UiPathRateLimitError.retry_after is now parsed lazily from self.response (via a property) instead of being cached in __init__. _parse_retry_after and the parsing behaviour are unchanged.
• patch_raise_for_status now routes the httpx HTTPStatusError through wrap_provider_errors, so direct raise_for_status() callers and provider SDK exceptions share a single conversion path. The raised UiPathAPIError now carries the original HTTPStatusError as __cause__ (previously None); status mapping is unchanged.

Note

• Provider errors are surfaced as pure UiPath types: an openai.RateLimitError raised through a passthrough chat model becomes a UiPathRateLimitError and is not catchable as openai.RateLimitError (the vendor exception is kept as __cause__). Standardise handlers on UiPathError and its subclasses.

UiPath LangChain Client [langchain-v1.15.0]

[1.15.0] - 2026-06-25

Added

• UiPathBaseChatModel now converts provider SDK exceptions into UiPathError. When any chat client (UiPathChatOpenAI, UiPathChatAnthropic, UiPathChat, Bedrock/Vertex/Google/LiteLLM/Fireworks, …) raises during _generate/_agenerate/_stream/_astream, the error is converted into the matching UiPath semantic subclass (a 429 → UiPathRateLimitError, a 400 → UiPathBadRequestError, …) — including providers like Google that wrap the response-bearing error one level down — giving provider-agnostic error handling across every client. Errors without an HTTP response (e.g. client-side validation) become the UiPathError root. UiPathError is re-exported from uipath_langchain_client.

Changed

• Bumped uipath-llm-client floor to >=1.15.0 to pick up UiPathError and the wrap_provider_errors / as_uipath_error helpers.

Note

• Provider errors are now surfaced as pure UiPath types and are not catchable as their original vendor type (e.g. openai.BadRequestError); the vendor exception is preserved as __cause__. Standardise handlers on UiPathError and its subclasses.

UiPath LangChain Client [langchain-v1.14.1]

[1.14.1] - 2026-06-23

Fixed

• WrappedBotoClient (the httpx-backed Bedrock shim) now calls raise_for_status() in converse, invoke_model, and the streaming generator before reading the response. Previously a non-2xx gateway response (e.g. 403 License-not-available) was parsed as a normal result and handed to langchain_aws, which raised a misleading ValueError("No 'output' key found in the response from the Bedrock Converse API ... misconfiguration of endpoint or region") — the real status code and detail were lost. Gateway HTTP errors now surface as the patched UiPathAPIError subclass (e.g. UiPathPermissionDeniedError), matching the OpenAI and Vertex paths. For streaming responses the error body is read first so the typed exception retains its detail.

UiPath LLM Client [v1.14.0]

[1.14.0] - 2026-06-15

Added

• ApiFlavor.ANTHROPIC_MESSAGES ("AnthropicMessages") for Bedrock-hosted Claude models that the discovery endpoint exposes with the native Anthropic Messages wire format. The value is the discovery string verbatim because it is forwarded as the X-UiPath-LlmGateway-ApiFlavor header. Also mapped in API_FLAVOR_TO_VENDOR_TYPE to VendorType.AWSBEDROCK so it resolves to the Bedrock passthrough route when discovery omits the vendor field.