morphik 1.2.1__tar.gz → 1.2.3__tar.gz

{morphik-1.2.1 → morphik-1.2.3}/.gitignore

@@ -59,4 +59,5 @@ multi_vector_embeddings_*.json
 morphik_rust/target/
 morphik_rust/Cargo.lock
 DOCS_BY_FACILITIES/
-eval_freshworks/
+eval_freshworks/
+iep_test/

{morphik-1.2.1 → morphik-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: morphik
-Version: 1.2.1
+Version: 1.2.3
 Summary: Morphik Python Client
 Author-email: Morphik <founders@morphik.ai>
 Requires-Python: >=3.8
@@ -52,6 +52,9 @@ from morphik import Morphik
 # Initialize client - connects to localhost:8000 by default
 db = Morphik()
 
+# You can also use a direct HTTP(S) base URL for self-hosted deployments
+# db = Morphik("http://morphik:8000")
+
 # Or with authentication URI (for production)
 # db = Morphik("morphik://owner_id:token@api.morphik.ai")
 
@@ -96,9 +99,18 @@ print(response.completion)
 # Create a nested folder (parents are auto-created server-side)
 folder = db.create_folder(full_path="/projects/alpha/specs", description="Specs folder")
 
+# Move or rename folder paths
+moved = db.move_folder("/projects/alpha/specs", "/projects/archive/specs")
+renamed = moved.rename("specs-v2")
+
 # Scope queries to a path and include descendants with folder_depth=-1
 chunks = folder.retrieve_chunks(query="design notes", folder_depth=-1)
 docs = db.list_documents(folder_name="/projects/alpha", folder_depth=-1)
+
+# List only the fields you need. The server reads and returns just those columns, so
+# the full document text is never downloaded — fast for large corpora.
+for doc in db.list_documents(fields=["metadata"]).documents:
+    print(doc.external_id, doc.metadata)
 ```
 
 `Folder.full_path` is exposed on folder objects, and `Document.folder_path` mirrors server responses for tracing scope.
@@ -113,6 +125,9 @@ async def main():
     # Initialize async client - connects to localhost:8000 by default
     async with AsyncMorphik() as db:
 
+    # You can also use a direct HTTP(S) base URL for self-hosted deployments
+    # async with AsyncMorphik("http://morphik:8000") as db:
+
     # Or with authentication URI (for production)
     # async with AsyncMorphik("morphik://owner_id:token@api.morphik.ai") as db:
         # Ingest a text document

{morphik-1.2.1 → morphik-1.2.3}/README.md

@@ -39,6 +39,9 @@ from morphik import Morphik
 # Initialize client - connects to localhost:8000 by default
 db = Morphik()
 
+# You can also use a direct HTTP(S) base URL for self-hosted deployments
+# db = Morphik("http://morphik:8000")
+
 # Or with authentication URI (for production)
 # db = Morphik("morphik://owner_id:token@api.morphik.ai")
 
@@ -83,9 +86,18 @@ print(response.completion)
 # Create a nested folder (parents are auto-created server-side)
 folder = db.create_folder(full_path="/projects/alpha/specs", description="Specs folder")
 
+# Move or rename folder paths
+moved = db.move_folder("/projects/alpha/specs", "/projects/archive/specs")
+renamed = moved.rename("specs-v2")
+
 # Scope queries to a path and include descendants with folder_depth=-1
 chunks = folder.retrieve_chunks(query="design notes", folder_depth=-1)
 docs = db.list_documents(folder_name="/projects/alpha", folder_depth=-1)
+
+# List only the fields you need. The server reads and returns just those columns, so
+# the full document text is never downloaded — fast for large corpora.
+for doc in db.list_documents(fields=["metadata"]).documents:
+    print(doc.external_id, doc.metadata)
 ```
 
 `Folder.full_path` is exposed on folder objects, and `Document.folder_path` mirrors server responses for tracing scope.
@@ -100,6 +112,9 @@ async def main():
     # Initialize async client - connects to localhost:8000 by default
     async with AsyncMorphik() as db:
 
+    # You can also use a direct HTTP(S) base URL for self-hosted deployments
+    # async with AsyncMorphik("http://morphik:8000") as db:
+
     # Or with authentication URI (for production)
     # async with AsyncMorphik("morphik://owner_id:token@api.morphik.ai") as db:
         # Ingest a text document

{morphik-1.2.1 → morphik-1.2.3}/morphik/__init__.py

@@ -14,4 +14,4 @@ __all__ = [
     "DocumentQueryResponse",
 ]
 
-__version__ = "1.2.1"
+__version__ = "1.2.3"

{morphik-1.2.1 → morphik-1.2.3}/morphik/_internal.py

@@ -64,12 +64,31 @@ class _MorphikClientLogic:
         if not parsed.netloc:
             raise ValueError("Invalid URI format")
 
+        # Allow direct HTTP(S) endpoints without auth token for self-hosted usage.
+        if parsed.scheme in {"http", "https"}:
+            path_prefix = (parsed.path or "").rstrip("/")
+            self._base_url = f"{parsed.scheme}://{parsed.netloc}{path_prefix}".rstrip("/")
+            self._auth_token = None
+            if parsed.hostname in {"localhost", "127.0.0.1", "0.0.0.0", "host.docker.internal"}:
+                self._is_local = True
+            return
+
+        if parsed.scheme != "morphik":
+            raise ValueError("Invalid URI format")
+        if "@" not in parsed.netloc:
+            raise ValueError("Invalid Morphik URI format. Expected morphik://<owner_id>:<token>@<host>")
+
         # Split host and auth parts
-        auth, host = parsed.netloc.split("@")
-        _, self._auth_token = auth.split(":")
+        auth, host = parsed.netloc.rsplit("@", 1)
+        if ":" not in auth:
+            raise ValueError("Invalid Morphik URI auth format. Expected <owner_id>:<token>")
+        _, self._auth_token = auth.split(":", 1)
+
+        if parsed.hostname in {"localhost", "127.0.0.1", "0.0.0.0", "host.docker.internal"}:
+            self._is_local = True
 
         # Set base URL
-        self._base_url = f"{'http' if self._is_local else 'https'}://{host}"
+        self._base_url = f"{'http' if self._is_local else 'https'}://{host}".rstrip("/")
 
         # Basic token validation
         jwt.decode(self._auth_token, options={"verify_signature": False})
@@ -409,6 +428,7 @@ class _MorphikClientLogic:
         completed_only: bool,
         sort_by: Optional[str],
         sort_direction: str,
+        fields: Optional[List[str]] = None,
     ) -> Tuple[Dict[str, Any], Dict[str, Any]]:
         """Prepare request for list_docs endpoint"""
         params = {}
@@ -431,6 +451,15 @@ class _MorphikClientLogic:
             "sort_by": sort_by,
             "sort_direction": sort_direction,
         }
+        if fields:
+            # Always include the fields required to reconstruct a Document client-side, so
+            # projected responses still parse into Document objects. When any metadata field
+            # is requested, also pull metadata_types so typed values (datetime/date/decimal)
+            # are reconstructed instead of returned as raw strings.
+            projected = ["external_id", "content_type", *fields]
+            if any(field.split(".", 1)[0] == "metadata" for field in fields):
+                projected.append("metadata_types")
+            data["fields"] = list(dict.fromkeys(projected))
         return params, data
 
     def _prepare_batch_get_documents_request(

{morphik-1.2.1 → morphik-1.2.3}/morphik/_scoped_ops.py

@@ -277,6 +277,7 @@ class _ScopedOperationsMixin:
         completed_only: bool,
         sort_by: Optional[str],
         sort_direction: str,
+        fields: Optional[List[str]] = None,
     ):
         params, data = self._logic._prepare_list_documents_request(
             skip,
@@ -291,6 +292,7 @@ class _ScopedOperationsMixin:
             completed_only,
             sort_by,
             sort_direction,
+            fields,
         )
 
         return self._execute_scoped_operation(

{morphik-1.2.1 → morphik-1.2.3}/morphik/_shared.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import json
 from pathlib import Path
 from typing import Any, Dict, Iterable, List, Optional, Union
+from urllib.parse import quote
 
 from pydantic import BaseModel
 
@@ -146,6 +147,43 @@ def build_document_by_filename_params(
     return params
 
 
+def normalize_folder_identifier(folder_id_or_name: str) -> str:
+    if not folder_id_or_name:
+        raise ValueError("folder_id_or_name is required")
+    normalized = folder_id_or_name.lstrip("/")
+    if not normalized:
+        raise ValueError("folder_id_or_name is required")
+    return normalized
+
+
+def build_folder_endpoint_identifier(folder_id_or_name: str) -> str:
+    normalized = normalize_folder_identifier(folder_id_or_name)
+    return quote(normalized, safe="/")
+
+
+def build_folder_move_payload(*, new_path: str) -> Dict[str, str]:
+    normalized_path = "/" + (new_path or "").strip("/")
+    if normalized_path == "/":
+        raise ValueError("new_path must include at least one non-root segment")
+    return {"new_path": normalized_path}
+
+
+def build_folder_rename_path(*, current_path: str, new_name: str) -> str:
+    normalized_name = (new_name or "").strip().strip("/")
+    if not normalized_name:
+        raise ValueError("new_name is required")
+    if "/" in normalized_name:
+        raise ValueError("new_name must be a single folder segment without '/'")
+
+    normalized_current = "/" + (current_path or "").strip("/")
+    segments = [segment for segment in normalized_current.split("/") if segment]
+    if not segments:
+        raise ValueError("current_path must include at least one non-root segment")
+
+    segments[-1] = normalized_name
+    return "/" + "/".join(segments)
+
+
 def normalize_additional_folders(
     additional_folders: Optional[List[str]],
     folder_name: Optional[Union[str, List[str]]],

{morphik-1.2.1 → morphik-1.2.3}/morphik/async_.py

@@ -14,6 +14,9 @@ from ._scoped_ops import _ScopedOperationsMixin
 from ._shared import (
     build_create_app_payload,
     build_document_by_filename_params,
+    build_folder_endpoint_identifier,
+    build_folder_move_payload,
+    build_folder_rename_path,
     build_list_apps_params,
     build_logs_params,
     build_rename_app_params,
@@ -264,8 +267,15 @@ class _AsyncScopedClientOps:
         completed_only: bool = False,
         sort_by: Optional[str] = "updated_at",
         sort_direction: str = "desc",
+        fields: Optional[List[str]] = None,
     ) -> ListDocsResponse:
-        """List documents within this scope (async)."""
+        """List documents within this scope (async).
+
+        Args:
+            fields: Optional list of fields to return for each document (e.g. ["metadata"]).
+                Only those fields are read and returned, so the full document text is never
+                downloaded. external_id and content_type are always included.
+        """
         effective_folder = self._merge_folders(additional_folders)
         return await self._client._scoped_list_documents(
             skip=skip,
@@ -280,6 +290,7 @@ class _AsyncScopedClientOps:
             completed_only=completed_only,
             sort_by=sort_by,
             sort_direction=sort_direction,
+            fields=fields,
         )
 
     async def batch_get_documents(
@@ -416,6 +427,15 @@ class AsyncFolder(_AsyncScopedClientOps):
         """Returns the folder ID if available."""
         return self._id
 
+    def _sync_from_folder(self, folder: "AsyncFolder") -> None:
+        self._id = folder.id or self._id
+        self._name = folder.name
+        self._full_path = folder.full_path
+        self._parent_id = folder.parent_id
+        self._depth = folder.depth
+        self._child_count = folder.child_count
+        self._description = folder.description
+
     async def get_info(self) -> Dict[str, Any]:
         """
         Get detailed information about this folder.
@@ -446,6 +466,24 @@ class AsyncFolder(_AsyncScopedClientOps):
         self._description = info.description or self._description
         return info
 
+    async def move(self, new_path: str) -> "AsyncFolder":
+        """Move this folder to a new canonical path and refresh local metadata."""
+        identifier = self._id or self.full_path
+        if not identifier:
+            raise ValueError("Folder identifier is missing")
+        moved = await self._client.move_folder(identifier, new_path)
+        self._sync_from_folder(moved)
+        return moved
+
+    async def rename(self, new_name: str) -> "AsyncFolder":
+        """Rename this folder (leaf segment only) and refresh local metadata."""
+        identifier = self._id or self.full_path
+        if not identifier:
+            raise ValueError("Folder identifier is missing")
+        renamed = await self._client.rename_folder(identifier, new_name)
+        self._sync_from_folder(renamed)
+        return renamed
+
     async def get_summary(self) -> Summary:
         """Retrieve the latest summary for this folder."""
         identifier = self._id or self.full_path
@@ -698,6 +736,50 @@ class AsyncMorphik(_ScopedOperationsMixin):
         response = await self._request("DELETE", f"folders/{folder_id_or_name}")
         return response
 
+    async def move_folder(self, folder_id_or_name: str, new_path: str) -> AsyncFolder:
+        """
+        Move and/or rename a folder by setting its new canonical path.
+
+        Args:
+            folder_id_or_name: Folder ID, name, or full path
+            new_path: Target full path (e.g. "/projects/archive/specs")
+
+        Returns:
+            AsyncFolder: Updated folder metadata
+        """
+        folder_param = build_folder_endpoint_identifier(folder_id_or_name)
+        payload = build_folder_move_payload(new_path=new_path)
+        response = await self._request("POST", f"folders/{folder_param}/move", data=payload)
+        info = FolderInfo(**response)
+        return AsyncFolder(
+            self,
+            info.name,
+            folder_id=info.id,
+            full_path=info.full_path,
+            parent_id=info.parent_id,
+            depth=info.depth,
+            child_count=info.child_count,
+            description=info.description,
+        )
+
+    async def rename_folder(self, folder_id_or_name: str, new_name: str) -> AsyncFolder:
+        """
+        Rename a folder by changing only its leaf segment.
+
+        Args:
+            folder_id_or_name: Folder ID, name, or full path
+            new_name: New folder name (single segment, no '/')
+
+        Returns:
+            AsyncFolder: Updated folder metadata
+        """
+        folder_param = build_folder_endpoint_identifier(folder_id_or_name)
+        current_info = FolderInfo(**(await self._request("GET", f"folders/{folder_param}")))
+        current_path = current_info.full_path or current_info.name
+        new_path = build_folder_rename_path(current_path=current_path, new_name=new_name)
+        move_identifier = current_info.id or folder_param
+        return await self.move_folder(move_identifier, new_path)
+
     async def get_folder_summary(self, folder_id_or_path: str) -> Summary:
         """Get the persisted summary for a folder."""
         folder_param = folder_id_or_path.lstrip("/") if folder_id_or_path else folder_id_or_path
@@ -1157,6 +1239,7 @@ class AsyncMorphik(_ScopedOperationsMixin):
         completed_only: bool = False,
         sort_by: Optional[str] = "updated_at",
         sort_direction: str = "desc",
+        fields: Optional[List[str]] = None,
     ) -> ListDocsResponse:
         """
         List accessible documents.
@@ -1173,6 +1256,9 @@ class AsyncMorphik(_ScopedOperationsMixin):
             completed_only: Only return completed documents
             sort_by: Field to sort by (created_at, updated_at, filename, external_id)
             sort_direction: Sort direction (asc, desc)
+            fields: Optional list of fields to return for each document (e.g. ["metadata"]).
+                Only those fields are read and returned, so the full document text is never
+                downloaded. external_id and content_type are always included.
         Returns:
             ListDocsResponse: Response with documents and metadata
 
@@ -1190,6 +1276,7 @@ class AsyncMorphik(_ScopedOperationsMixin):
             completed_only=completed_only,
             sort_by=sort_by,
             sort_direction=sort_direction,
+            fields=fields,
         )
 
     async def get_document(self, document_id: str) -> Document:

{morphik-1.2.1 → morphik-1.2.3}/morphik/sync.py

@@ -14,6 +14,9 @@ from ._scoped_ops import _ScopedOperationsMixin
 from ._shared import (
     build_create_app_payload,
     build_document_by_filename_params,
+    build_folder_endpoint_identifier,
+    build_folder_move_payload,
+    build_folder_rename_path,
     build_list_apps_params,
     build_logs_params,
     build_rename_app_params,
@@ -280,9 +283,16 @@ class _ScopedClientOps:
         completed_only: bool = False,
         sort_by: Optional[str] = "updated_at",
         sort_direction: str = "desc",
+        fields: Optional[List[str]] = None,
     ) -> ListDocsResponse:
         """
         List documents within this scope.
+
+        Args:
+            fields: Optional list of fields to return for each document (e.g.
+                ["metadata"]). Only those fields are read and returned, so the full
+                document text is never downloaded. external_id and content_type are
+                always included.
         """
         effective_folder = self._merge_folders(additional_folders)
         return self._client._scoped_list_documents(
@@ -298,6 +308,7 @@ class _ScopedClientOps:
             completed_only=completed_only,
             sort_by=sort_by,
             sort_direction=sort_direction,
+            fields=fields,
         )
 
     def batch_get_documents(
@@ -442,6 +453,15 @@ class Folder(_ScopedClientOps):
         """Returns the folder ID if available."""
         return self._id
 
+    def _sync_from_folder(self, folder: "Folder") -> None:
+        self._id = folder.id or self._id
+        self._name = folder.name
+        self._full_path = folder.full_path
+        self._parent_id = folder.parent_id
+        self._depth = folder.depth
+        self._child_count = folder.child_count
+        self._description = folder.description
+
     def get_info(self) -> Dict[str, Any]:
         """
         Get detailed information about this folder.
@@ -473,6 +493,24 @@ class Folder(_ScopedClientOps):
         self._description = info.description or self._description
         return info
 
+    def move(self, new_path: str) -> "Folder":
+        """Move this folder to a new canonical path and refresh local metadata."""
+        identifier = self._id or self.full_path
+        if not identifier:
+            raise ValueError("Folder identifier is missing")
+        moved = self._client.move_folder(identifier, new_path)
+        self._sync_from_folder(moved)
+        return moved
+
+    def rename(self, new_name: str) -> "Folder":
+        """Rename this folder (leaf segment only) and refresh local metadata."""
+        identifier = self._id or self.full_path
+        if not identifier:
+            raise ValueError("Folder identifier is missing")
+        renamed = self._client.rename_folder(identifier, new_name)
+        self._sync_from_folder(renamed)
+        return renamed
+
     def get_summary(self) -> Summary:
         """Retrieve the latest summary for this folder."""
         identifier = self._id or self.full_path
@@ -729,6 +767,50 @@ class Morphik(_ScopedOperationsMixin):
         response = self._request("DELETE", f"folders/{folder_id_or_name}")
         return response
 
+    def move_folder(self, folder_id_or_name: str, new_path: str) -> Folder:
+        """
+        Move and/or rename a folder by setting its new canonical path.
+
+        Args:
+            folder_id_or_name: Folder ID, name, or full path
+            new_path: Target full path (e.g. "/projects/archive/specs")
+
+        Returns:
+            Folder: Updated folder metadata
+        """
+        folder_param = build_folder_endpoint_identifier(folder_id_or_name)
+        payload = build_folder_move_payload(new_path=new_path)
+        response = self._request("POST", f"folders/{folder_param}/move", data=payload)
+        info = FolderInfo(**response)
+        return Folder(
+            self,
+            info.name,
+            folder_id=info.id,
+            full_path=info.full_path,
+            parent_id=info.parent_id,
+            depth=info.depth,
+            child_count=info.child_count,
+            description=info.description,
+        )
+
+    def rename_folder(self, folder_id_or_name: str, new_name: str) -> Folder:
+        """
+        Rename a folder by changing only its leaf segment.
+
+        Args:
+            folder_id_or_name: Folder ID, name, or full path
+            new_name: New folder name (single segment, no '/')
+
+        Returns:
+            Folder: Updated folder metadata
+        """
+        folder_param = build_folder_endpoint_identifier(folder_id_or_name)
+        current_info = FolderInfo(**self._request("GET", f"folders/{folder_param}"))
+        current_path = current_info.full_path or current_info.name
+        new_path = build_folder_rename_path(current_path=current_path, new_name=new_name)
+        move_identifier = current_info.id or folder_param
+        return self.move_folder(move_identifier, new_path)
+
     def get_folder_summary(self, folder_id_or_path: str) -> Summary:
         """Get the persisted summary for a folder."""
         folder_param = folder_id_or_path.lstrip("/") if folder_id_or_path else folder_id_or_path
@@ -1196,6 +1278,7 @@ class Morphik(_ScopedOperationsMixin):
         completed_only: bool = False,
         sort_by: Optional[str] = "updated_at",
         sort_direction: str = "desc",
+        fields: Optional[List[str]] = None,
     ) -> ListDocsResponse:
         """
         List accessible documents.
@@ -1212,6 +1295,9 @@ class Morphik(_ScopedOperationsMixin):
             completed_only: Only return completed documents
             sort_by: Field to sort by (created_at, updated_at, filename, external_id)
             sort_direction: Sort direction (asc, desc)
+            fields: Optional list of fields to return for each document (e.g. ["metadata"]).
+                Only those fields are read and returned, so the full document text is never
+                downloaded. external_id and content_type are always included.
         Returns:
             ListDocsResponse: Response with documents and metadata
 
@@ -1229,6 +1315,7 @@ class Morphik(_ScopedOperationsMixin):
             completed_only=completed_only,
             sort_by=sort_by,
             sort_direction=sort_direction,
+            fields=fields,
         )
 
     def get_document(self, document_id: str) -> Document:

{morphik-1.2.1 → morphik-1.2.3}/morphik/tests/test_async.py

@@ -36,8 +36,9 @@ class TestAsyncMorphik:
     @pytest.fixture
     async def db(self):
         """Create an AsyncMorphik client for testing"""
-        # Connects to localhost:8000 by default, increase timeout
-        client = AsyncMorphik(timeout=120)
+        # Use dedicated test URI when provided; otherwise default localhost behavior
+        uri = os.environ.get("MORPHIK_TEST_URI")
+        client = AsyncMorphik(uri=uri, timeout=120) if uri else AsyncMorphik(timeout=120)
         yield client
         await client.close()
 
@@ -150,6 +151,79 @@ class TestAsyncMorphik:
 
         # TODO: Add folder deletion when API supports it
 
+    @pytest.mark.asyncio
+    async def test_direct_http_uri_ping(self):
+        """Test direct HTTP base URL initialization and connectivity (async)."""
+        uri = os.environ.get("MORPHIK_TEST_URI", "http://localhost:8000")
+        client = AsyncMorphik(uri, timeout=30)
+        try:
+            response = await client.ping()
+            assert response.get("status") == "ok"
+        finally:
+            await client.close()
+
+    @pytest.mark.asyncio
+    async def test_move_and_rename_folder(self, db):
+        """Test moving and renaming folders via async client-level APIs."""
+        suffix = uuid.uuid4().hex[:8]
+        original_path = f"/it_async_{suffix}/leaf"
+        moved_path = f"/it_async_moved_{suffix}/leaf"
+        renamed_leaf = f"leaf_renamed_{suffix}"
+        expected_renamed_path = f"/it_async_moved_{suffix}/{renamed_leaf}"
+
+        folder = await db.create_folder(
+            name=f"leaf_{suffix}",
+            full_path=original_path,
+            description="integration move test",
+        )
+
+        moved = None
+        renamed = None
+        try:
+            moved = await db.move_folder(folder.id or original_path, moved_path)
+            assert moved.id == folder.id
+            assert moved.full_path == moved_path
+            assert moved.name == "leaf"
+
+            fetched_moved = await db.get_folder(moved.id or moved_path)
+            assert fetched_moved.full_path == moved_path
+
+            renamed = await db.rename_folder(moved.id or moved_path, renamed_leaf)
+            assert renamed.id == folder.id
+            assert renamed.name == renamed_leaf
+            assert renamed.full_path == expected_renamed_path
+
+            fetched_renamed = await db.get_folder(renamed.id or expected_renamed_path)
+            assert fetched_renamed.full_path == expected_renamed_path
+        finally:
+            target = renamed or moved or folder
+            if target and target.id:
+                await db.delete_folder(target.id)
+
+    @pytest.mark.asyncio
+    async def test_folder_object_move_and_rename(self, db):
+        """Test AsyncFolder convenience move/rename methods keep local metadata in sync."""
+        suffix = uuid.uuid4().hex[:8]
+        original_path = f"/it_async_obj_{suffix}/leaf"
+        moved_path = f"/it_async_obj_moved_{suffix}/leaf"
+        renamed_leaf = f"leaf_obj_renamed_{suffix}"
+        expected_renamed_path = f"/it_async_obj_moved_{suffix}/{renamed_leaf}"
+
+        folder = await db.create_folder(name=f"leaf_obj_{suffix}", full_path=original_path)
+        try:
+            moved = await folder.move(moved_path)
+            assert moved.full_path == moved_path
+            assert folder.full_path == moved_path
+
+            renamed = await folder.rename(renamed_leaf)
+            assert renamed.full_path == expected_renamed_path
+            assert renamed.name == renamed_leaf
+            assert folder.full_path == expected_renamed_path
+            assert folder.name == renamed_leaf
+        finally:
+            if folder.id:
+                await db.delete_folder(folder.id)
+
     @pytest.mark.asyncio
     async def test_user_scope(self, db):
         """Test user scoped operations"""

{morphik-1.2.1 → morphik-1.2.3}/morphik/tests/test_scoped_ops_unit.py

@@ -1,4 +1,5 @@
 import httpx
+import jwt
 import pytest
 from morphik.async_ import AsyncMorphik
 from morphik.sync import Folder, Morphik
@@ -116,6 +117,39 @@ def test_sync_list_documents_payloads_across_scopes():
         client.close()
 
 
+def test_sync_list_documents_fields_projection():
+    client, calls = _make_sync_client()
+    try:
+        # external_id + content_type are always added so the response parses into a Document;
+        # metadata_types is added so typed metadata values are reconstructed, not left as strings.
+        client.list_documents(fields=["metadata"])
+        assert calls.pop()["data"]["fields"] == ["external_id", "content_type", "metadata", "metadata_types"]
+
+        # Already-included required fields are not duplicated; order is preserved.
+        client.list_documents(fields=["external_id", "filename", "metadata"])
+        assert calls.pop()["data"]["fields"] == [
+            "external_id",
+            "content_type",
+            "filename",
+            "metadata",
+            "metadata_types",
+        ]
+
+        # Nested metadata paths also trigger metadata_types.
+        client.list_documents(fields=["metadata.client"])
+        assert calls.pop()["data"]["fields"] == ["external_id", "content_type", "metadata.client", "metadata_types"]
+
+        # Non-metadata projection does not pull metadata_types.
+        client.list_documents(fields=["filename"])
+        assert calls.pop()["data"]["fields"] == ["external_id", "content_type", "filename"]
+
+        # No fields -> no projection requested (full documents).
+        client.list_documents()
+        assert "fields" not in calls.pop()["data"]
+    finally:
+        client.close()
+
+
 def test_async_client_http2_toggle(monkeypatch):
     captured = []
 
@@ -160,6 +194,56 @@ def test_sync_client_http2_toggle(monkeypatch):
     assert captured[-1] is False
 
 
+def test_sync_client_accepts_plain_http_uri_without_auth():
+    client = Morphik("http://0.0.0.0:8000")
+    try:
+        assert client._logic._base_url == "http://0.0.0.0:8000"
+        assert client._logic._auth_token is None
+        assert client._logic._is_local is True
+    finally:
+        client.close()
+
+
+def test_sync_client_preserves_http_path_prefix():
+    client = Morphik("https://api.example.com/morphik/v1/")
+    try:
+        assert client._logic._base_url == "https://api.example.com/morphik/v1"
+        assert client._logic._get_url("ping") == "https://api.example.com/morphik/v1/ping"
+    finally:
+        client.close()
+
+
+def test_sync_client_parses_morphik_uri_with_token():
+    token = jwt.encode({"sub": "test-user"}, "test-secret", algorithm="HS256")
+    client = Morphik(f"morphik://owner:{token}@api.morphik.ai")
+    try:
+        assert client._logic._base_url == "https://api.morphik.ai"
+        assert client._logic._auth_token == token
+    finally:
+        client.close()
+
+
+@pytest.mark.asyncio
+async def test_async_client_accepts_plain_http_uri_without_auth():
+    client = AsyncMorphik("http://0.0.0.0:8000")
+    try:
+        assert client._logic._base_url == "http://0.0.0.0:8000"
+        assert client._logic._auth_token is None
+        assert client._logic._is_local is True
+    finally:
+        await client.close()
+
+
+@pytest.mark.asyncio
+async def test_async_client_preserves_http_path_prefix():
+    client = AsyncMorphik("https://api.example.com/morphik/v1/")
+    try:
+        assert client._logic._base_url == "https://api.example.com/morphik/v1"
+        assert client._logic._get_url("ping") == "https://api.example.com/morphik/v1/ping"
+    finally:
+        await client.close()
+
+
 @pytest.mark.asyncio
 async def test_async_http2_fallback_on_remote_protocol_error(monkeypatch):
     created_http2 = []
@@ -492,6 +576,208 @@ def test_folder_hierarchy_properties():
         client.close()
 
 
+def test_sync_move_folder_calls_move_endpoint():
+    client, calls = _make_sync_client()
+    try:
+        original_request = client._request
+
+        def mock_request(method, endpoint, data=None, files=None, params=None):
+            calls.append({"method": method, "endpoint": endpoint, "data": data, "params": params})
+            if endpoint == "folders/folder-123/move":
+                return {
+                    "id": "folder-123",
+                    "name": "archived",
+                    "full_path": "/projects/archived",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "moved folder",
+                }
+            return original_request(method, endpoint, data, files, params)
+
+        client._request = mock_request
+
+        moved = client.move_folder("folder-123", "/projects/archived")
+        move_call = calls.pop()
+        assert move_call["method"] == "POST"
+        assert move_call["endpoint"] == "folders/folder-123/move"
+        assert move_call["data"] == {"new_path": "/projects/archived"}
+        assert moved.id == "folder-123"
+        assert moved.full_path == "/projects/archived"
+        assert moved.name == "archived"
+    finally:
+        client.close()
+
+
+def test_sync_move_folder_encodes_special_chars_in_identifier():
+    client, calls = _make_sync_client()
+    try:
+        original_request = client._request
+
+        def mock_request(method, endpoint, data=None, files=None, params=None):
+            calls.append({"method": method, "endpoint": endpoint, "data": data, "params": params})
+            if endpoint == "folders/team/a%231/move":
+                return {
+                    "id": "folder-123",
+                    "name": "a1",
+                    "full_path": "/team/a1",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "moved folder",
+                }
+            return original_request(method, endpoint, data, files, params)
+
+        client._request = mock_request
+
+        moved = client.move_folder("/team/a#1", "/team/a1")
+        move_call = calls.pop()
+        assert move_call["method"] == "POST"
+        assert move_call["endpoint"] == "folders/team/a%231/move"
+        assert move_call["data"] == {"new_path": "/team/a1"}
+        assert moved.full_path == "/team/a1"
+    finally:
+        client.close()
+
+
+def test_sync_rename_folder_derives_target_path_from_existing_folder():
+    client, calls = _make_sync_client()
+    try:
+        original_request = client._request
+
+        def mock_request(method, endpoint, data=None, files=None, params=None):
+            calls.append({"method": method, "endpoint": endpoint, "data": data, "params": params})
+            if method == "GET" and endpoint == "folders/folder-123":
+                return {
+                    "id": "folder-123",
+                    "name": "old-name",
+                    "full_path": "/team/old-name",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "original",
+                }
+            if method == "POST" and endpoint == "folders/folder-123/move":
+                return {
+                    "id": "folder-123",
+                    "name": "new-name",
+                    "full_path": "/team/new-name",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "renamed",
+                }
+            return original_request(method, endpoint, data, files, params)
+
+        client._request = mock_request
+
+        renamed = client.rename_folder("folder-123", "new-name")
+
+        get_call = calls[-2]
+        move_call = calls[-1]
+        assert get_call["method"] == "GET"
+        assert get_call["endpoint"] == "folders/folder-123"
+        assert move_call["method"] == "POST"
+        assert move_call["endpoint"] == "folders/folder-123/move"
+        assert move_call["data"] == {"new_path": "/team/new-name"}
+        assert renamed.name == "new-name"
+        assert renamed.full_path == "/team/new-name"
+    finally:
+        client.close()
+
+
+def test_sync_rename_folder_encodes_identifier_for_get_and_move():
+    client, calls = _make_sync_client()
+    try:
+        original_request = client._request
+
+        def mock_request(method, endpoint, data=None, files=None, params=None):
+            calls.append({"method": method, "endpoint": endpoint, "data": data, "params": params})
+            if method == "GET" and endpoint == "folders/team/a%231":
+                return {
+                    "id": "folder#123",
+                    "name": "a#1",
+                    "full_path": "/team/a#1",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "original",
+                }
+            if method == "POST" and endpoint == "folders/folder%23123/move":
+                return {
+                    "id": "folder#123",
+                    "name": "a-new",
+                    "full_path": "/team/a-new",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "renamed",
+                }
+            return original_request(method, endpoint, data, files, params)
+
+        client._request = mock_request
+
+        renamed = client.rename_folder("/team/a#1", "a-new")
+
+        get_call = calls[-2]
+        move_call = calls[-1]
+        assert get_call["method"] == "GET"
+        assert get_call["endpoint"] == "folders/team/a%231"
+        assert move_call["method"] == "POST"
+        assert move_call["endpoint"] == "folders/folder%23123/move"
+        assert move_call["data"] == {"new_path": "/team/a-new"}
+        assert renamed.full_path == "/team/a-new"
+    finally:
+        client.close()
+
+
+def test_sync_folder_move_and_rename_refresh_local_metadata():
+    client, _ = _make_sync_client()
+    try:
+        folder = Folder(client, "docs", folder_id="folder-123", full_path="/team/docs")
+
+        def mock_move(folder_id_or_name, new_path):
+            if new_path == "/archive/docs":
+                return Folder(
+                    client,
+                    "docs",
+                    folder_id="folder-123",
+                    full_path="/archive/docs",
+                    parent_id="parent-arch",
+                    depth=2,
+                    child_count=0,
+                    description="moved",
+                )
+            return Folder(
+                client,
+                "docs-v2",
+                folder_id="folder-123",
+                full_path="/archive/docs-v2",
+                parent_id="parent-arch",
+                depth=2,
+                child_count=0,
+                description="renamed",
+            )
+
+        client.move_folder = mock_move  # type: ignore[method-assign]
+        client.rename_folder = lambda folder_id_or_name, new_name: mock_move(  # type: ignore[method-assign]
+            folder_id_or_name, "/archive/docs-v2"
+        )
+
+        moved = folder.move("/archive/docs")
+        assert moved.full_path == "/archive/docs"
+        assert folder.full_path == "/archive/docs"
+        assert folder.parent_id == "parent-arch"
+
+        renamed = folder.rename("docs-v2")
+        assert renamed.name == "docs-v2"
+        assert renamed.full_path == "/archive/docs-v2"
+        assert folder.name == "docs-v2"
+        assert folder.full_path == "/archive/docs-v2"
+    finally:
+        client.close()
+
+
 def test_folder_uses_full_path_for_operations():
     """Test that Folder operations use full_path instead of name."""
     client, calls = _make_sync_client()
@@ -680,6 +966,215 @@ async def test_async_folder_hierarchy_properties():
         await client.close()
 
 
+@pytest.mark.asyncio
+async def test_async_move_folder_calls_move_endpoint():
+    client, calls = await _make_async_client()
+    try:
+        original_request = client._request
+
+        async def mock_request(method, endpoint, data=None, files=None, params=None):
+            calls.append({"method": method, "endpoint": endpoint, "data": data, "params": params})
+            if endpoint == "folders/folder-123/move":
+                return {
+                    "id": "folder-123",
+                    "name": "archived",
+                    "full_path": "/projects/archived",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "moved folder",
+                }
+            return await original_request(method, endpoint, data, files, params)
+
+        client._request = mock_request
+
+        moved = await client.move_folder("folder-123", "/projects/archived")
+        move_call = calls.pop()
+        assert move_call["method"] == "POST"
+        assert move_call["endpoint"] == "folders/folder-123/move"
+        assert move_call["data"] == {"new_path": "/projects/archived"}
+        assert moved.id == "folder-123"
+        assert moved.full_path == "/projects/archived"
+        assert moved.name == "archived"
+    finally:
+        await client.close()
+
+
+@pytest.mark.asyncio
+async def test_async_move_folder_encodes_special_chars_in_identifier():
+    client, calls = await _make_async_client()
+    try:
+        original_request = client._request
+
+        async def mock_request(method, endpoint, data=None, files=None, params=None):
+            calls.append({"method": method, "endpoint": endpoint, "data": data, "params": params})
+            if endpoint == "folders/team/a%231/move":
+                return {
+                    "id": "folder-123",
+                    "name": "a1",
+                    "full_path": "/team/a1",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "moved folder",
+                }
+            return await original_request(method, endpoint, data, files, params)
+
+        client._request = mock_request
+
+        moved = await client.move_folder("/team/a#1", "/team/a1")
+        move_call = calls.pop()
+        assert move_call["method"] == "POST"
+        assert move_call["endpoint"] == "folders/team/a%231/move"
+        assert move_call["data"] == {"new_path": "/team/a1"}
+        assert moved.full_path == "/team/a1"
+    finally:
+        await client.close()
+
+
+@pytest.mark.asyncio
+async def test_async_rename_folder_derives_target_path_from_existing_folder():
+    client, calls = await _make_async_client()
+    try:
+        original_request = client._request
+
+        async def mock_request(method, endpoint, data=None, files=None, params=None):
+            calls.append({"method": method, "endpoint": endpoint, "data": data, "params": params})
+            if method == "GET" and endpoint == "folders/folder-123":
+                return {
+                    "id": "folder-123",
+                    "name": "old-name",
+                    "full_path": "/team/old-name",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "original",
+                }
+            if method == "POST" and endpoint == "folders/folder-123/move":
+                return {
+                    "id": "folder-123",
+                    "name": "new-name",
+                    "full_path": "/team/new-name",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "renamed",
+                }
+            return await original_request(method, endpoint, data, files, params)
+
+        client._request = mock_request
+
+        renamed = await client.rename_folder("folder-123", "new-name")
+        get_call = calls[-2]
+        move_call = calls[-1]
+        assert get_call["method"] == "GET"
+        assert get_call["endpoint"] == "folders/folder-123"
+        assert move_call["method"] == "POST"
+        assert move_call["endpoint"] == "folders/folder-123/move"
+        assert move_call["data"] == {"new_path": "/team/new-name"}
+        assert renamed.name == "new-name"
+        assert renamed.full_path == "/team/new-name"
+    finally:
+        await client.close()
+
+
+@pytest.mark.asyncio
+async def test_async_rename_folder_encodes_identifier_for_get_and_move():
+    client, calls = await _make_async_client()
+    try:
+        original_request = client._request
+
+        async def mock_request(method, endpoint, data=None, files=None, params=None):
+            calls.append({"method": method, "endpoint": endpoint, "data": data, "params": params})
+            if method == "GET" and endpoint == "folders/team/a%231":
+                return {
+                    "id": "folder#123",
+                    "name": "a#1",
+                    "full_path": "/team/a#1",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "original",
+                }
+            if method == "POST" and endpoint == "folders/folder%23123/move":
+                return {
+                    "id": "folder#123",
+                    "name": "a-new",
+                    "full_path": "/team/a-new",
+                    "parent_id": "parent-1",
+                    "depth": 2,
+                    "child_count": 0,
+                    "description": "renamed",
+                }
+            return await original_request(method, endpoint, data, files, params)
+
+        client._request = mock_request
+
+        renamed = await client.rename_folder("/team/a#1", "a-new")
+        get_call = calls[-2]
+        move_call = calls[-1]
+        assert get_call["method"] == "GET"
+        assert get_call["endpoint"] == "folders/team/a%231"
+        assert move_call["method"] == "POST"
+        assert move_call["endpoint"] == "folders/folder%23123/move"
+        assert move_call["data"] == {"new_path": "/team/a-new"}
+        assert renamed.full_path == "/team/a-new"
+    finally:
+        await client.close()
+
+
+@pytest.mark.asyncio
+async def test_async_folder_move_and_rename_refresh_local_metadata():
+    from morphik.async_ import AsyncFolder
+
+    client, _ = await _make_async_client()
+    try:
+        folder = AsyncFolder(client, "docs", folder_id="folder-123", full_path="/team/docs")
+
+        async def mock_move(folder_id_or_name, new_path):
+            if new_path == "/archive/docs":
+                return AsyncFolder(
+                    client,
+                    "docs",
+                    folder_id="folder-123",
+                    full_path="/archive/docs",
+                    parent_id="parent-arch",
+                    depth=2,
+                    child_count=0,
+                    description="moved",
+                )
+            return AsyncFolder(
+                client,
+                "docs-v2",
+                folder_id="folder-123",
+                full_path="/archive/docs-v2",
+                parent_id="parent-arch",
+                depth=2,
+                child_count=0,
+                description="renamed",
+            )
+
+        client.move_folder = mock_move  # type: ignore[method-assign]
+
+        async def mock_rename(folder_id_or_name, new_name):
+            return await mock_move(folder_id_or_name, "/archive/docs-v2")
+
+        client.rename_folder = mock_rename  # type: ignore[method-assign]
+
+        moved = await folder.move("/archive/docs")
+        assert moved.full_path == "/archive/docs"
+        assert folder.full_path == "/archive/docs"
+        assert folder.parent_id == "parent-arch"
+
+        renamed = await folder.rename("docs-v2")
+        assert renamed.name == "docs-v2"
+        assert renamed.full_path == "/archive/docs-v2"
+        assert folder.name == "docs-v2"
+        assert folder.full_path == "/archive/docs-v2"
+    finally:
+        await client.close()
+
+
 @pytest.mark.asyncio
 async def test_async_folder_uses_full_path():
     """Test that AsyncFolder operations use full_path."""

{morphik-1.2.1 → morphik-1.2.3}/morphik/tests/test_sync.py

@@ -36,8 +36,9 @@ class TestMorphik:
     @pytest.fixture
     def db(self):
         """Create a Morphik client for testing"""
-        # Connects to localhost:8000 by default, increase timeout for query tests
-        client = Morphik(timeout=120)
+        # Use dedicated test URI when provided; otherwise default localhost behavior
+        uri = os.environ.get("MORPHIK_TEST_URI")
+        client = Morphik(uri=uri, timeout=120) if uri else Morphik(timeout=120)
         yield client
         client.close()
 
@@ -146,6 +147,72 @@ class TestMorphik:
 
         # TODO: Add folder deletion when API supports it
 
+    def test_direct_http_uri_ping(self):
+        """Test direct HTTP base URL initialization and connectivity."""
+        uri = os.environ.get("MORPHIK_TEST_URI", "http://localhost:8000")
+        client = Morphik(uri, timeout=30)
+        try:
+            response = client.ping()
+            assert response.get("status") == "ok"
+        finally:
+            client.close()
+
+    def test_move_and_rename_folder(self, db):
+        """Test moving and renaming folders via client-level APIs."""
+        suffix = uuid.uuid4().hex[:8]
+        original_path = f"/it_sync_{suffix}/leaf"
+        moved_path = f"/it_sync_moved_{suffix}/leaf"
+        renamed_leaf = f"leaf_renamed_{suffix}"
+        expected_renamed_path = f"/it_sync_moved_{suffix}/{renamed_leaf}"
+
+        folder = db.create_folder(name=f"leaf_{suffix}", full_path=original_path, description="integration move test")
+
+        moved = None
+        renamed = None
+        try:
+            moved = db.move_folder(folder.id or original_path, moved_path)
+            assert moved.id == folder.id
+            assert moved.full_path == moved_path
+            assert moved.name == "leaf"
+
+            fetched_moved = db.get_folder(moved.id or moved_path)
+            assert fetched_moved.full_path == moved_path
+
+            renamed = db.rename_folder(moved.id or moved_path, renamed_leaf)
+            assert renamed.id == folder.id
+            assert renamed.name == renamed_leaf
+            assert renamed.full_path == expected_renamed_path
+
+            fetched_renamed = db.get_folder(renamed.id or expected_renamed_path)
+            assert fetched_renamed.full_path == expected_renamed_path
+        finally:
+            target = renamed or moved or folder
+            if target and target.id:
+                db.delete_folder(target.id)
+
+    def test_folder_object_move_and_rename(self, db):
+        """Test Folder convenience move/rename methods keep local metadata in sync."""
+        suffix = uuid.uuid4().hex[:8]
+        original_path = f"/it_sync_obj_{suffix}/leaf"
+        moved_path = f"/it_sync_obj_moved_{suffix}/leaf"
+        renamed_leaf = f"leaf_obj_renamed_{suffix}"
+        expected_renamed_path = f"/it_sync_obj_moved_{suffix}/{renamed_leaf}"
+
+        folder = db.create_folder(name=f"leaf_obj_{suffix}", full_path=original_path)
+        try:
+            moved = folder.move(moved_path)
+            assert moved.full_path == moved_path
+            assert folder.full_path == moved_path
+
+            renamed = folder.rename(renamed_leaf)
+            assert renamed.full_path == expected_renamed_path
+            assert renamed.name == renamed_leaf
+            assert folder.full_path == expected_renamed_path
+            assert folder.name == renamed_leaf
+        finally:
+            if folder.id:
+                db.delete_folder(folder.id)
+
     def test_user_scope(self, db):
         """Test user scoped operations"""
         # Create a unique user ID

{morphik-1.2.1 → morphik-1.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "morphik"
-version = "1.2.1"
+version = "1.2.3"
 authors = [
     { name = "Morphik", email = "founders@morphik.ai" },
 ]