cmpnd 0.49.0__tar.gz → 0.50.0__tar.gz

{cmpnd-0.49.0 → cmpnd-0.50.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cmpnd
-Version: 0.49.0
+Version: 0.50.0
 Summary: DSPy observability and deployment SDK for cmpnd
 Project-URL: Homepage, https://cmpnd.ai
 Author-email: cmpnd <hello@cmpnd.ai>

{cmpnd-0.49.0 → cmpnd-0.50.0}/cmpnd/_http.py

@@ -234,23 +234,25 @@ class ApiClient:
             # which is the difference a user needs most and had the least of.
             raise error(server_detail(response) or "Resource not found.")
         if response.status_code >= 500:
-            # 5xx usually means the server is up but blew up handling the
-            # request — a database hiccup, an unhandled exception, etc.
-            # Include the response body excerpt so the user has something
-            # to act on. The actual exception lives in the operator's
-            # server logs, which we can't reach from here.
+            # 5xx means the cmpnd platform failed to handle the request — a
+            # database hiccup, an unhandled exception, a hop between its own
+            # services. A failure at something the user runs (their tool
+            # server, their provider) answers 4xx with a sentence naming it,
+            # so this hint names the platform and nothing of theirs. The cause
+            # lives in the platform's logs, which we can't reach from here.
             body_excerpt = (response.text or "").strip()[:200]
             msg = f"Server error ({response.status_code}) for {method} {path}"
             if body_excerpt:
                 msg += f": {body_excerpt}"
-            msg += "\n  If you operate this server, check its logs for the underlying exception."
+            msg += (
+                "\n  The cmpnd platform failed to handle this request. If you run this cmpnd "
+                "instance yourself, its logs hold the cause."
+            )
             raise error(msg, exit_code=2)
         if response.status_code >= 400:
-            try:
-                detail = response.json()
-            except Exception:
-                detail = response.text
-            raise error(f"Request failed ({response.status_code}): {detail}")
+            # The server's own sentence: a 4xx says what to change, and the
+            # JSON envelope around it is noise.
+            raise error(f"Request failed ({response.status_code}): {server_detail(response)}")
 
         if return_response:
             return response

{cmpnd-0.49.0 → cmpnd-0.50.0}/cmpnd/deployment.py

@@ -92,8 +92,8 @@ def _raise_http_error(response: httpx.Response, action: str) -> None:
     """Convert an HTTP error response into an actionable RuntimeError.
 
     Replaces ``response.raise_for_status()`` so callers see a useful
-    message instead of a raw httpx traceback. 5xx points the user at
-    server logs and the local-dev preflight; 4xx surfaces the response
+    message instead of a raw httpx traceback. 5xx says the platform
+    failed and points a self-hosting operator at its logs; 4xx surfaces the response
     body so e.g. ``{"error": "Invalid 'since' timestamp"}`` round-trips
     to the terminal.
     """
@@ -105,8 +105,8 @@ def _raise_http_error(response: httpx.Response, action: str) -> None:
         if body:
             msg += f"\n  Body: {body}"
         msg += (
-            "\n  The server reached, but errored handling the request. "
-            "If you operate it, check its logs for the underlying exception."
+            "\n  The cmpnd platform failed to handle this request. "
+            "If you run this cmpnd instance yourself, its logs hold the cause."
         )
     else:
         msg = f"Failed to {action}: HTTP {response.status_code}"

{cmpnd-0.49.0 → cmpnd-0.50.0}/docs/cli.md

@@ -437,6 +437,15 @@ allow-list state and a one-line description. `--schemas` adds the reduced
 argument schema the platform enforces. Every command takes `--json` for the
 raw payload.
 
+When the platform cannot list a server's tools because of the server itself,
+`create` and `refresh` fail with a `424` that names the URL, the credential and
+the cause. Examples are a name that does not resolve, a refused connection, or
+a `401` from the server. The server stays registered, so run `cmpnd
+tool-servers refresh <server_id>` once the cause is fixed. When you re-register
+a server with a different `--credential` and the listing fails, the server keeps
+its old credential, so repeat the `create` command instead. The `424` names the
+command to run. A `5xx` means the platform itself failed.
+
 Deleting a server refuses new dispatches that name its tools and makes calls
 from runs in flight fail at once, because the credential goes with it. The
 confirmation prompt says so.

{cmpnd-0.49.0 → cmpnd-0.50.0}/pyproject.toml

@@ -5,7 +5,7 @@ name = "cmpnd"
 # it's new) — no git tags. Bump with `uv version --bump {minor,patch}` or by
 # hand. Runtime `cmpnd.__version__` reads installed metadata, so it tracks
 # this automatically. See docs/plans/2026-07-02-sdk-pypi-tag-free-publish.md.
-version = "0.49.0"
+version = "0.50.0"
 description = "DSPy observability and deployment SDK for cmpnd"
 readme = "README.md"
 requires-python = ">=3.11"

{cmpnd-0.49.0 → cmpnd-0.50.0}/tests/test_cli/test_api_client.py

@@ -255,3 +255,18 @@ class TestApiClient:
     def test_404_with_no_body_still_says_something(self):
         err = self._answering(httpx.Response(404, text="", request=httpx.Request("GET", "http://x")))
         assert "not found" in str(err).lower()
+
+    def test_a_4xx_carries_the_servers_sentence_not_its_json(self):
+        # A 424 means the user's own dependency failed, and serve's sentence says
+        # which and what to run next; a dict repr around it buries that.
+        sentence = "Listing the tools at https://mcp.example.test/mcp failed: the name does not resolve."
+        err = self._answering(httpx.Response(424, json={"error": sentence}, request=httpx.Request("GET", "http://x")))
+        assert f"Request failed (424): {sentence}" in str(err)
+        assert "{'error'" not in str(err)
+
+    def test_a_5xx_hint_names_the_platform_not_the_users_server(self):
+        # A 5xx is the platform's own failure. The hint must not read as the
+        # user's tool server or model provider, which a 424 covers instead.
+        err = self._answering(httpx.Response(502, text="bad gateway", request=httpx.Request("GET", "http://x")))
+        assert "If you operate this server" not in str(err)
+        assert "cmpnd" in str(err).split("\n", 1)[1]

{cmpnd-0.49.0 → cmpnd-0.50.0}/uv.lock

@@ -496,7 +496,7 @@ wheels = [
 
 [[package]]
 name = "cmpnd"
-version = "0.49.0"
+version = "0.50.0"
 source = { editable = "." }
 dependencies = [
     { name = "dspy" },