morphik 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

morphik/__init__.py

@@ -12,4 +12,4 @@ __all__ = [
     "Document",
 ]
 
-__version__ = "0.1.8"
+__version__ = "0.2.1"

morphik/async_.py

@@ -3,6 +3,7 @@ import logging
 from io import BytesIO, IOBase
 from pathlib import Path
 from typing import Any, BinaryIO, Dict, List, Optional, Type, Union
+from datetime import datetime
 
 import httpx
 from pydantic import BaseModel
@@ -2590,3 +2591,77 @@ class AsyncMorphik:
                 raise RuntimeError(graph.error or "Graph processing failed")
             await asyncio.sleep(check_interval_seconds)
         raise TimeoutError("Timed out waiting for graph completion")
+
+    async def ping(self) -> Dict[str, Any]:
+        """Simple health-check call to ``/ping`` endpoint."""
+        return await self._request("GET", "ping")
+
+    # ------------------------------------------------------------------
+    # Chat API ----------------------------------------------------------
+    # ------------------------------------------------------------------
+    async def get_chat_history(self, chat_id: str) -> List[Dict[str, Any]]:
+        """Return the full message history for *chat_id*."""
+        return await self._request("GET", f"chat/{chat_id}")
+
+    async def list_chat_conversations(self, limit: int = 100) -> List[Dict[str, Any]]:
+        """List recent chat conversations for the current user (async)."""
+        limit_capped = max(1, min(limit, 500))
+        return await self._request("GET", "chats", params={"limit": limit_capped})
+
+    # ------------------------------------------------------------------
+    # Usage API ---------------------------------------------------------
+    # ------------------------------------------------------------------
+    async def get_usage_stats(self) -> Dict[str, int]:
+        """Return cumulative token usage statistics (async)."""
+        return await self._request("GET", "usage/stats")
+
+    async def get_recent_usage(
+        self,
+        operation_type: Optional[str] = None,
+        since: Optional["datetime"] = None,
+        status: Optional[str] = None,
+    ) -> List[Dict[str, Any]]:
+        """Return recent usage entries with optional filtering (async)."""
+        from datetime import datetime
+
+        params: Dict[str, Any] = {}
+        if operation_type:
+            params["operation_type"] = operation_type
+        if since:
+            params["since"] = since.isoformat() if isinstance(since, datetime) else str(since)
+        if status:
+            params["status"] = status
+        return await self._request("GET", "usage/recent", params=params)
+
+    # ------------------------------------------------------------------
+    # Graph helpers -----------------------------------------------------
+    # ------------------------------------------------------------------
+    async def get_graph_visualization(
+        self,
+        name: str,
+        folder_name: Optional[Union[str, List[str]]] = None,
+        end_user_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Fetch nodes & links for visualising *name* graph (async)."""
+        params: Dict[str, Any] = {}
+        if folder_name is not None:
+            params["folder_name"] = folder_name
+        if end_user_id is not None:
+            params["end_user_id"] = end_user_id
+        return await self._request("GET", f"graph/{name}/visualization", params=params)
+
+    async def check_workflow_status(
+        self, workflow_id: str, run_id: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """Poll the status of an async graph build/update workflow."""
+        params = {"run_id": run_id} if run_id else None
+        return await self._request("GET", f"graph/workflow/{workflow_id}/status", params=params)
+
+    # ------------------------------------------------------------------
+    # Document download helpers ----------------------------------------
+    # ------------------------------------------------------------------
+    async def get_document_download_url(self, document_id: str, expires_in: int = 3600) -> Dict[str, Any]:
+        """Generate a presigned download URL for a document (async)."""
+        return await self._request(
+            "GET", f"documents/{document_id}/download_url", params={"expires_in": expires_in}
+        )

morphik/sync.py

@@ -3,6 +3,7 @@ import logging
 from io import BytesIO, IOBase
 from pathlib import Path
 from typing import Any, BinaryIO, Dict, List, Optional, Type, Union
+from datetime import datetime
 
 import httpx
 from pydantic import BaseModel
@@ -2763,3 +2764,96 @@ class Morphik:
                 raise RuntimeError(graph.error or "Graph processing failed")
             time.sleep(check_interval_seconds)
         raise TimeoutError("Timed out waiting for graph completion")
+
+    def ping(self) -> Dict[str, Any]:
+        """Simple health-check call to the server (``/ping``).
+
+        Returns
+        -------
+        Dict[str, Any]
+            The JSON payload returned by the server, typically
+            ``{"status": "ok", "message": "Server is running"}``.
+        """
+        return self._request("GET", "ping")
+
+    # ------------------------------------------------------------------
+    # Chat API ----------------------------------------------------------
+    # ------------------------------------------------------------------
+    def get_chat_history(self, chat_id: str) -> List[Dict[str, Any]]:
+        """Return the full message history for the given *chat_id*.
+
+        Parameters
+        ----------
+        chat_id:
+            Identifier of the chat conversation returned by previous
+            calls that used ``chat_id``.
+        """
+        return self._request("GET", f"chat/{chat_id}")
+
+    def list_chat_conversations(self, limit: int = 100) -> List[Dict[str, Any]]:
+        """List recent chat conversations available to the current user.
+
+        Parameters
+        ----------
+        limit:
+            Maximum number of conversations to return (1-500).
+        """
+        limit_capped = max(1, min(limit, 500))
+        return self._request("GET", "chats", params={"limit": limit_capped})
+
+    # ------------------------------------------------------------------
+    # Usage API ---------------------------------------------------------
+    # ------------------------------------------------------------------
+    def get_usage_stats(self) -> Dict[str, int]:
+        """Return cumulative usage statistics for the authenticated user."""
+        return self._request("GET", "usage/stats")
+
+    def get_recent_usage(
+        self,
+        operation_type: Optional[str] = None,
+        since: Optional["datetime"] = None,
+        status: Optional[str] = None,
+    ) -> List[Dict[str, Any]]:
+        """Return recent usage records with optional filtering."""
+        from datetime import datetime  # Local import ensures small dependency surface
+
+        params: Dict[str, Any] = {}
+        if operation_type:
+            params["operation_type"] = operation_type
+        if since:
+            # Accept either ``str`` or ``datetime`` for *since*
+            params["since"] = since.isoformat() if isinstance(since, datetime) else str(since)
+        if status:
+            params["status"] = status
+        return self._request("GET", "usage/recent", params=params)
+
+    # ------------------------------------------------------------------
+    # Graph helpers -----------------------------------------------------
+    # ------------------------------------------------------------------
+    def get_graph_visualization(
+        self,
+        name: str,
+        folder_name: Optional[Union[str, List[str]]] = None,
+        end_user_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Fetch nodes & links for visualising *name* graph."""
+        params: Dict[str, Any] = {}
+        if folder_name is not None:
+            params["folder_name"] = folder_name
+        if end_user_id is not None:
+            params["end_user_id"] = end_user_id
+        return self._request("GET", f"graph/{name}/visualization", params=params)
+
+    def check_workflow_status(self, workflow_id: str, run_id: Optional[str] = None) -> Dict[str, Any]:
+        """Poll the status of an asynchronous graph build/update workflow."""
+        params = {"run_id": run_id} if run_id else None
+        return self._request("GET", f"graph/workflow/{workflow_id}/status", params=params)
+
+    # ------------------------------------------------------------------
+    # Document download helpers ----------------------------------------
+    # ------------------------------------------------------------------
+    def get_document_download_url(self, document_id: str, expires_in: int = 3600) -> Dict[str, Any]:
+        """Generate a presigned download URL for a document stored remotely."""
+        return self._request(
+            "GET", f"documents/{document_id}/download_url", params={"expires_in": expires_in}
+        )

{morphik-0.2.0.dist-info → morphik-0.2.1.dist-info}/METADATA

@@ -1,16 +1,14 @@
 Metadata-Version: 2.4
 Name: morphik
-Version: 0.2.0
+Version: 0.2.1
 Summary: Morphik Python Client
 Author-email: Morphik <founders@morphik.ai>
 Requires-Python: >=3.8
-Requires-Dist: build>=1.2.2.post1
 Requires-Dist: httpx>=0.24.0
 Requires-Dist: pillow>=10.4.0
 Requires-Dist: pydantic>=2.10.3
 Requires-Dist: pyjwt>=2.0.0
 Requires-Dist: requests>=2.32.3
-Requires-Dist: twine>=6.1.0
 Description-Content-Type: text/markdown
 
 # Morphik

{morphik-0.2.0.dist-info → morphik-0.2.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
-morphik/__init__.py,sha256=aefTQR9UbZAzbPCup-ooUscRpR8ExPknjd9b_GhMRQA,242
+morphik/__init__.py,sha256=hUNHM6uAWKjgTUETBA0VeVb1rWoT_ncknW5Id-SPCuY,242
 morphik/_internal.py,sha256=pV1dbZZ8ab7bchAAdqqDbJcOeu_vM6TnNtjY6tS-wDY,19650
-morphik/async_.py,sha256=g1P1bjodNaJ36dNv7PJ9TGwwIolqqVw5K9Yjk7qM1IQ,97756
+morphik/async_.py,sha256=26SM1TjOahLk-x4eyY1elQLsoLETGnQbBATYUYqDayM,101405
 morphik/exceptions.py,sha256=v4XGmfq5B0KrZEF6M1ID8A50-45-SRAQZTrXGXM6n0Q,260
 morphik/models.py,sha256=JFMeGLbEke-Bls08JXCBv3y_z4eI3PBW_mbX-989i5I,20942
 morphik/rules.py,sha256=fw0RovS0Pwtff8Dvo3nkM3Wl6WtR3ykSaxsU_sxdXKI,2565
-morphik/sync.py,sha256=ildH5pqJK8nhhSPRjC68Btf5KqGZR5MP-CrckxPicwE,102008
+morphik/sync.py,sha256=kC8oAlzzUFO6n8my_cnEIVT7U5MCye67dau8kVbeLJI,106182
 morphik/tests/README.md,sha256=jtJDDK8cS5E4SbygFQDy7t6Y-kQwNYtZajRwVJDR62U,1069
 morphik/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 morphik/tests/example_usage.py,sha256=ls8n7355q-8gY43pZLKd4SzI-01MdFeXbT8bZ4U8MCg,11561
@@ -13,6 +13,6 @@ morphik/tests/test_sync.py,sha256=Reqa25Q259mCr-tzWzc1RDcs5KZuDfBkJRKOyyxhDtE,13
 morphik/tests/test_docs/sample1.txt,sha256=Fx6TElSiKdxyFeBp1iHthzHctFVZm38DrqcbdZMoidY,507
 morphik/tests/test_docs/sample2.txt,sha256=PE97gPv59J27A7CSNvi_0tRBIN3Mj6pyTFElCLfs3TE,686
 morphik/tests/test_docs/sample3.txt,sha256=OzrnJ_XsDUntEV0jk-ansa3_KIa6GnpvS5EVmlh6BHo,732
-morphik-0.2.0.dist-info/METADATA,sha256=WCKIDa8zwkQJatjOdkVaE5Xsyn1sXnfD_XYUFiA3ACY,3439
-morphik-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-morphik-0.2.0.dist-info/RECORD,,
+morphik-0.2.1.dist-info/METADATA,sha256=ej62vqMtwpxsaVdL8ExdDqs68hicO3FrG1X8dd-qSDk,3377
+morphik-0.2.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+morphik-0.2.1.dist-info/RECORD,,