ms-tau-sdk 2.0.9.dev49__tar.gz → 2.0.10.dev50__tar.gz

{ms_tau_sdk-2.0.9.dev49 → ms_tau_sdk-2.0.10.dev50}/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 
-## Unreleased
+## 2.0.10 — 2026-10-09
+
+- **Application access timeouts no longer become `access_unavailable`.** Platform transport
+  timeouts retain their classification and time limit when application access is obtained or
+  renewed. The tool reports `failure: timeout` with `phase: access`; HTTP 408/504 responses
+  also report a timeout with their status, without claiming the tool's configured limit elapsed.
+  Other access failures retain their classification. Tool calls are never replayed after failure.
+
+## 2.0.9 — 2026-10-09
 
 - **Turn logs name the session's Agent
   ([#85](https://github.com/mainsequence-sdk/ms-tau-sdk/issues/85)).** Every log line of a turn

{ms_tau_sdk-2.0.9.dev49 → ms_tau_sdk-2.0.10.dev50}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ms-tau-sdk
-Version: 2.0.9.dev49
+Version: 2.0.10.dev50
 Summary: Workspace-bound Tau application primitives for Main Sequence projects
 Project-URL: Changelog, https://github.com/mainsequence-sdk/ms-tau-sdk/blob/development/CHANGELOG.md
 Project-URL: Documentation, https://github.com/mainsequence-sdk/ms-tau-sdk/tree/development/docs

{ms_tau_sdk-2.0.9.dev49 → ms_tau_sdk-2.0.10.dev50}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ms-tau-sdk"
-version = "2.0.9.dev49"
+version = "2.0.10.dev50"
 description = "Workspace-bound Tau application primitives for Main Sequence projects"
 readme = "README.md"
 requires-python = ">=3.13"

{ms_tau_sdk-2.0.9.dev49 → ms_tau_sdk-2.0.10.dev50}/src/ms_tau_sdk/backend/client.py

@@ -19,6 +19,7 @@ from tau_coding.oauth import account_id_from_access_token
 from ms_tau_sdk.errors import (
     BackendConflictError,
     BackendError,
+    BackendTimeoutError,
     LocalModeUnsupportedError,
     SessionNotFoundError,
 )
@@ -372,6 +373,20 @@ class MainSequenceClient:
                 if transport_attempt >= attempts:
                     break
                 await asyncio.sleep(0.25 * (2 ** (transport_attempt - 1)))
+        if isinstance(last_error, httpx.TimeoutException):
+            timeout_phase = (
+                "connect"
+                if isinstance(last_error, httpx.ConnectTimeout)
+                else "write"
+                if isinstance(last_error, httpx.WriteTimeout)
+                else "pool"
+                if isinstance(last_error, httpx.PoolTimeout)
+                else "read"
+            )
+            raise BackendTimeoutError(
+                "Backend request timed out",
+                timeout_seconds=getattr(self._client.timeout, timeout_phase),
+            ) from last_error
         raise BackendError(f"Backend transport failed: {last_error}") from last_error
 
     @staticmethod

{ms_tau_sdk-2.0.9.dev49 → ms_tau_sdk-2.0.10.dev50}/src/ms_tau_sdk/errors.py

@@ -37,6 +37,14 @@ class BackendConflictError(BackendError):
     status_code = 409
 
 
+class BackendTimeoutError(BackendError):
+    """A platform request timed out; keep its limit without retaining the request."""
+
+    def __init__(self, message: str, *, timeout_seconds: float | None = None) -> None:
+        super().__init__(message)
+        self.timeout_seconds = timeout_seconds
+
+
 class LeaseLostError(TauSDKError):
     code = "runtime_lease_lost"
     status_code = 409

{ms_tau_sdk-2.0.9.dev49 → ms_tau_sdk-2.0.10.dev50}/src/ms_tau_sdk/runtime/requester.py

@@ -30,7 +30,7 @@ import structlog
 from ms_tau_sdk.backend.auth import AccessToken, _jwt_expiry
 from ms_tau_sdk.backend.client import LeaseProof, answer_without_request_credentials
 from ms_tau_sdk.backend.models import ReleaseRuntimeAccess
-from ms_tau_sdk.errors import BackendError, TauSDKError
+from ms_tau_sdk.errors import BackendError, BackendTimeoutError, TauSDKError
 
 logger = structlog.get_logger(__name__)
 
@@ -276,8 +276,12 @@ class TurnRequesterBinding:
                 )
             except BackendError as error:
                 # A transport failure keeps the request, and its credentials, as its cause, so
-                # only the message, status and answer are carried on.
-                failure = BackendError(str(error), status_code=error.backend_status)
+                # only safe metadata is carried on, including a timeout's classification.
+                failure = (
+                    BackendTimeoutError(str(error), timeout_seconds=error.timeout_seconds)
+                    if isinstance(error, BackendTimeoutError)
+                    else BackendError(str(error), status_code=error.backend_status)
+                )
                 failure.detail = error.detail
             if failure is not None:
                 if delegate and failure.backend_status == 403:

{ms_tau_sdk-2.0.9.dev49 → ms_tau_sdk-2.0.10.dev50}/src/ms_tau_sdk/tools/mcp_applications.py

@@ -35,7 +35,7 @@ from tau_agent.types import JSONValue
 
 from ms_tau_sdk.backend.mcp import MCPConnectionClient
 from ms_tau_sdk.backend.models import MCPApplication
-from ms_tau_sdk.errors import BackendError, ConfigurationError
+from ms_tau_sdk.errors import BackendError, BackendTimeoutError, ConfigurationError
 from ms_tau_sdk.runtime.requester import (
     RequesterBindingError,
     _turn_application_access,
@@ -102,7 +102,9 @@ def application_connector(settings: TauSDKSettings) -> ApplicationConnector:
 def _timed_out(error: BaseException) -> bool:
     if isinstance(error, McpError):
         return error.error.code == httpx.codes.REQUEST_TIMEOUT
-    return isinstance(error, httpx.TimeoutException) and not isinstance(error, httpx.ConnectTimeout)
+    return isinstance(error, TimeoutError) or (
+        isinstance(error, httpx.TimeoutException) and not isinstance(error, httpx.ConnectTimeout)
+    )
 
 
 def _failure(
@@ -117,6 +119,16 @@ def _failure(
     if isinstance(error, RequesterBindingError):
         return "Your access for this request ended.", {"failure": "access_ended"}
     if isinstance(error, BackendError):
+        if isinstance(error, BackendTimeoutError) or error.backend_status in {408, 504}:
+            details: dict[str, JSONValue] = {"failure": "timeout", "phase": "access"}
+            if isinstance(error, BackendTimeoutError) and error.timeout_seconds is not None:
+                details["timeout_seconds"] = error.timeout_seconds
+            if error.backend_status is not None:
+                details["status"] = error.backend_status
+            return (
+                f"Main Sequence timed out while providing access to the {name} application.",
+                details,
+            )
         if error.backend_status in {403, 404}:
             return (
                 f"The {name} application is not available for this call.",
@@ -134,6 +146,9 @@ def _failure(
         )
     if isinstance(error, httpx.HTTPStatusError):
         status = error.response.status_code
+        if status in {408, 504}:
+            text = f"The {name} application or its gateway reported a timeout ({status})."
+            return text, {"failure": "timeout", "status": status}
         if status >= 500:
             text = f"The {name} application answered with a server error ({status})."
             return text, {"failure": "server_error", "status": status}
@@ -151,7 +166,7 @@ def _retryable(error: BaseException) -> bool:
     """Whether opening the session failed in a way that a second attempt may not repeat."""
 
     if isinstance(error, httpx.HTTPStatusError):
-        return error.response.status_code >= 500
+        return error.response.status_code == 408 or error.response.status_code >= 500
     return isinstance(error, httpx.TransportError) or _timed_out(error)