Merge pull request #2 from Not-Diamond/release-please--branches--main--changes--next

release: 0.2.0

Author: dragos199993

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0"
+  ".": "0.2.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 57
+configured_endpoints: 20
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/not-diamond-dragos199993%2Fnot-diamond-16cbc3880d2b786cefa8c80a6dd1129791483c0b487955104c68a5c13f00a69b.yml
 openapi_spec_hash: 4c16e5753f4b9e0a20dd01706c5d07d7
-config_hash: 9677dbeed46c9972dd85705a35091068
+config_hash: 36de232224f15ed78970b28252ccf625

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.0 (2025-10-09)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/Not-Diamond/not-diamond-python/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* **api:** manual updates ([9ee8b3e](https://github.com/Not-Diamond/not-diamond-python/commit/9ee8b3e1220e45b00ce9c9078ab7f54bb1e34e19))
+
 ## 0.1.0 (2025-10-09)
 
 Full Changelog: [v0.0.1...v0.1.0](https://github.com/Not-Diamond/not-diamond-python/compare/v0.0.1...v0.1.0)

README.md

@@ -28,14 +28,19 @@ pip install git+ssh://git@github.com/Not-Diamond/not-diamond-python.git
 The full API of this library can be found in [api.md](api.md).
 
 ```python
-import os
 from not_diamond import NotDiamond
 
-client = NotDiamond(
-    api_key=os.environ.get("NOT_DIAMOND_API_KEY"),  # This is the default and can be omitted
-)
+client = NotDiamond()
 
-response = client.retrieve_root()
+response = client.model_router.select_model(
+    llm_providers=[
+        {
+            "model": "model",
+            "provider": "provider",
+        }
+    ],
+    messages=[{"foo": "string"}],
+)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -48,17 +53,22 @@ so that your API Key is not stored in source control.
 Simply import `AsyncNotDiamond` instead of `NotDiamond` and use `await` with each API call:
 
 ```python
-import os
 import asyncio
 from not_diamond import AsyncNotDiamond
 
-client = AsyncNotDiamond(
-    api_key=os.environ.get("NOT_DIAMOND_API_KEY"),  # This is the default and can be omitted
-)
+client = AsyncNotDiamond()
 
 
 async def main() -> None:
-    response = await client.retrieve_root()
+    response = await client.model_router.select_model(
+        llm_providers=[
+            {
+                "model": "model",
+                "provider": "provider",
+            }
+        ],
+        messages=[{"foo": "string"}],
+    )
 
 
 asyncio.run(main())
@@ -87,10 +97,17 @@ from not_diamond import AsyncNotDiamond
 
 async def main() -> None:
     async with AsyncNotDiamond(
-        api_key="My API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        response = await client.retrieve_root()
+        response = await client.model_router.select_model(
+            llm_providers=[
+                {
+                    "model": "model",
+                    "provider": "provider",
+                }
+            ],
+            messages=[{"foo": "string"}],
+        )
 
 
 asyncio.run(main())
@@ -114,16 +131,23 @@ from not_diamond import NotDiamond
 
 client = NotDiamond()
 
-response = client.report.evaluate_hallucination(
-    context="context",
-    prompt="prompt",
-    provider={
+response = client.prompt.adapt(
+    fields=["string"],
+    goldens=[{"fields": {"foo": "string"}}],
+    origin_model={
         "model": "model",
         "provider": "provider",
     },
-    response="response",
+    system_prompt="system_prompt",
+    target_models=[
+        {
+            "model": "model",
+            "provider": "provider",
+        }
+    ],
+    template="template",
 )
-print(response.provider)
+print(response.origin_model)
 ```
 
 ## File uploads
@@ -165,7 +189,15 @@ from not_diamond import NotDiamond
 client = NotDiamond()
 
 try:
-    client.retrieve_root()
+    client.model_router.select_model(
+        llm_providers=[
+            {
+                "model": "model",
+                "provider": "provider",
+            }
+        ],
+        messages=[{"foo": "string"}],
+    )
 except not_diamond.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -208,7 +240,15 @@ client = NotDiamond(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).retrieve_root()
+client.with_options(max_retries=5).model_router.select_model(
+    llm_providers=[
+        {
+            "model": "model",
+            "provider": "provider",
+        }
+    ],
+    messages=[{"foo": "string"}],
+)
 ```
 
 ### Timeouts
@@ -231,7 +271,15 @@ client = NotDiamond(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).retrieve_root()
+client.with_options(timeout=5.0).model_router.select_model(
+    llm_providers=[
+        {
+            "model": "model",
+            "provider": "provider",
+        }
+    ],
+    messages=[{"foo": "string"}],
+)
 ```
 
 On timeout, an `APITimeoutError` is thrown.
@@ -272,11 +320,19 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from not_diamond import NotDiamond
 
 client = NotDiamond()
-response = client.with_raw_response.retrieve_root()
+response = client.model_router.with_raw_response.select_model(
+    llm_providers=[{
+        "model": "model",
+        "provider": "provider",
+    }],
+    messages=[{
+        "foo": "string"
+    }],
+)
 print(response.headers.get('X-My-Header'))
 
-client = response.parse()  # get the object that `retrieve_root()` would have returned
-print(client)
+model_router = response.parse()  # get the object that `model_router.select_model()` would have returned
+print(model_router)
 ```
 
 These methods return an [`APIResponse`](https://github.com/Not-Diamond/not-diamond-python/tree/main/src/not_diamond/_response.py) object.
@@ -290,7 +346,15 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.with_streaming_response.retrieve_root() as response:
+with client.model_router.with_streaming_response.select_model(
+    llm_providers=[
+        {
+            "model": "model",
+            "provider": "provider",
+        }
+    ],
+    messages=[{"foo": "string"}],
+) as response:
     print(response.headers.get("X-My-Header"))
 
     for line in response.iter_lines():