confamnode 0.2.2__tar.gz → 0.2.3__tar.gz

{confamnode-0.2.2 → confamnode-0.2.3}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: confamnode
-Version: 0.2.2
+Version: 0.2.3
 Summary: The Nigerian AI inference gateway
 Project-URL: Repository, https://github.com/confamnodeai/confamnode
 Project-URL: Bug Tracker, https://github.com/confamnodeai/confamnode/issues
 Author-email: JoTeq the First <hello@confamnode.com>
 License: Apache-2.0
-License-File: LICENSE
 Keywords: ai,confamnode,inference,joteq,llm,nigeria
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -174,25 +173,25 @@ ansa.raw["usage"]            # prompt and completion token counts
 
 ### Free Tier
 
-| Model | Description | Price |
-|---|---|---|
-| `confam-lite` | Light text and general chat | Free |
-| `confam-speed` | Fast, high quality responses | Free |
-| `confam-reasoning` | Standard reasoning and analysis | Free |
+| Model | Description | Modality | Price |
+|---|---|---|---|
+| `confam-lite` | Light text and general chat | Text-to-Text | Free |
+| `confam-speed` | Fast, high quality responses | Image-Text-to-Text | Free |
+| `confam-reasoning` | Standard reasoning and analysis | Text-to-Text | Free |
 
 ### Paid Tier
 
-| Model | Description | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
-|---|---|---|---|---|---|
-| `confam-intelligence` | General smart tasks, 1M context | ₦596 | ₦3,571 | ₦0.596 | ₦3.571 |
-| `confam-deep-reasoning` | Complex thinking, multi-step analysis | ₦234 | ₦468 | ₦0.234 | ₦0.468 |
-| `confam-code` | Coding assistance, 1M context | ₦234 | ₦468 | ₦0.234 | ₦0.468 |
+| Model | Description | Modality | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
+|---|---|---|---|---|---|---|
+| `confam-intelligence` | General smart tasks, 1M context | Image-Text-to-Text | ₦596 | ₦3,571 | ₦0.596 | ₦3.571 |
+| `confam-deep-reasoning` | Complex thinking, multi-step analysis | Image-Text-to-Text | ₦234 | ₦468 | ₦0.234 | ₦0.468 |
+| `confam-code` | Coding assistance, 1M context | Image-Text-to-Text | ₦234 | ₦468 | ₦0.234 | ₦0.468 |
 
 ### Local Models — Nigerian Data Residency
 
-| Model | Description | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
-|---|---|---|---|---|---|
-| `confam-nano` | Local model — data stays in Nigeria | ₦500 | ₦1,500 | ₦0.500 | ₦1.500 |
+| Model | Description | Modality | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
+|---|---|---|---|---|---|---|
+| `confam-nano` | Local model — data stays in Nigeria | Image-Text-to-Text | ₦500 | ₦1,500 | ₦0.500 | ₦1.500 |
 
 Runs entirely on Nigerian hardware. Data never transmitted abroad.
 Ideal for banks, fintechs, hospitals, law firms, and government agencies.
@@ -341,7 +340,7 @@ For enterprise clients running ConfamNode on private infrastructure:
 ```python
 client = ConfamNode(
     api_key="confam-xxx",
-    base_url="http://your-private-server:4000/v1"
+    base_url="http://your-private-server:8000/v1"
 )
 ```
 
@@ -404,4 +403,4 @@ Contact: [hello@confamnode.com](mailto:hello@confamnode.com)
 
 Apache 2.0
 
----
+---

{confamnode-0.2.2 → confamnode-0.2.3}/README.md

@@ -150,25 +150,25 @@ ansa.raw["usage"]            # prompt and completion token counts
 
 ### Free Tier
 
-| Model | Description | Price |
-|---|---|---|
-| `confam-lite` | Light text and general chat | Free |
-| `confam-speed` | Fast, high quality responses | Free |
-| `confam-reasoning` | Standard reasoning and analysis | Free |
+| Model | Description | Modality | Price |
+|---|---|---|---|
+| `confam-lite` | Light text and general chat | Text-to-Text | Free |
+| `confam-speed` | Fast, high quality responses | Image-Text-to-Text | Free |
+| `confam-reasoning` | Standard reasoning and analysis | Text-to-Text | Free |
 
 ### Paid Tier
 
-| Model | Description | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
-|---|---|---|---|---|---|
-| `confam-intelligence` | General smart tasks, 1M context | ₦596 | ₦3,571 | ₦0.596 | ₦3.571 |
-| `confam-deep-reasoning` | Complex thinking, multi-step analysis | ₦234 | ₦468 | ₦0.234 | ₦0.468 |
-| `confam-code` | Coding assistance, 1M context | ₦234 | ₦468 | ₦0.234 | ₦0.468 |
+| Model | Description | Modality | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
+|---|---|---|---|---|---|---|
+| `confam-intelligence` | General smart tasks, 1M context | Image-Text-to-Text | ₦596 | ₦3,571 | ₦0.596 | ₦3.571 |
+| `confam-deep-reasoning` | Complex thinking, multi-step analysis | Image-Text-to-Text | ₦234 | ₦468 | ₦0.234 | ₦0.468 |
+| `confam-code` | Coding assistance, 1M context | Image-Text-to-Text | ₦234 | ₦468 | ₦0.234 | ₦0.468 |
 
 ### Local Models — Nigerian Data Residency
 
-| Model | Description | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
-|---|---|---|---|---|---|
-| `confam-nano` | Local model — data stays in Nigeria | ₦500 | ₦1,500 | ₦0.500 | ₦1.500 |
+| Model | Description | Modality | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
+|---|---|---|---|---|---|---|
+| `confam-nano` | Local model — data stays in Nigeria | Image-Text-to-Text | ₦500 | ₦1,500 | ₦0.500 | ₦1.500 |
 
 Runs entirely on Nigerian hardware. Data never transmitted abroad.
 Ideal for banks, fintechs, hospitals, law firms, and government agencies.
@@ -317,7 +317,7 @@ For enterprise clients running ConfamNode on private infrastructure:
 ```python
 client = ConfamNode(
     api_key="confam-xxx",
-    base_url="http://your-private-server:4000/v1"
+    base_url="http://your-private-server:8000/v1"
 )
 ```
 
@@ -380,4 +380,4 @@ Contact: [hello@confamnode.com](mailto:hello@confamnode.com)
 
 Apache 2.0
 
----
+---

{confamnode-0.2.2 → confamnode-0.2.3}/confamnode/__init__.py

@@ -8,7 +8,7 @@ from confamnode.exceptions import (
 from confamnode.ansa import Ansa, Usage, Cost
 from confamnode import models
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"
 
 __all__ = [
     "ConfamNode",

{confamnode-0.2.2 → confamnode-0.2.3}/confamnode/client.py

@@ -4,6 +4,7 @@ import httpx
 
 from typing import Union, List, Dict
 
+from confamnode.utils import extract_error
 from confamnode.builders import parse_chunk
 from confamnode.ansa import Ansa, Usage, Cost
 from confamnode.registry import VALID_MODELS
@@ -76,10 +77,11 @@ class ConfamNode:
 
             if stream_response.status_code >= 400:
                 stream_response.read()
+                status = stream_response.status_code
+                error = extract_error(stream_response)
                 stream_response.close()
                 http_client.close()
-                error = stream_response.json().get("detail", "Requeest failed")
-                raise Exception(f"ConfamNode error {stream_response.status_code}: {error}")
+                raise Exception(f"ConfamNode error {status}: {error}")
             
             return ConfamStream(stream_response, http_client, model)
         
@@ -94,7 +96,7 @@ class ConfamNode:
         )
 
         if response.status_code >= 400:
-            error = response.json().get("detail", "Request failed")
+            error = extract_error(response)
             raise Exception(f"ConfamNode error {response.status_code}: {error}")
 
         data = response.json()

confamnode-0.2.3/confamnode/utils.py

@@ -0,0 +1,26 @@
+"""
+Small internal helpers shared across the confamnode client.
+"""
+
+
+def extract_error(response) -> str:
+    """
+    Best-effort error detail from a non-2xx response, WITHOUT raising.
+ 
+    The server's normal error shape is {"detail": "..."}, but gateway-level
+    errors (e.g. a 429 throttle, a 502/504 from a proxy) often return an
+    empty or non-JSON body. Calling response.json() directly on those bodies
+    raises JSONDecodeError and swallows the status code -- the one thing the
+    caller actually needs. So we parse defensively and always fall back to
+    the raw text, then to a status-only message.
+    """
+    try:
+        payload = response.json()
+        if isinstance(payload, dict):
+            detail = payload.get("detail") or payload.get("error") or payload.get("message")
+            if detail:
+                return str(detail)
+    except Exception:
+        pass
+    text = (getattr(response, "text", "") or "").strip()
+    return text or "no response body"

{confamnode-0.2.2 → confamnode-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "confamnode"
-version = "0.2.2"
+version = "0.2.3"
 description = "The Nigerian AI inference gateway"
 readme = "README.md"
 requires-python = ">=3.10"

confamnode-0.2.3/tests/test_client_errors.py

@@ -0,0 +1,82 @@
+"""
+Tests for ConfamNode.gist() error handling.
+
+The original bug: a non-2xx response with an empty / non-JSON body made the
+SDK call response.json() in its error branch, which raised JSONDecodeError
+and hid the HTTP status. These tests pin down that:
+  - an empty error body raises a clean "ConfamNode error <status>: ..." with
+    the status code intact (NOT a JSONDecodeError), and
+  - the normal success path still works after the refactor.
+
+No network: httpx.post is monkeypatched to return a fake response.
+"""
+import httpx
+import pytest
+
+from confamnode.client import ConfamNode
+from confamnode.registry import VALID_MODELS
+
+API_KEY = "confam-test"
+MODEL = next(iter(VALID_MODELS))   # any valid model; we never really call out
+
+
+class FakeResponse:
+    def __init__(self, status_code, payload=None, *, json_raises=False, text=""):
+        self.status_code = status_code
+        self._payload = payload
+        self._json_raises = json_raises
+        self.text = text
+
+    def json(self):
+        if self._json_raises:
+            raise ValueError("Expecting value: line 1 column 1 (char 0)")
+        return self._payload
+
+
+def _patch_post(monkeypatch, response):
+    monkeypatch.setattr(httpx, "post", lambda *a, **k: response)
+
+
+def test_empty_error_body_raises_with_status_not_jsondecodeerror(monkeypatch):
+    # The reproduction of the reported crash: 429, empty body.
+    _patch_post(monkeypatch, FakeResponse(429, json_raises=True, text=""))
+    client = ConfamNode(api_key=API_KEY)
+    with pytest.raises(Exception) as exc:
+        client.gist(model=MODEL, messages="hi")
+    msg = str(exc.value)
+    assert "429" in msg
+    assert "no response body" in msg
+    assert "JSONDecode" not in type(exc.value).__name__
+
+
+def test_json_detail_error_surfaces_detail(monkeypatch):
+    _patch_post(monkeypatch, FakeResponse(400, payload={"detail": "invalid model"}))
+    client = ConfamNode(api_key=API_KEY)
+    with pytest.raises(Exception) as exc:
+        client.gist(model=MODEL, messages="hi")
+    assert "400" in str(exc.value)
+    assert "invalid model" in str(exc.value)
+
+
+def test_html_gateway_error_surfaces_text(monkeypatch):
+    _patch_post(monkeypatch, FakeResponse(502, json_raises=True,
+                                          text="<html>502 Bad Gateway</html>"))
+    client = ConfamNode(api_key=API_KEY)
+    with pytest.raises(Exception) as exc:
+        client.gist(model=MODEL, messages="hi")
+    assert "502" in str(exc.value)
+    assert "Bad Gateway" in str(exc.value)
+
+
+def test_success_path_still_returns_ansa(monkeypatch):
+    payload = {
+        "id": "abc",
+        "choices": [{"message": {"content": "hello"}, "finish_reason": "stop"}],
+        "usage": {"prompt_tokens": 1, "completion_tokens": 2, "total_tokens": 3},
+        "confam": {"request_id": "r1", "cost": {"naira": 0.0}},
+    }
+    _patch_post(monkeypatch, FakeResponse(200, payload=payload))
+    client = ConfamNode(api_key=API_KEY)
+    ansa = client.gist(model=MODEL, messages="hi")
+    assert ansa.text == "hello"
+    assert ansa.cost.naira == 0.0

confamnode-0.2.3/tests/test_utils.py

@@ -0,0 +1,46 @@
+"""
+Unit tests for confamnode.utils.extract_error.
+
+Pure function, no network: just feed it fake responses and assert it never
+raises and always produces a usable message.
+"""
+from confamnode.utils import extract_error
+
+
+class _Resp:
+    """Minimal stand-in for an httpx.Response."""
+    def __init__(self, payload=None, *, json_raises=False, text=""):
+        self._payload = payload
+        self._json_raises = json_raises
+        self.text = text
+
+    def json(self):
+        if self._json_raises:
+            raise ValueError("Expecting value: line 1 column 1 (char 0)")
+        return self._payload
+
+
+def test_empty_body_returns_placeholder():
+    # The exact case that crashed the SDK: empty 429 body.
+    assert extract_error(_Resp(json_raises=True, text="")) == "no response body"
+
+
+def test_non_json_text_body_is_returned_stripped():
+    assert extract_error(_Resp(json_raises=True, text="  upstream timeout  ")) == "upstream timeout"
+
+
+def test_detail_key_is_preferred():
+    assert extract_error(_Resp(payload={"detail": "invalid model"})) == "invalid model"
+
+
+def test_error_key_fallback():
+    assert extract_error(_Resp(payload={"error": "nope"})) == "nope"
+
+
+def test_message_key_fallback():
+    assert extract_error(_Resp(payload={"message": "hmm"})) == "hmm"
+
+
+def test_non_dict_json_falls_back_to_text():
+    # A JSON array (not a dict) shouldn't blow up; fall back to text.
+    assert extract_error(_Resp(payload=["a", "b"], text="listy")) == "listy"

{confamnode-0.2.2 → confamnode-0.2.3}/uv.lock

@@ -40,7 +40,7 @@ wheels = [
 
 [[package]]
 name = "confamnode"
-version = "0.2.1"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

confamnode-0.2.2/LICENSE

@@ -1,201 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.