confamnode 0.1.2__tar.gz → 0.1.3__tar.gz

{confamnode-0.1.2 → confamnode-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: confamnode
-Version: 0.1.2
+Version: 0.1.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
@@ -85,7 +85,7 @@ pip install confamnode
 ```python
 from confamnode import ConfamNode
 
-client = ConfamNode(api_key="confam-sk-xxx")
+client = ConfamNode(api_key="confam-xxx")
 
 ansa = client.gist(
     model="confam-speed",
@@ -93,9 +93,9 @@ ansa = client.gist(
 )
 
 print(ansa.text)
-print(f"Cost:   ₦{ansa.cost.naira:.6f}")
+print(f"Cost: ₦{ansa.cost.naira:.6f}")
 print(f"Tokens: {ansa.usage.total_tokens}")
-print(f"ID:     {ansa.id}")
+print(f"ID: {ansa.id}")
 ```
 
 ---
@@ -105,7 +105,7 @@ print(f"ID:     {ansa.id}")
 ```python
 from confamnode import ConfamNode
 
-client = ConfamNode(api_key="confam-sk-xxx")
+client = ConfamNode(api_key="confam-xxx")
 
 stream = client.gist(
     model="confam-speed",
@@ -121,9 +121,9 @@ for yarn in stream:
 
 # Get full Ansa after stream completes
 ansa = stream.get_ansa()
-print(f"\nModel:  {ansa.model}")
+print(f"\nModel: {ansa.model}")
 print(f"Tokens: {ansa.usage.total_tokens}")
-print(f"Cost:   ₦{ansa.cost.naira:.6f}")
+print(f"Cost: ₦{ansa.cost.naira:.6f}")
 if ansa.cost.dollars:
     print(f"${ansa.cost.dollars:.8f}")
 print(f"ID: {ansa.id}")
@@ -136,7 +136,7 @@ print(f"ID: {ansa.id}")
 Every `gist()` call returns an `Ansa` object:
 
 ```python
-ansa = client.gist(model="confam-speed", messages="How far?")
+ansa = client.gist(model="confam-speed", messages="How you dey?")
 
 # Response
 ansa.text               # response text
@@ -147,7 +147,7 @@ ansa.citations          # citations (search models only)
 ansa.finish_reason      # why generation stopped
 
 # Usage
-ansa.usage.prompt_tokens      # input tokens used
+ansa.usage.prompt_tokens      # input tokens used (includes system message)
 ansa.usage.completion_tokens  # output tokens used
 ansa.usage.total_tokens       # total tokens used
 
@@ -161,9 +161,16 @@ ansa.cost.dollars       # cost in USD (if available)
 ansa.is_local                # True — runs on Nigerian hardware
 ansa.is_ngn_data_residency   # True — data never leaves Nigeria
 ansa.id                      # unique request ID (confam-xxxx-xxxx)
-ansa.raw                     # original LiteLLM response
+
+# Response metadata
+ansa.raw                     # dict with id, finish_reason, usage
+ansa.raw["id"]               # provider response ID
+ansa.raw["finish_reason"]    # why generation stopped
+ansa.raw["usage"]            # prompt and completion token counts
 ```
 
+> **Note:** `prompt_tokens` includes any system message tokens. This is standard behaviour across all LLM providers (OpenAI, Anthropic, etc.).
+
 ---
 
 ## Models
@@ -184,15 +191,14 @@ ansa.raw                     # original LiteLLM response
 | `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 |
 
-### Local Models — Nigeria Data Residency
+### Local Models — Nigerian Data Residency
 
 | Model | Description | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
 |---|---|---|---|---|---|
-| `confam-nano` | Qwen3.5 4B on Jetson Orin Nano | ₦500 | ₦1,500 | ₦0.500 | ₦1.500 |
+| `confam-nano` | Local model — data stays in Nigeria | ₦500 | ₦1,500 | ₦0.500 | ₦1.500 |
 
 Runs entirely on Nigerian hardware. Data never transmitted abroad.
-
-Data never leaves Nigeria. Ideal for banks, fintechs, hospitals, law firms, and government agencies.
+Ideal for banks, fintechs, hospitals, law firms, and government agencies.
 
 More models coming soon. Contact [hello@confamnode.com](mailto:hello@confamnode.com) for early access.
 
@@ -259,9 +265,10 @@ Enable extended thinking for complex problems:
 ansa = client.gist(
     model="confam-reasoning",
     messages="One trader buy goods for ₦50,000 sell am for ₦75,000. After e pay ₦5,000 for transport and ₦3,000 for market, wetin be the real profit? Show how you calculate am.",
-    # Explicit reasoning control
     allowed_openai_params=["reasoning_effort"],
-    rreasoning_effort={"effort": "low", "summary": "detailed"} # effort can be "low", "mid", "high", or "xhigh". summary can be "detailed", or "concise"
+    reasoning_effort={"effort": "low", "summary": "detailed"}
+    # effort: "low", "medium", "high", or "xhigh"
+    # summary: "detailed" or "concise"
 )
 
 print(ansa.reasoning)   # thinking trace
@@ -274,9 +281,8 @@ Also available on `confam-deep-reasoning` for more complex multi-step problems:
 ansa = client.gist(
     model="confam-deep-reasoning",
     messages="Analyse the financial risk of a Nigerian fintech expanding to Ghana...",
-    # Explicit reasoning control
     allowed_openai_params=["reasoning_effort"],
-    rreasoning_effort={"effort": "low", "summary": "detailed"} # effort can be "low", "mid", "high", or "xhigh". summary can be "detailed", or "concise"
+    reasoning_effort={"effort": "high", "summary": "detailed"}
 )
 
 print(ansa.reasoning)   # full thinking trace
@@ -324,7 +330,7 @@ print(ansa.text)
 ## Environment Variable
 
 ```bash
-export CONFAMNODE_API_KEY="confam-sk-xxx"
+export CONFAMNODE_API_KEY="confam-xxx"
 ```
 
 ```python
@@ -340,7 +346,7 @@ For enterprise clients running ConfamNode on private infrastructure:
 
 ```python
 client = ConfamNode(
-    api_key="confam-sk-xxx",
+    api_key="confam-xxx",
     base_url="http://your-private-server:4000/v1"
 )
 ```
@@ -376,7 +382,7 @@ except ConfamNodeError as e:
 
 ## Private AI Deployment
 
-Need Data-residential private AI on your own infrastructure?
+Need data-residential private AI on your own infrastructure?
 
 JoTeq the First offers:
 - On-premise deployment on Jetson devices and GPUs
@@ -391,6 +397,7 @@ Contact: [hello@confamnode.com](mailto:hello@confamnode.com)
 
 ## Links
 
+- Website: [confamnode.com](https://confamnode.com)
 - PyPI: [pypi.org/project/confamnode](https://pypi.org/project/confamnode)
 - GitHub: [github.com/confamnodeai/confamnode](https://github.com/confamnodeai/confamnode)
 - General: [hello@confamnode.com](mailto:hello@confamnode.com)
@@ -403,4 +410,4 @@ Contact: [hello@confamnode.com](mailto:hello@confamnode.com)
 
 Apache 2.0
 
----
+---

{confamnode-0.1.2 → confamnode-0.1.3}/README.md

@@ -61,7 +61,7 @@ pip install confamnode
 ```python
 from confamnode import ConfamNode
 
-client = ConfamNode(api_key="confam-sk-xxx")
+client = ConfamNode(api_key="confam-xxx")
 
 ansa = client.gist(
     model="confam-speed",
@@ -69,9 +69,9 @@ ansa = client.gist(
 )
 
 print(ansa.text)
-print(f"Cost:   ₦{ansa.cost.naira:.6f}")
+print(f"Cost: ₦{ansa.cost.naira:.6f}")
 print(f"Tokens: {ansa.usage.total_tokens}")
-print(f"ID:     {ansa.id}")
+print(f"ID: {ansa.id}")
 ```
 
 ---
@@ -81,7 +81,7 @@ print(f"ID:     {ansa.id}")
 ```python
 from confamnode import ConfamNode
 
-client = ConfamNode(api_key="confam-sk-xxx")
+client = ConfamNode(api_key="confam-xxx")
 
 stream = client.gist(
     model="confam-speed",
@@ -97,9 +97,9 @@ for yarn in stream:
 
 # Get full Ansa after stream completes
 ansa = stream.get_ansa()
-print(f"\nModel:  {ansa.model}")
+print(f"\nModel: {ansa.model}")
 print(f"Tokens: {ansa.usage.total_tokens}")
-print(f"Cost:   ₦{ansa.cost.naira:.6f}")
+print(f"Cost: ₦{ansa.cost.naira:.6f}")
 if ansa.cost.dollars:
     print(f"${ansa.cost.dollars:.8f}")
 print(f"ID: {ansa.id}")
@@ -112,7 +112,7 @@ print(f"ID: {ansa.id}")
 Every `gist()` call returns an `Ansa` object:
 
 ```python
-ansa = client.gist(model="confam-speed", messages="How far?")
+ansa = client.gist(model="confam-speed", messages="How you dey?")
 
 # Response
 ansa.text               # response text
@@ -123,7 +123,7 @@ ansa.citations          # citations (search models only)
 ansa.finish_reason      # why generation stopped
 
 # Usage
-ansa.usage.prompt_tokens      # input tokens used
+ansa.usage.prompt_tokens      # input tokens used (includes system message)
 ansa.usage.completion_tokens  # output tokens used
 ansa.usage.total_tokens       # total tokens used
 
@@ -137,9 +137,16 @@ ansa.cost.dollars       # cost in USD (if available)
 ansa.is_local                # True — runs on Nigerian hardware
 ansa.is_ngn_data_residency   # True — data never leaves Nigeria
 ansa.id                      # unique request ID (confam-xxxx-xxxx)
-ansa.raw                     # original LiteLLM response
+
+# Response metadata
+ansa.raw                     # dict with id, finish_reason, usage
+ansa.raw["id"]               # provider response ID
+ansa.raw["finish_reason"]    # why generation stopped
+ansa.raw["usage"]            # prompt and completion token counts
 ```
 
+> **Note:** `prompt_tokens` includes any system message tokens. This is standard behaviour across all LLM providers (OpenAI, Anthropic, etc.).
+
 ---
 
 ## Models
@@ -160,15 +167,14 @@ ansa.raw                     # original LiteLLM response
 | `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 |
 
-### Local Models — Nigeria Data Residency
+### Local Models — Nigerian Data Residency
 
 | Model | Description | Input ₦/1M | Output ₦/1M | Input ₦/1K | Output ₦/1K |
 |---|---|---|---|---|---|
-| `confam-nano` | Qwen3.5 4B on Jetson Orin Nano | ₦500 | ₦1,500 | ₦0.500 | ₦1.500 |
+| `confam-nano` | Local model — data stays in Nigeria | ₦500 | ₦1,500 | ₦0.500 | ₦1.500 |
 
 Runs entirely on Nigerian hardware. Data never transmitted abroad.
-
-Data never leaves Nigeria. Ideal for banks, fintechs, hospitals, law firms, and government agencies.
+Ideal for banks, fintechs, hospitals, law firms, and government agencies.
 
 More models coming soon. Contact [hello@confamnode.com](mailto:hello@confamnode.com) for early access.
 
@@ -235,9 +241,10 @@ Enable extended thinking for complex problems:
 ansa = client.gist(
     model="confam-reasoning",
     messages="One trader buy goods for ₦50,000 sell am for ₦75,000. After e pay ₦5,000 for transport and ₦3,000 for market, wetin be the real profit? Show how you calculate am.",
-    # Explicit reasoning control
     allowed_openai_params=["reasoning_effort"],
-    rreasoning_effort={"effort": "low", "summary": "detailed"} # effort can be "low", "mid", "high", or "xhigh". summary can be "detailed", or "concise"
+    reasoning_effort={"effort": "low", "summary": "detailed"}
+    # effort: "low", "medium", "high", or "xhigh"
+    # summary: "detailed" or "concise"
 )
 
 print(ansa.reasoning)   # thinking trace
@@ -250,9 +257,8 @@ Also available on `confam-deep-reasoning` for more complex multi-step problems:
 ansa = client.gist(
     model="confam-deep-reasoning",
     messages="Analyse the financial risk of a Nigerian fintech expanding to Ghana...",
-    # Explicit reasoning control
     allowed_openai_params=["reasoning_effort"],
-    rreasoning_effort={"effort": "low", "summary": "detailed"} # effort can be "low", "mid", "high", or "xhigh". summary can be "detailed", or "concise"
+    reasoning_effort={"effort": "high", "summary": "detailed"}
 )
 
 print(ansa.reasoning)   # full thinking trace
@@ -300,7 +306,7 @@ print(ansa.text)
 ## Environment Variable
 
 ```bash
-export CONFAMNODE_API_KEY="confam-sk-xxx"
+export CONFAMNODE_API_KEY="confam-xxx"
 ```
 
 ```python
@@ -316,7 +322,7 @@ For enterprise clients running ConfamNode on private infrastructure:
 
 ```python
 client = ConfamNode(
-    api_key="confam-sk-xxx",
+    api_key="confam-xxx",
     base_url="http://your-private-server:4000/v1"
 )
 ```
@@ -352,7 +358,7 @@ except ConfamNodeError as e:
 
 ## Private AI Deployment
 
-Need Data-residential private AI on your own infrastructure?
+Need data-residential private AI on your own infrastructure?
 
 JoTeq the First offers:
 - On-premise deployment on Jetson devices and GPUs
@@ -367,6 +373,7 @@ Contact: [hello@confamnode.com](mailto:hello@confamnode.com)
 
 ## Links
 
+- Website: [confamnode.com](https://confamnode.com)
 - PyPI: [pypi.org/project/confamnode](https://pypi.org/project/confamnode)
 - GitHub: [github.com/confamnodeai/confamnode](https://github.com/confamnodeai/confamnode)
 - General: [hello@confamnode.com](mailto:hello@confamnode.com)
@@ -379,4 +386,4 @@ Contact: [hello@confamnode.com](mailto:hello@confamnode.com)
 
 Apache 2.0
 
----
+---

{confamnode-0.1.2 → confamnode-0.1.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.1.2"
+__version__ = "0.1.3"
 
 __all__ = [
     "ConfamNode",

{confamnode-0.1.2 → confamnode-0.1.3}/confamnode/client.py

@@ -3,11 +3,12 @@ import litellm
 
 from typing import Union, List, Dict
 
-from confamnode import models
 from confamnode.ansa import Ansa, Usage, Cost
 from confamnode.prompts import CONFAMNODE_SYSTEM_MESSAGE
+from confamnode.registry import VALID_MODELS, LOCAL_MODELS
+from confamnode.utils import sanitize_raw, sanitize_stream_raw
 from confamnode.exceptions import ConfamAuthError, ConfamModelError
-from confamnode.registry import VALID_MODELS, LOCAL_MODELS, NGN_DATA_RESIDENCY_MODELS
+
 
 DEFAULT_BASE_URL = "https://api.confamnode.com/v1"
 DEFAULT_USD_TO_NAIRA = 1400.0
@@ -24,11 +25,11 @@ class ConfamNode:
         if not api_key:
             raise ValueError("api_key is required")
         
-        if not api_key.startswith("confam-sk-"):
+        if not api_key.startswith("confam-"):
             raise ConfamAuthError()
         
         self.api_key = api_key
-        self.litellm_key = api_key.removeprefix("confam-")
+        self.litellm_key = "sk-" + api_key.removeprefix("confam-")
         self.base_url = base_url or DEFAULT_BASE_URL
 
     def gist(
@@ -125,7 +126,7 @@ class ConfamNode:
             usage=usage,
             cost=cost,
             finish_reason=raw.choices[0].finish_reason,
-            raw=raw,
+            raw=sanitize_raw(raw),
             is_local=model in LOCAL_MODELS,
             is_ngn_data_residency=model in LOCAL_MODELS
         )
@@ -177,7 +178,7 @@ class ConfamStream:
             usage=usage,
             cost=cost,
             finish_reason=finish_reason,
-            raw=self._chunks,
+            raw=sanitize_stream_raw(self._chunks, finish_reason, getattr(last_chunk, "usage", None)),
             is_local=self._model in LOCAL_MODELS,
             is_ngn_data_residency=self._model in LOCAL_MODELS,
         )

confamnode-0.1.3/confamnode/utils.py

@@ -0,0 +1,29 @@
+def sanitize_raw(raw) -> dict:
+    """
+    Build sanitized raw dict.
+    """
+    return {
+        "id": getattr(raw, "id", None),
+        "finish_reason": getattr(
+            getattr(raw, "choices", [None])[0],
+            "finish_reason", None
+        ) if getattr(raw, "choices", None) else None,
+        "usage": {
+            "prompt_tokens": getattr(getattr(raw, "usage", None), "prompt_tokens", 0),
+            "completion_tokens": getattr(getattr(raw, "usage", None), "completion_tokens", 0),
+        }
+    }
+
+
+def sanitize_stream_raw(chunks, finish_reason: str, usage) -> dict:
+    """
+    Build sanitized raw dict from streaming chunks.
+    """
+    return {
+        "id": getattr(chunks[0], "id", None) if chunks else None,
+        "finish_reason": finish_reason,
+        "usage": {
+            "prompt_tokens": getattr(usage, "prompt_tokens", 0),
+            "completion_tokens": getattr(usage, "completion_tokens", 0),
+        }
+    }

{confamnode-0.1.2 → confamnode-0.1.3}/pyproject.toml

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

{confamnode-0.1.2 → confamnode-0.1.3}/tests/test_ansa.py

@@ -273,4 +273,63 @@ def test_ansa_accepts_is_local_true():
         is_ngn_data_residency=True
     )
     assert ansa.is_local == True
-    assert ansa.is_ngn_data_residency == True
+    assert ansa.is_ngn_data_residency == True
+
+
+def test_ansa_raw_is_dict():
+    usage = Usage(prompt_tokens=10, completion_tokens=20, total_tokens=30)
+    cost = Cost(naira=1.23)
+    ansa = Ansa(
+        text="How you dey?",
+        model="confam-speed",
+        usage=usage,
+        cost=cost,
+        finish_reason="stop",
+        raw={
+            "id": "confam-resp-abc123",
+            "finish_reason": "stop",
+            "usage": {
+                "prompt_tokens": 10,
+                "completion_tokens": 20,
+            }
+        }
+    )
+    assert isinstance(ansa.raw, dict)
+
+
+def test_ansa_raw_does_not_expose_model_routing():
+    usage = Usage(prompt_tokens=10, completion_tokens=20, total_tokens=30)
+    cost = Cost(naira=1.23)
+    raw = {
+        "id": "confam-resp-abc123",
+        "finish_reason": "stop",
+        "usage": {
+            "prompt_tokens": 10,
+            "completion_tokens": 20,
+        }
+    }
+    ansa = Ansa(
+        text="How you dey?",
+        model="confam-speed",
+        usage=usage,
+        cost=cost,
+        finish_reason="stop",
+        raw=raw
+    )
+    assert "model" not in ansa.raw
+    assert "openai" not in str(ansa.raw)
+    assert "_hidden_params" not in ansa.raw
+
+
+def test_ansa_raw_has_id():
+    usage = Usage(prompt_tokens=10, completion_tokens=20, total_tokens=30)
+    cost = Cost(naira=1.23)
+    ansa = Ansa(
+        text="How you dey?",
+        model="confam-speed",
+        usage=usage,
+        cost=cost,
+        finish_reason="stop",
+        raw = {"id": "confam-resp-abc123", "finish_reason": "stop", "usage": {}}
+    )
+    assert ansa.raw["id"] == "confam-resp-abc123"

{confamnode-0.1.2 → confamnode-0.1.3}/tests/test_client.py

@@ -7,8 +7,8 @@ from confamnode.exceptions import ConfamAuthError
 
 
 def test_client_accepts_api_key():
-    client = ConfamNode(api_key="confam-sk-abc123")
-    assert client.api_key == "confam-sk-abc123"
+    client = ConfamNode(api_key="confam-abc123")
+    assert client.api_key == "confam-abc123"
 
 
 def test_client_raises_error_without_api_key():
@@ -22,35 +22,35 @@ def test_client_raises_error_on_invalid_key_format():
 
 
 def test_client_key_starts_with_confam_sk():
-    client = ConfamNode(api_key="confam-sk-abc123")
-    assert client.api_key.startswith("confam-sk-")
+    client = ConfamNode(api_key="confam-abc123")
+    assert client.api_key.startswith("confam-")
 
 
 def test_client_strips_confam_prefix_for_litellm():
-    client = ConfamNode(api_key="confam-sk-abc123")
+    client = ConfamNode(api_key="confam-abc123")
     assert client.litellm_key == "sk-abc123"
 
 
 def test_client_has_default_base_url():
-    client = ConfamNode(api_key="confam-sk-abc123")
+    client = ConfamNode(api_key="confam-abc123")
     assert client.base_url == "https://api.confamnode.com/v1"
 
 
 def test_client_accepts_custom_base_url():
     client = ConfamNode(
-        api_key="confam-sk-abc123",
+        api_key="confam-abc123",
         base_url="http://192.168.1.100:4000/v1"
     )
     assert client.base_url == "http://192.168.1.100:4000/v1"
 
 
 def test_client_picks_up_api_key_from_environment():
-    with patch.dict(os.environ, {"CONFAMNODE_API_KEY": "confam-sk-abc123"}):
+    with patch.dict(os.environ, {"CONFAMNODE_API_KEY": "confam-abc123"}):
         client = ConfamNode()
-        assert client.api_key == "confam-sk-abc123"
+        assert client.api_key == "confam-abc123"
 
 
 def test_client_explicit_key_overrides_environment():
-    with patch.dict(os.environ, {"CONFAMNODE_API_KEY": "confam-sk-env123"}):
-        client = ConfamNode(api_key="confam-sk-explicit123")
-        assert client.api_key == "confam-sk-explicit123"
+    with patch.dict(os.environ, {"CONFAMNODE_API_KEY": "confam-env123"}):
+        client = ConfamNode(api_key="confam-explicit123")
+        assert client.api_key == "confam-explicit123"

{confamnode-0.1.2 → confamnode-0.1.3}/tests/test_gist.py

@@ -309,4 +309,16 @@ def test_gist_sets_is_local_true_for_nano(client, mock_litellm_response):
             messages="How you dey?"
         )
         assert ansa.is_local == True
-        assert ansa.is_ngn_data_residency == True
+        assert ansa.is_ngn_data_residency == True
+
+
+def test_gist_has_raw(client, mock_litellm_response):
+    with patch("confamnode.client.litellm.completion", return_value=mock_litellm_response):
+        ansa = client.gist(
+            model=models.SPEED,
+            messages="How you dey?"
+        )
+        assert isinstance(ansa.raw, dict)
+        assert "id" in ansa.raw
+        assert "_hidden_params" not in ansa.raw
+        assert "openai" not in str(ansa.raw)

{confamnode-0.1.2 → confamnode-0.1.3}/uv.lock

@@ -352,7 +352,7 @@ wheels = [
 
 [[package]]
 name = "confamnode"
-version = "0.1.2"
+version = "0.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "litellm" },