meshapi 0.1.0__py3-none-any.whl

meshapi/resources/compare.py

@@ -0,0 +1,43 @@
+"""Compare resource — POST /v1/chat/compare."""
+
+from __future__ import annotations
+
+from typing import AsyncIterator, Iterator
+
+from .._http import AsyncHttpClient, SyncHttpClient
+from .._types import CompareParams, CompareResponse, CompareStreamEvent
+
+
+class CompareResource:
+    def __init__(self, http: SyncHttpClient) -> None:
+        self._http = http
+
+    def create(self, params: CompareParams) -> CompareResponse:
+        body = params.model_dump(exclude_none=True)
+        if body.get("stream"):
+            raise ValueError("Use stream() for streaming compare requests.")
+        data = self._http.post("/v1/chat/compare", body)
+        return CompareResponse.model_validate(data)
+
+    def stream(self, params: CompareParams) -> Iterator[CompareStreamEvent]:
+        body = params.model_dump(exclude_none=True)
+        body["stream"] = True
+        yield from self._http.stream_json("/v1/chat/compare", body, CompareStreamEvent)
+
+
+class AsyncCompareResource:
+    def __init__(self, http: AsyncHttpClient) -> None:
+        self._http = http
+
+    async def create(self, params: CompareParams) -> CompareResponse:
+        body = params.model_dump(exclude_none=True)
+        if body.get("stream"):
+            raise ValueError("Use stream() for streaming compare requests.")
+        data = await self._http.post("/v1/chat/compare", body)
+        return CompareResponse.model_validate(data)
+
+    async def stream(self, params: CompareParams) -> AsyncIterator[CompareStreamEvent]:
+        body = params.model_dump(exclude_none=True)
+        body["stream"] = True
+        async for event in self._http.stream_json("/v1/chat/compare", body, CompareStreamEvent):
+            yield event

meshapi/resources/embeddings.py

@@ -0,0 +1,24 @@
+"""Embeddings resource — POST /v1/embeddings."""
+
+from __future__ import annotations
+
+from .._http import AsyncHttpClient, SyncHttpClient
+from .._types import EmbeddingsParams, EmbeddingsResponse
+
+
+class EmbeddingsResource:
+    def __init__(self, http: SyncHttpClient) -> None:
+        self._http = http
+
+    def create(self, params: EmbeddingsParams) -> EmbeddingsResponse:
+        data = self._http.post("/v1/embeddings", params.model_dump(exclude_none=True))
+        return EmbeddingsResponse.model_validate(data)
+
+
+class AsyncEmbeddingsResource:
+    def __init__(self, http: AsyncHttpClient) -> None:
+        self._http = http
+
+    async def create(self, params: EmbeddingsParams) -> EmbeddingsResponse:
+        data = await self._http.post("/v1/embeddings", params.model_dump(exclude_none=True))
+        return EmbeddingsResponse.model_validate(data)

meshapi/resources/files.py

@@ -0,0 +1,44 @@
+"""Files resource — /v1/files endpoints for batch workflows."""
+
+from __future__ import annotations
+
+from .._http import AsyncHttpClient, SyncHttpClient
+from .._types import FileObject, UploadBatchFileParams
+
+
+class FilesResource:
+    def __init__(self, http: SyncHttpClient) -> None:
+        self._http = http
+
+    def upload(self, params: UploadBatchFileParams) -> FileObject:
+        data = self._http.post("/v1/files", params.model_dump(exclude_none=True))
+        return FileObject.model_validate(data)
+
+    def get(self, file_id: str) -> FileObject:
+        data = self._http.get(f"/v1/files/{file_id}")
+        return FileObject.model_validate(data)
+
+    def delete(self, file_id: str) -> None:
+        self._http.delete(f"/v1/files/{file_id}")
+
+    def content(self, file_id: str) -> bytes:
+        return self._http.get_bytes(f"/v1/files/{file_id}/content")
+
+
+class AsyncFilesResource:
+    def __init__(self, http: AsyncHttpClient) -> None:
+        self._http = http
+
+    async def upload(self, params: UploadBatchFileParams) -> FileObject:
+        data = await self._http.post("/v1/files", params.model_dump(exclude_none=True))
+        return FileObject.model_validate(data)
+
+    async def get(self, file_id: str) -> FileObject:
+        data = await self._http.get(f"/v1/files/{file_id}")
+        return FileObject.model_validate(data)
+
+    async def delete(self, file_id: str) -> None:
+        await self._http.delete(f"/v1/files/{file_id}")
+
+    async def content(self, file_id: str) -> bytes:
+        return await self._http.get_bytes(f"/v1/files/{file_id}/content")

meshapi/resources/models.py

@@ -0,0 +1,48 @@
+"""Models resource — GET /v1/models, /v1/models/free, /v1/models/paid."""
+
+from __future__ import annotations
+
+from typing import List, Optional
+
+from .._http import AsyncHttpClient, SyncHttpClient
+from .._types import ModelInfo
+
+
+class ModelsResource:
+    def __init__(self, http: SyncHttpClient) -> None:
+        self._http = http
+
+    def list(self, *, free: Optional[bool] = None) -> List[ModelInfo]:
+        params = {}
+        if free is not None:
+            params["free"] = str(free).lower()
+        data = self._http.get("/v1/models", params=params or None)
+        return [ModelInfo.model_validate(m) for m in (data or [])]
+
+    def free(self) -> List[ModelInfo]:
+        data = self._http.get("/v1/models/free")
+        return [ModelInfo.model_validate(m) for m in (data or [])]
+
+    def paid(self) -> List[ModelInfo]:
+        data = self._http.get("/v1/models/paid")
+        return [ModelInfo.model_validate(m) for m in (data or [])]
+
+
+class AsyncModelsResource:
+    def __init__(self, http: AsyncHttpClient) -> None:
+        self._http = http
+
+    async def list(self, *, free: Optional[bool] = None) -> List[ModelInfo]:
+        params = {}
+        if free is not None:
+            params["free"] = str(free).lower()
+        data = await self._http.get("/v1/models", params=params or None)
+        return [ModelInfo.model_validate(m) for m in (data or [])]
+
+    async def free(self) -> List[ModelInfo]:
+        data = await self._http.get("/v1/models/free")
+        return [ModelInfo.model_validate(m) for m in (data or [])]
+
+    async def paid(self) -> List[ModelInfo]:
+        data = await self._http.get("/v1/models/paid")
+        return [ModelInfo.model_validate(m) for m in (data or [])]

meshapi/resources/responses.py

@@ -0,0 +1,43 @@
+"""Responses resource — POST /v1/responses."""
+
+from __future__ import annotations
+
+from typing import AsyncIterator, Iterator
+
+from .._http import AsyncHttpClient, SyncHttpClient
+from .._types import ResponsesParams, ResponsesResponse, ResponsesStreamEvent
+
+
+class ResponsesResource:
+    def __init__(self, http: SyncHttpClient) -> None:
+        self._http = http
+
+    def create(self, params: ResponsesParams) -> ResponsesResponse:
+        body = params.model_dump(exclude_none=True)
+        if body.get("stream"):
+            raise ValueError("Use stream() for streaming responses requests.")
+        data = self._http.post("/v1/responses", body)
+        return ResponsesResponse.model_validate(data)
+
+    def stream(self, params: ResponsesParams) -> Iterator[ResponsesStreamEvent]:
+        body = params.model_dump(exclude_none=True)
+        body["stream"] = True
+        yield from self._http.stream_json("/v1/responses", body, ResponsesStreamEvent)
+
+
+class AsyncResponsesResource:
+    def __init__(self, http: AsyncHttpClient) -> None:
+        self._http = http
+
+    async def create(self, params: ResponsesParams) -> ResponsesResponse:
+        body = params.model_dump(exclude_none=True)
+        if body.get("stream"):
+            raise ValueError("Use stream() for streaming responses requests.")
+        data = await self._http.post("/v1/responses", body)
+        return ResponsesResponse.model_validate(data)
+
+    async def stream(self, params: ResponsesParams) -> AsyncIterator[ResponsesStreamEvent]:
+        body = params.model_dump(exclude_none=True)
+        body["stream"] = True
+        async for event in self._http.stream_json("/v1/responses", body, ResponsesStreamEvent):
+            yield event

meshapi/resources/templates.py

@@ -0,0 +1,60 @@
+"""Templates resource — CRUD on /v1/templates."""
+
+from __future__ import annotations
+
+from typing import List
+
+from .._http import AsyncHttpClient, SyncHttpClient
+from .._types import CreateTemplateParams, TemplateSummary, UpdateTemplateParams
+
+
+class TemplatesResource:
+    def __init__(self, http: SyncHttpClient) -> None:
+        self._http = http
+
+    def create(self, params: CreateTemplateParams) -> TemplateSummary:
+        data = self._http.post("/v1/templates", params.model_dump(exclude_none=True))
+        return TemplateSummary.model_validate(data)
+
+    def list(self) -> List[TemplateSummary]:
+        data = self._http.get("/v1/templates")
+        return [TemplateSummary.model_validate(t) for t in (data or [])]
+
+    def get(self, template_id: str) -> TemplateSummary:
+        data = self._http.get(f"/v1/templates/{template_id}")
+        return TemplateSummary.model_validate(data)
+
+    def update(self, template_id: str, params: UpdateTemplateParams) -> TemplateSummary:
+        data = self._http.patch(
+            f"/v1/templates/{template_id}", params.model_dump(exclude_none=True)
+        )
+        return TemplateSummary.model_validate(data)
+
+    def delete(self, template_id: str) -> None:
+        self._http.delete(f"/v1/templates/{template_id}")
+
+
+class AsyncTemplatesResource:
+    def __init__(self, http: AsyncHttpClient) -> None:
+        self._http = http
+
+    async def create(self, params: CreateTemplateParams) -> TemplateSummary:
+        data = await self._http.post("/v1/templates", params.model_dump(exclude_none=True))
+        return TemplateSummary.model_validate(data)
+
+    async def list(self) -> List[TemplateSummary]:
+        data = await self._http.get("/v1/templates")
+        return [TemplateSummary.model_validate(t) for t in (data or [])]
+
+    async def get(self, template_id: str) -> TemplateSummary:
+        data = await self._http.get(f"/v1/templates/{template_id}")
+        return TemplateSummary.model_validate(data)
+
+    async def update(self, template_id: str, params: UpdateTemplateParams) -> TemplateSummary:
+        data = await self._http.patch(
+            f"/v1/templates/{template_id}", params.model_dump(exclude_none=True)
+        )
+        return TemplateSummary.model_validate(data)
+
+    async def delete(self, template_id: str) -> None:
+        await self._http.delete(f"/v1/templates/{template_id}")