meshapi 0.1.5__tar.gz → 0.1.6__tar.gz

{meshapi-0.1.5 → meshapi-0.1.6}/CLAUDE.md

@@ -162,6 +162,7 @@ pytest test_rag.py::test_rag_upload_embed_search -v
 | `test_realtime.py` | WebSocket connect/close, session lifecycle |
 | `test_audio.py` | TTS synthesize, voice listing |
 | `test_video.py` | Video list, generate → retrieve |
+| `test_compare.py` | Non-streaming compare, streaming compare |
 
 ---
 
@@ -176,6 +177,40 @@ Every SDK change — however small — must include all of the following before
 
 ---
 
+---
+
+## Release
+
+Releases are triggered by pushing a `v*` git tag. The `publish.yml` workflow builds the package with hatch and publishes to PyPI via OIDC (no API token needed).
+
+### Release checklist
+
+1. **Bump the version** in `pyproject.toml`:
+   ```toml
+   version = "0.1.6"
+   ```
+
+2. **Commit the version bump**:
+   ```bash
+   git add pyproject.toml
+   git commit -m "chore: bump version to 0.1.6"
+   ```
+
+3. **Tag and push**:
+   ```bash
+   git tag v0.1.6
+   git push origin main
+   git push origin v0.1.6
+   ```
+
+4. **Monitor the workflow** at `Actions → Publish to PyPI`.
+
+5. **Verify** the new version is live:
+   ```bash
+   pip install meshapi==0.1.6
+   python -c "import meshapi; print(meshapi.__version__)"
+   ```
+
 ### RAG live test notes
 
 `test_rag_upload_embed_search` does the following:

{meshapi-0.1.5 → meshapi-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshapi
-Version: 0.1.5
+Version: 0.1.6
 Summary: Official Python SDK for the MeshAPI AI model gateway
 Project-URL: Homepage, https://meshapi.ai
 Project-URL: Documentation, https://developers.meshapi.ai

{meshapi-0.1.5 → meshapi-0.1.6}/livetests/test_audio.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import os
 
-from meshapi import MeshAPI, SpeechParams, ListVoicesParams
+from meshapi import MeshAPI, SpeechParams, ListVoicesParams, TranscriptionParams
 
 TTS_MODEL = os.environ.get("MESHAPI_TTS_MODEL", "sarvam/bulbul:v2")
 STT_MODEL = os.environ.get("MESHAPI_STT_MODEL", "sarvam/saaras:v3")
@@ -18,6 +18,22 @@ def test_audio_synthesize(client: MeshAPI) -> None:
     print(f"[PASS] audio.synthesize -> {len(audio_bytes)} bytes")
 
 
+def test_audio_stt_from_tts(client: MeshAPI) -> None:
+    audio_bytes = client.audio.synthesize(
+        SpeechParams(input="Hello from MeshAPI audio test.", model=TTS_MODEL)
+    )
+    assert isinstance(audio_bytes, bytes) and len(audio_bytes) > 0, "TTS step failed"
+
+    result = client.audio.transcribe(
+        audio_bytes,
+        TranscriptionParams(model=STT_MODEL),
+        filename="tts_output.wav",
+    )
+    assert result is not None
+    assert isinstance(result.text, str) and len(result.text) > 0
+    print(f"[PASS] audio.transcribe (via TTS audio) -> {result.text!r}")
+
+
 def test_audio_list_voices(client: MeshAPI) -> None:
     voices = client.audio.list_voices(ListVoicesParams(page_size=5))
     assert voices is not None

meshapi-0.1.6/livetests/test_compare.py

@@ -0,0 +1,38 @@
+"""Live tests: Model Compare API."""
+
+from __future__ import annotations
+
+import pytest
+from meshapi import MeshAPI, CompareParams, ChatMessage
+
+
+def test_compare_nonstreaming(client: MeshAPI, model: str, second_model: str) -> None:
+    result = client.compare.create(
+        CompareParams(
+            models=[model, second_model],
+            messages=[ChatMessage(role="user", content="What is 2+2? Reply in one word.")],
+            skip_comparison=True,
+            max_tokens=20,
+        )
+    )
+    assert result.comparison_id, "expected comparison_id"
+    assert len(result.results) == 2, f"expected 2 results, got {len(result.results)}"
+    found_models = {r.model for r in result.results}
+    assert model in found_models, f"expected {model} in results"
+    assert second_model in found_models, f"expected {second_model} in results"
+    for r in result.results:
+        assert r.content or r.error, f"result for {r.model} has neither content nor error"
+
+
+def test_compare_streaming(client: MeshAPI, model: str, second_model: str) -> None:
+    events = list(
+        client.compare.stream(
+            CompareParams(
+                models=[model, second_model],
+                messages=[ChatMessage(role="user", content="Tell me a joke.")],
+                skip_comparison=True,
+                max_tokens=50,
+            )
+        )
+    )
+    assert len(events) > 0, "expected at least one streaming event"

{meshapi-0.1.5 → meshapi-0.1.6}/meshapi/__init__.py

@@ -16,6 +16,8 @@ from ._types import (
     TranscriptionParams,
     TranscriptionResponse,
     TranscriptionTranslateParams,
+    Voice,
+    VoicesResponse,
     VoiceSettings,
     BulkEmbedResponse,
     BulkEmbedResult,
@@ -218,6 +220,8 @@ __all__ = [
     "TranscriptionTranslateParams",
     "TranscriptionResponse",
     "ListVoicesParams",
+    "Voice",
+    "VoicesResponse",
 ]
 
 

{meshapi-0.1.5 → meshapi-0.1.6}/meshapi/_types.py

@@ -935,6 +935,24 @@ class ListVoicesParams(BaseModel):
     voice_ids: Optional[List[str]] = None
 
 
+class Voice(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+    voice_id: str
+    name: str
+    category: str
+    description: str
+    preview_url: str
+    labels: Dict[str, str] = {}
+
+
+class VoicesResponse(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+    voices: List[Voice]
+    has_more: bool
+    total_count: int
+    next_page_token: Optional[str] = None
+
+
 # ---------------------------------------------------------------------------
 
 class ApiErrorBody(BaseModel):

{meshapi-0.1.5 → meshapi-0.1.6}/meshapi/resources/audio.py

@@ -11,6 +11,8 @@ from .._types import (
     TranscriptionParams,
     TranscriptionResponse,
     TranscriptionTranslateParams,
+    Voice,
+    VoicesResponse,
 )
 
 
@@ -62,16 +64,18 @@ class AudioResource:
         )
         return TranscriptionResponse.model_validate(data)
 
-    def list_voices(self, params: Optional[ListVoicesParams] = None) -> Any:
+    def list_voices(self, params: Optional[ListVoicesParams] = None) -> VoicesResponse:
         """GET /v1/audio/voices — list/search voices."""
         query: Dict[str, Any] = {}
         if params is not None:
             query = {k: v for k, v in params.model_dump(exclude_none=True).items()}
-        return self._http.get("/v1/audio/voices", params=query or None)
+        data = self._http.get("/v1/audio/voices", params=query or None)
+        return VoicesResponse.model_validate(data)
 
-    def get_voice(self, voice_id: str) -> Any:
+    def get_voice(self, voice_id: str) -> Voice:
         """GET /v1/audio/voices/{voice_id}."""
-        return self._http.get(f"/v1/audio/voices/{voice_id}")
+        data = self._http.get(f"/v1/audio/voices/{voice_id}")
+        return Voice.model_validate(data)
 
 
 class AsyncAudioResource:
@@ -122,13 +126,15 @@ class AsyncAudioResource:
         )
         return TranscriptionResponse.model_validate(data)
 
-    async def list_voices(self, params: Optional[ListVoicesParams] = None) -> Any:
+    async def list_voices(self, params: Optional[ListVoicesParams] = None) -> VoicesResponse:
         """GET /v1/audio/voices — list/search voices."""
         query: Dict[str, Any] = {}
         if params is not None:
             query = {k: v for k, v in params.model_dump(exclude_none=True).items()}
-        return await self._http.get("/v1/audio/voices", params=query or None)
+        data = await self._http.get("/v1/audio/voices", params=query or None)
+        return VoicesResponse.model_validate(data)
 
-    async def get_voice(self, voice_id: str) -> Any:
+    async def get_voice(self, voice_id: str) -> Voice:
         """GET /v1/audio/voices/{voice_id}."""
-        return await self._http.get(f"/v1/audio/voices/{voice_id}")
+        data = await self._http.get(f"/v1/audio/voices/{voice_id}")
+        return Voice.model_validate(data)

{meshapi-0.1.5 → meshapi-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "meshapi"
-version = "0.1.5"
+version = "0.1.6"
 description = "Official Python SDK for the MeshAPI AI model gateway"
 readme = "README.md"
 requires-python = ">=3.9"