needlepath 0.1.0__tar.gz → 0.1.1__tar.gz

{needlepath-0.1.0 → needlepath-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: needlepath
-Version: 0.1.0
+Version: 0.1.1
 Summary: Framework-free client for the Needlepath hosted context-selection service.
 Project-URL: Homepage, https://nextmoca.com
 Author: Next Moca Global, Inc.
@@ -94,7 +94,7 @@ never blocks the event loop either way.
 |---|---|---|
 | `api_key` | `NEEDLEPATH_API_KEY` | none (no `Authorization` header) |
 | `operating_point` | `NEEDLEPATH_OPERATING_POINT` | **required** |
-| `base_url` | `NEEDLEPATH_BASE_URL` | `https://ayf02egtaf.execute-api.us-east-2.amazonaws.com/prod` |
+| `base_url` | `NEEDLEPATH_BASE_URL` | `https://api.nextmoca.com` |
 | `timeout` | — | `10.0` s, total, retries included |
 | `max_retries` | — | `2` |
 | `max_request_bytes` | — | `6 * 1024 * 1024` |

{needlepath-0.1.0 → needlepath-0.1.1}/README.md

@@ -65,7 +65,7 @@ never blocks the event loop either way.
 |---|---|---|
 | `api_key` | `NEEDLEPATH_API_KEY` | none (no `Authorization` header) |
 | `operating_point` | `NEEDLEPATH_OPERATING_POINT` | **required** |
-| `base_url` | `NEEDLEPATH_BASE_URL` | `https://ayf02egtaf.execute-api.us-east-2.amazonaws.com/prod` |
+| `base_url` | `NEEDLEPATH_BASE_URL` | `https://api.nextmoca.com` |
 | `timeout` | — | `10.0` s, total, retries included |
 | `max_retries` | — | `2` |
 | `max_request_bytes` | — | `6 * 1024 * 1024` |

{needlepath-0.1.0 → needlepath-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "needlepath"
-version = "0.1.0"
+version = "0.1.1"
 description = "Framework-free client for the Needlepath hosted context-selection service."
 readme = "README.md"
 requires-python = ">=3.9"

{needlepath-0.1.0 → needlepath-0.1.1}/src/needlepath/client.py

@@ -62,7 +62,7 @@ from .version import __version__
 #: follow-through (§5, S-17a); until it exists this is the address published runs
 #: and design partners use, and it stays overridable by argument or by
 #: ``NEEDLEPATH_BASE_URL`` so that swapping it is a config change, not a release.
-DEFAULT_BASE_URL = "https://ayf02egtaf.execute-api.us-east-2.amazonaws.com/prod"
+DEFAULT_BASE_URL = "https://api.nextmoca.com"
 
 SELECT_PATH = "/v1/context/select"
 HEALTH_PATH = "/v1/health"

{needlepath-0.1.0 → needlepath-0.1.1}/src/needlepath/models.py

@@ -90,24 +90,34 @@ class ContextRecord:
     source: Optional[str] = None
     title: Optional[str] = None
     step_id: Optional[str] = None
-    importance: float = 0.0
+    # NEXPE-437: None means "the caller never annotated importance", and the
+    # field is then OMITTED from the wire so the server applies its neutral
+    # default. The old `0.0` default was sent explicitly, which the server
+    # cannot tell apart from a deliberate 0.0 -- and 0.0 stands the record
+    # down. An explicit `importance=0.0` still goes on the wire as 0.0.
+    importance: Optional[float] = None
     keywords: List[str] = field(default_factory=list)
     tags: List[str] = field(default_factory=list)
     attributes: Dict[str, Any] = field(default_factory=dict)
 
     def to_wire(self) -> Dict[str, Any]:
-        return {
+        wire = {
             "text": self.text,
             "kind": self.kind,
             "id": self.id,
             "source": self.source,
             "title": self.title,
             "step_id": self.step_id,
-            "importance": self.importance,
             "keywords": list(self.keywords),
             "tags": list(self.tags),
             "attributes": dict(self.attributes),
         }
+        # NEXPE-437: omitted, not null. The server reads importance with
+        # `float(d.get("importance", ...))`, so `null` would be a crash and
+        # an always-present key would erase the unset/explicit distinction.
+        if self.importance is not None:
+            wire["importance"] = self.importance
+        return wire
 
     @classmethod
     def from_wire(cls, d: Dict[str, Any]) -> ContextRecord:
@@ -118,7 +128,7 @@ class ContextRecord:
             source=d.get("source"),
             title=d.get("title"),
             step_id=d.get("step_id"),
-            importance=float(d.get("importance", 0.0)),
+            importance=float(d["importance"]) if d.get("importance") is not None else None,
             keywords=list(d.get("keywords", [])),
             tags=list(d.get("tags", [])),
             attributes=dict(d.get("attributes", {})),

{needlepath-0.1.0 → needlepath-0.1.1}/tests/test_config_and_guards.py

@@ -185,7 +185,7 @@ def test_base_url_comes_from_the_environment(monkeypatch):
 def test_the_documented_default_is_what_ships():
     from needlepath import DEFAULT_BASE_URL
 
-    assert DEFAULT_BASE_URL == "https://ayf02egtaf.execute-api.us-east-2.amazonaws.com/prod"
+    assert DEFAULT_BASE_URL == "https://api.nextmoca.com"
 
 
 # --------------------------------------------------------------------------- #

{needlepath-0.1.0 → needlepath-0.1.1}/tests/test_wire_compatibility.py

@@ -182,7 +182,11 @@ def test_to_wire_emits_the_full_shape_including_nones():
     )
     wire = request.to_wire()
     assert set(wire) == PUBLISHED["ContextRequest"]
-    assert set(wire["records"][0]) == PUBLISHED["ContextRecord"]
+    # NEXPE-437: `importance` is the one deliberate exception to the
+    # full-shape rule. Unset means OMITTED from the wire, so the server can
+    # tell "never annotated" (neutral) apart from an explicit 0.0
+    # (stand-down). Every other optional stays present-as-null.
+    assert set(wire["records"][0]) == PUBLISHED["ContextRecord"] - {"importance"}
     assert set(wire["task"]) == PUBLISHED["TaskSpec"]
     assert set(wire["budget"]) == PUBLISHED["BudgetSpec"]
     assert wire["records"][0]["source"] is None  # present, not omitted
@@ -190,6 +194,22 @@ def test_to_wire_emits_the_full_shape_including_nones():
     json.dumps(wire)  # and it is serializable
 
 
+def test_unset_importance_is_omitted_and_explicit_zero_is_sent():
+    """NEXPE-437: the wire distinguishes unannotated from deliberately 0.0."""
+    unset = models.ContextRecord(text="t").to_wire()
+    assert "importance" not in unset
+
+    explicit_zero = models.ContextRecord(text="t", importance=0.0).to_wire()
+    assert explicit_zero["importance"] == 0.0
+
+    explicit = models.ContextRecord(text="t", importance=7.5).to_wire()
+    assert explicit["importance"] == 7.5
+
+    # And from_wire preserves the same distinction on the way back in.
+    assert models.ContextRecord.from_wire({"text": "t"}).importance is None
+    assert models.ContextRecord.from_wire({"text": "t", "importance": 0.0}).importance == 0.0
+
+
 def test_unknown_response_fields_are_kept_not_rejected():
     """`/v1` is additive (API_VERSIONING.md). `usage` is already scheduled to
     arrive this way (E2), and a client that 'validates' by rejecting unknown