cosma-client 0.0.1.dev1__tar.gz

cosma_client-0.0.1.dev1/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.3
+Name: cosma-client
+Version: 0.0.1.dev1
+Summary: Cosma API client library
+Requires-Dist: niquests>=3.15.2
+Requires-Python: >=3.12

cosma_client-0.0.1.dev1/pyproject.toml

@@ -0,0 +1,10 @@
+[project]
+name = "cosma-client"
+version = "0.0.1.dev1"
+description = "Cosma API client library"
+requires-python = ">=3.12"
+dependencies = ["niquests>=3.15.2"]
+
+[build-system]
+requires = ["uv_build>=0.9.8,<0.10.0"]
+build-backend = "uv_build"

cosma_client-0.0.1.dev1/src/cosma_client/__init__.py

@@ -0,0 +1,24 @@
+"""
+Cosma Client - API client library for Cosma.
+"""
+
+from .client import Client
+from .sync import SyncClient
+from .models import Update, UpdateOpcode
+from .exceptions import (
+    CosmaClientError,
+    ConnectionError,
+    ServerNotRunningError,
+    APIError,
+)
+
+__all__ = [
+    "Client",
+    "SyncClient",
+    "Update",
+    "UpdateOpcode",
+    "CosmaClientError",
+    "ConnectionError",
+    "ServerNotRunningError",
+    "APIError",
+]

cosma_client-0.0.1.dev1/src/cosma_client/client.py

@@ -0,0 +1,349 @@
+import niquests
+import json
+from typing import Optional, Dict, Any, List, AsyncIterator
+from urllib.parse import urljoin
+
+from .models import Update, UpdateOpcode
+from .exceptions import ServerNotRunningError, APIError
+
+
+class Client:
+    """Async client for the Cosma API."""
+
+    session: niquests.AsyncSession
+    base_url: str
+
+    def __init__(self, base_url: str = "http://127.0.0.1:60534"):
+        self.session = niquests.AsyncSession()
+        self.base_url = base_url
+        self.session.headers.update({"Content-Type": "application/json"})
+
+    def _url(self, endpoint: str) -> str:
+        """Helper to build full URL"""
+        return urljoin(self.base_url, endpoint)
+
+    def _handle_response(self, response: niquests.Response) -> Dict[str, Any]:
+        """Handle response and raise on errors"""
+        response.raise_for_status()
+        return response.json()
+
+    # =========================================================================
+    # Index API
+    # =========================================================================
+
+    async def index_directory(self, directory_path: str) -> Dict[str, Any]:
+        """Index all files in a directory for searching"""
+        data = {"directory_path": directory_path}
+        try:
+            response = await self.session.post(
+                self._url("/api/index/directory"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def index_file(self, file_path: str) -> Dict[str, Any]:
+        """Index a single file"""
+        data = {"file_path": file_path}
+        try:
+            response = await self.session.post(
+                self._url("/api/index/file"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def index_status(self) -> Dict[str, Any]:
+        """Get the current status of indexing operations"""
+        try:
+            response = await self.session.get(self._url("/api/index/status"))
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    # =========================================================================
+    # Status API
+    # =========================================================================
+
+    async def status(self) -> Dict[str, Any]:
+        """Get the current status of the backend"""
+        try:
+            response = await self.session.get(self._url("/api/status"))
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    # =========================================================================
+    # Search API
+    # =========================================================================
+
+    async def search(
+        self,
+        query: str,
+        filters: Optional[Dict[str, Any]] = None,
+        limit: int = 50
+    ) -> Dict[str, Any]:
+        """Search for files based on a query string"""
+        data: Dict[str, Any] = {"query": query, "limit": limit}
+        if filters:
+            data["filters"] = filters
+
+        try:
+            response = await self.session.post(
+                self._url("/api/search/"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def search_by_keywords(
+        self,
+        keywords: List[str],
+        match_all: bool = False
+    ) -> Dict[str, Any]:
+        """Search for files by specific keywords"""
+        data = {"keywords": keywords, "match_all": match_all}
+        try:
+            response = await self.session.post(
+                self._url("/api/search/keywords"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def find_similar_files(
+        self,
+        file_id: int,
+        limit: int = 10
+    ) -> Dict[str, Any]:
+        """Find files similar to a given file"""
+        try:
+            response = await self.session.get(
+                self._url(f"/api/search/{file_id}/similar"),
+                params={"limit": limit}
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def autocomplete(self, q: str, limit: int = 10) -> Dict[str, Any]:
+        """Get autocomplete suggestions for search queries"""
+        try:
+            response = await self.session.get(
+                self._url("/api/search/autocomplete"),
+                params={"q": q, "limit": limit}
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    # =========================================================================
+    # Watch API
+    # =========================================================================
+
+    async def watch_directory(self, directory_path: str) -> Dict[str, Any]:
+        """Start watching a directory for changes"""
+        data = {"directory_path": directory_path}
+        try:
+            response = await self.session.post(
+                self._url("/api/watch/"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def get_watch_jobs(self) -> Dict[str, Any]:
+        """Get all watched directory jobs"""
+        try:
+            response = await self.session.get(self._url("/api/watch/jobs"))
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def delete_watch_job(self, job_id: int) -> Dict[str, Any]:
+        """Delete a watched directory job by ID"""
+        try:
+            response = await self.session.delete(
+                self._url(f"/api/watch/jobs/{job_id}")
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    # =========================================================================
+    # Files API
+    # =========================================================================
+
+    async def get_file(self, file_id: int) -> Dict[str, Any]:
+        """Get details of a specific file by ID"""
+        try:
+            response = await self.session.get(
+                self._url(f"/api/files/{file_id}")
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def get_file_stats(self) -> Dict[str, Any]:
+        """Get statistics about indexed files"""
+        try:
+            response = await self.session.get(self._url("/api/files/stats"))
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    # =========================================================================
+    # Filters API
+    # =========================================================================
+
+    async def get_filter_config(self) -> Dict[str, Any]:
+        """Get the current filter configuration"""
+        try:
+            response = await self.session.get(self._url("/api/filters/config"))
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def update_filter_config(
+        self,
+        mode: Optional[str] = None,
+        exclude: Optional[List[str]] = None,
+        include: Optional[List[str]] = None,
+        apply_immediately: bool = True,
+    ) -> Dict[str, Any]:
+        """Update the filter configuration"""
+        data: Dict[str, Any] = {"apply_immediately": apply_immediately}
+        if mode is not None:
+            data["mode"] = mode
+        if exclude is not None:
+            data["exclude"] = exclude
+        if include is not None:
+            data["include"] = include
+
+        try:
+            response = await self.session.put(
+                self._url("/api/filters/config"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def add_filter_pattern(
+        self,
+        pattern: str,
+        pattern_type: str = "exclude"
+    ) -> Dict[str, Any]:
+        """Add a pattern to the filter configuration"""
+        data = {"pattern": pattern, "pattern_type": pattern_type}
+        try:
+            response = await self.session.post(
+                self._url("/api/filters/pattern"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def remove_filter_pattern(
+        self,
+        pattern: str,
+        pattern_type: str = "exclude"
+    ) -> Dict[str, Any]:
+        """Remove a pattern from the filter configuration"""
+        data = {"pattern": pattern, "pattern_type": pattern_type}
+        try:
+            response = await self.session.delete(
+                self._url("/api/filters/pattern"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def test_filter_patterns(
+        self,
+        patterns: List[str],
+        file_paths: List[str],
+        mode: str = "blacklist",
+    ) -> Dict[str, Any]:
+        """Test pattern matching against file paths"""
+        data = {"patterns": patterns, "file_paths": file_paths, "mode": mode}
+        try:
+            response = await self.session.post(
+                self._url("/api/filters/test"),
+                data=json.dumps(data)
+            )
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def get_filter_defaults(self) -> Dict[str, Any]:
+        """Get the default filter configuration"""
+        try:
+            response = await self.session.get(self._url("/api/filters/defaults"))
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def apply_filter_changes(self) -> Dict[str, Any]:
+        """Apply current filter configuration to database"""
+        try:
+            response = await self.session.post(self._url("/api/filters/apply"))
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    async def reset_filters(self) -> Dict[str, Any]:
+        """Reset filter configuration to defaults"""
+        try:
+            response = await self.session.post(self._url("/api/filters/reset"))
+            return self._handle_response(response)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    # =========================================================================
+    # Updates API (SSE)
+    # =========================================================================
+
+    async def stream_updates(self) -> AsyncIterator[Update]:
+        """Stream server-sent events from /api/updates"""
+        url = self._url("/api/updates")
+        try:
+            response = await self.session.get(url, stream=True, timeout=30)
+            response.raise_for_status()
+
+            async for line in response.iter_lines():
+                if line:
+                    line_str = line.decode('utf-8') if isinstance(line, bytes) else line
+                    # SSE format: "data: {...}"
+                    if line_str.startswith('data: '):
+                        data_str = line_str[6:]  # Remove "data: " prefix
+                        try:
+                            # Parse and create Update instance
+                            update = Update.from_sse_data(data_str)
+                            yield update
+                        except Exception:
+                            # Fallback: create a generic INFO update
+                            yield Update.create(UpdateOpcode.INFO, message=data_str)
+        except niquests.exceptions.ConnectionError:
+            raise ServerNotRunningError(self.base_url)
+
+    # =========================================================================
+    # Context Manager
+    # =========================================================================
+
+    async def close(self):
+        """Close the session"""
+        await self.session.close()
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        await self.close()

cosma_client-0.0.1.dev1/src/cosma_client/exceptions.py

@@ -0,0 +1,33 @@
+"""
+Exceptions for the Cosma client library.
+"""
+
+
+class CosmaClientError(Exception):
+    """Base exception for all Cosma client errors."""
+    pass
+
+
+class ConnectionError(CosmaClientError):
+    """Raised when unable to connect to the Cosma server."""
+    pass
+
+
+class ServerNotRunningError(ConnectionError):
+    """Raised when the Cosma server is not running."""
+
+    def __init__(self, base_url: str = "http://127.0.0.1:60534"):
+        self.base_url = base_url
+        super().__init__(
+            f"Cannot connect to Cosma server at {base_url}. "
+            "Is the server running? Start it with: cosma serve"
+        )
+
+
+class APIError(CosmaClientError):
+    """Raised when the API returns an error response."""
+
+    def __init__(self, status_code: int, message: str):
+        self.status_code = status_code
+        self.message = message
+        super().__init__(f"API error ({status_code}): {message}")

cosma_client-0.0.1.dev1/src/cosma_client/models.py

@@ -0,0 +1,225 @@
+from dataclasses import dataclass, field
+from typing import Any, Dict, Self
+import enum
+import json
+
+
+class UpdateOpcode(enum.Enum):
+    """
+    Opcodes for different types of backend updates sent to the frontend via SSE.
+    """
+    # File processing updates
+    FILE_PARSING = "file_parsing"
+    FILE_PARSED = "file_parsed"
+    FILE_SUMMARIZING = "file_summarizing"
+    FILE_SUMMARIZED = "file_summarized"
+    FILE_EMBEDDING = "file_embedding"
+    FILE_EMBEDDED = "file_embedded"
+    FILE_COMPLETE = "file_complete"
+    FILE_FAILED = "file_failed"
+    FILE_SKIPPED = "file_skipped"
+
+    # File system events (from watcher)
+    FILE_CREATED = "file_created"
+    FILE_MODIFIED = "file_modified"
+    FILE_DELETED = "file_deleted"
+    FILE_MOVED = "file_moved"
+
+    # Watch directory updates
+    WATCH_ADDED = "watch_added"
+    WATCH_REMOVED = "watch_removed"
+    WATCH_STARTED = "watch_started"
+
+    # Directory processing updates
+    DIRECTORY_PROCESSING_STARTED = "directory_processing_started"
+    DIRECTORY_PROCESSING_COMPLETED = "directory_processing_completed"
+
+    # General updates
+    STATUS_UPDATE = "status_update"
+    ERROR = "error"
+    INFO = "info"
+
+    SHUTTING_DOWN = "shutting_down"
+
+
+@dataclass
+class Update:
+    """
+    A model representing a backend update received from the server via SSE.
+
+    Each update has an opcode (message type) and optional data payload.
+    """
+    opcode: UpdateOpcode
+    data: Dict[str, Any] = field(default_factory=dict)
+
+    @classmethod
+    def create(cls, opcode: UpdateOpcode, **kwargs) -> Self:
+        """
+        Create an Update instance with the given opcode and data.
+
+        Args:
+            opcode: The type of update (UpdateOpcode enum value)
+            **kwargs: Arbitrary keyword arguments that will be stored in the data dict
+
+        Returns:
+            An Update instance
+        """
+        return cls(opcode=opcode, data=kwargs)
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> Self:
+        """
+        Create an Update instance from a dictionary (parsed from SSE).
+
+        Args:
+            data: Dictionary with 'opcode' and 'data' keys
+
+        Returns:
+            An Update instance
+        """
+        opcode_str = data.get('opcode', '')
+        try:
+            opcode = UpdateOpcode(opcode_str)
+        except ValueError:
+            # Fallback to INFO if unknown opcode
+            opcode = UpdateOpcode.INFO
+
+        update_data = data.get('data', {})
+        return cls(opcode=opcode, data=update_data)
+
+    @classmethod
+    def from_sse_data(cls, sse_data: str) -> Self:
+        """
+        Create an Update instance from SSE data string.
+
+        Args:
+            sse_data: Raw data string from SSE (JSON)
+
+        Returns:
+            An Update instance
+        """
+        try:
+            data = json.loads(sse_data)
+            return cls.from_dict(data)
+        except json.JSONDecodeError:
+            # Fallback: treat as INFO message with raw data
+            return cls.create(UpdateOpcode.INFO, message=sse_data)
+
+    def to_dict(self) -> Dict[str, Any]:
+        """
+        Convert the Update to a dictionary for serialization.
+
+        Returns:
+            A dictionary with 'opcode' and 'data' keys
+        """
+        return {
+            "opcode": self.opcode.value,
+            "data": self.data
+        }
+
+    def get_display_message(self) -> str:
+        """
+        Get a human-readable display message for this update.
+
+        Returns:
+            A formatted string suitable for display
+        """
+        # File processing messages
+        if self.opcode == UpdateOpcode.FILE_PARSING:
+            filename = self.data.get('filename', 'Unknown file')
+            return f"Parsing {filename}..."
+
+        elif self.opcode == UpdateOpcode.FILE_PARSED:
+            filename = self.data.get('filename', 'Unknown file')
+            return f"Parsed {filename}"
+
+        elif self.opcode == UpdateOpcode.FILE_SUMMARIZING:
+            filename = self.data.get('filename', 'Unknown file')
+            return f"Summarizing {filename}..."
+
+        elif self.opcode == UpdateOpcode.FILE_SUMMARIZED:
+            filename = self.data.get('filename', 'Unknown file')
+            return f"Summarized {filename}"
+
+        elif self.opcode == UpdateOpcode.FILE_EMBEDDING:
+            filename = self.data.get('filename', 'Unknown file')
+            return f"Embedding {filename}..."
+
+        elif self.opcode == UpdateOpcode.FILE_EMBEDDED:
+            filename = self.data.get('filename', 'Unknown file')
+            return f"Embedded {filename}"
+
+        elif self.opcode == UpdateOpcode.FILE_COMPLETE:
+            filename = self.data.get('filename', 'Unknown file')
+            return f"Completed {filename}"
+
+        elif self.opcode == UpdateOpcode.FILE_FAILED:
+            filename = self.data.get('filename', 'Unknown file')
+            error = self.data.get('error', 'Unknown error')
+            return f"Failed {filename}: {error}"
+
+        elif self.opcode == UpdateOpcode.FILE_SKIPPED:
+            filename = self.data.get('filename', 'Unknown file')
+            reason = self.data.get('reason', 'Unknown reason')
+            return f"Skipped {filename}: {reason}"
+
+        # File system events
+        elif self.opcode == UpdateOpcode.FILE_CREATED:
+            path = self.data.get('path', 'Unknown path')
+            return f"Created {path}"
+
+        elif self.opcode == UpdateOpcode.FILE_MODIFIED:
+            path = self.data.get('path', 'Unknown path')
+            return f"Modified {path}"
+
+        elif self.opcode == UpdateOpcode.FILE_DELETED:
+            path = self.data.get('path', 'Unknown path')
+            return f"Deleted {path}"
+
+        elif self.opcode == UpdateOpcode.FILE_MOVED:
+            src = self.data.get('src_path', 'Unknown source')
+            dst = self.data.get('dest_path', 'Unknown destination')
+            return f"Moved {src} -> {dst}"
+
+        # Directory processing
+        elif self.opcode == UpdateOpcode.DIRECTORY_PROCESSING_STARTED:
+            path = self.data.get('path', 'Unknown path')
+            return f"Processing directory: {path}"
+
+        elif self.opcode == UpdateOpcode.DIRECTORY_PROCESSING_COMPLETED:
+            path = self.data.get('path', 'Unknown path')
+            return f"Completed directory: {path}"
+
+        # Watch directory updates
+        elif self.opcode == UpdateOpcode.WATCH_ADDED:
+            return f"Added watch directory"
+
+        elif self.opcode == UpdateOpcode.WATCH_REMOVED:
+            return f"Removed watch directory"
+
+        elif self.opcode == UpdateOpcode.WATCH_STARTED:
+            return "Started watching for changes"
+
+        # General updates
+        elif self.opcode == UpdateOpcode.STATUS_UPDATE:
+            message = self.data.get('message', 'Status update')
+            return f"Status: {message}"
+
+        elif self.opcode == UpdateOpcode.ERROR:
+            message = self.data.get('message', 'Error occurred')
+            return f"Error: {message}"
+
+        elif self.opcode == UpdateOpcode.INFO:
+            message = self.data.get('message', 'Info')
+            return f"Info: {message}"
+
+        elif self.opcode == UpdateOpcode.SHUTTING_DOWN:
+            return "Server shutting down"
+
+        # Fallback for unknown opcodes
+        else:
+            return f"Unknown update: {self.opcode.value}"
+
+    def __str__(self) -> str:
+        """Return a string representation of the update."""
+        return self.get_display_message()

cosma_client-0.0.1.dev1/src/cosma_client/sync.py

@@ -0,0 +1,235 @@
+"""
+Synchronous wrapper for the async Cosma client.
+"""
+
+import asyncio
+import warnings
+from typing import Any, Callable, Coroutine, Dict, Iterator, List, Optional
+
+from .client import Client
+from .models import Update
+
+
+class SyncClient:
+    """
+    Synchronous wrapper around the async Client.
+
+    This class provides a synchronous API for the Cosma client,
+    making it easier to use in non-async contexts like CLI commands.
+    """
+
+    def __init__(self, base_url: str = "http://127.0.0.1:60534"):
+        self._base_url = base_url
+
+    def _run_with_client(
+        self,
+        async_method: Callable[[Client], Coroutine[Any, Any, Any]],
+    ) -> Any:
+        """Run an async method with a fresh client and proper cleanup."""
+        async def run_with_cleanup():
+            client = Client(self._base_url)
+            try:
+                return await async_method(client)
+            finally:
+                await client.close()
+
+        # Suppress the "Task was destroyed" warning for urllib3's idle connection watcher
+        with warnings.catch_warnings():
+            warnings.filterwarnings("ignore", message=".*Task was destroyed.*")
+            return asyncio.run(run_with_cleanup())
+
+    @property
+    def base_url(self) -> str:
+        return self._base_url
+
+    # =========================================================================
+    # Index API
+    # =========================================================================
+
+    def index_directory(self, directory_path: str) -> Dict[str, Any]:
+        """Index all files in a directory for searching"""
+        return self._run_with_client(
+            lambda c: c.index_directory(directory_path)
+        )
+
+    def index_file(self, file_path: str) -> Dict[str, Any]:
+        """Index a single file"""
+        return self._run_with_client(lambda c: c.index_file(file_path))
+
+    def index_status(self) -> Dict[str, Any]:
+        """Get the current status of indexing operations"""
+        return self._run_with_client(lambda c: c.index_status())
+
+    # =========================================================================
+    # Status API
+    # =========================================================================
+
+    def status(self) -> Dict[str, Any]:
+        """Get the current status of the backend"""
+        return self._run_with_client(lambda c: c.status())
+
+    # =========================================================================
+    # Search API
+    # =========================================================================
+
+    def search(
+        self,
+        query: str,
+        filters: Optional[Dict[str, Any]] = None,
+        limit: int = 50
+    ) -> Dict[str, Any]:
+        """Search for files based on a query string"""
+        return self._run_with_client(lambda c: c.search(query, filters, limit))
+
+    def search_by_keywords(
+        self,
+        keywords: List[str],
+        match_all: bool = False
+    ) -> Dict[str, Any]:
+        """Search for files by specific keywords"""
+        return self._run_with_client(
+            lambda c: c.search_by_keywords(keywords, match_all)
+        )
+
+    def find_similar_files(self, file_id: int, limit: int = 10) -> Dict[str, Any]:
+        """Find files similar to a given file"""
+        return self._run_with_client(
+            lambda c: c.find_similar_files(file_id, limit)
+        )
+
+    def autocomplete(self, q: str, limit: int = 10) -> Dict[str, Any]:
+        """Get autocomplete suggestions for search queries"""
+        return self._run_with_client(lambda c: c.autocomplete(q, limit))
+
+    # =========================================================================
+    # Watch API
+    # =========================================================================
+
+    def watch_directory(self, directory_path: str) -> Dict[str, Any]:
+        """Start watching a directory for changes"""
+        return self._run_with_client(
+            lambda c: c.watch_directory(directory_path)
+        )
+
+    def get_watch_jobs(self) -> Dict[str, Any]:
+        """Get all watched directory jobs"""
+        return self._run_with_client(lambda c: c.get_watch_jobs())
+
+    def delete_watch_job(self, job_id: int) -> Dict[str, Any]:
+        """Delete a watched directory job by ID"""
+        return self._run_with_client(lambda c: c.delete_watch_job(job_id))
+
+    # =========================================================================
+    # Files API
+    # =========================================================================
+
+    def get_file(self, file_id: int) -> Dict[str, Any]:
+        """Get details of a specific file by ID"""
+        return self._run_with_client(lambda c: c.get_file(file_id))
+
+    def get_file_stats(self) -> Dict[str, Any]:
+        """Get statistics about indexed files"""
+        return self._run_with_client(lambda c: c.get_file_stats())
+
+    # =========================================================================
+    # Filters API
+    # =========================================================================
+
+    def get_filter_config(self) -> Dict[str, Any]:
+        """Get the current filter configuration"""
+        return self._run_with_client(lambda c: c.get_filter_config())
+
+    def update_filter_config(
+        self,
+        mode: Optional[str] = None,
+        exclude: Optional[List[str]] = None,
+        include: Optional[List[str]] = None,
+        apply_immediately: bool = True,
+    ) -> Dict[str, Any]:
+        """Update the filter configuration"""
+        return self._run_with_client(
+            lambda c: c.update_filter_config(
+                mode, exclude, include, apply_immediately
+            )
+        )
+
+    def add_filter_pattern(
+        self,
+        pattern: str,
+        pattern_type: str = "exclude"
+    ) -> Dict[str, Any]:
+        """Add a pattern to the filter configuration"""
+        return self._run_with_client(
+            lambda c: c.add_filter_pattern(pattern, pattern_type)
+        )
+
+    def remove_filter_pattern(
+        self,
+        pattern: str,
+        pattern_type: str = "exclude"
+    ) -> Dict[str, Any]:
+        """Remove a pattern from the filter configuration"""
+        return self._run_with_client(
+            lambda c: c.remove_filter_pattern(pattern, pattern_type)
+        )
+
+    def test_filter_patterns(
+        self,
+        patterns: List[str],
+        file_paths: List[str],
+        mode: str = "blacklist",
+    ) -> Dict[str, Any]:
+        """Test pattern matching against file paths"""
+        return self._run_with_client(
+            lambda c: c.test_filter_patterns(patterns, file_paths, mode)
+        )
+
+    def get_filter_defaults(self) -> Dict[str, Any]:
+        """Get the default filter configuration"""
+        return self._run_with_client(lambda c: c.get_filter_defaults())
+
+    def apply_filter_changes(self) -> Dict[str, Any]:
+        """Apply current filter configuration to database"""
+        return self._run_with_client(lambda c: c.apply_filter_changes())
+
+    def reset_filters(self) -> Dict[str, Any]:
+        """Reset filter configuration to defaults"""
+        return self._run_with_client(lambda c: c.reset_filters())
+
+    # =========================================================================
+    # Updates API
+    # =========================================================================
+
+    def stream_updates(self) -> Iterator[Update]:
+        """
+        Stream updates from the server.
+
+        Note: This is a blocking iterator. For async usage, use the
+        async Client directly.
+        """
+        async def stream_all():
+            client = Client(self._base_url)
+            try:
+                async for update in client.stream_updates():
+                    yield update
+            finally:
+                await client.close()
+
+        # For streaming, we need a different approach - collect all at once
+        # or use a queue-based approach
+        async def get_updates():
+            updates = []
+            client = Client(self._base_url)
+            try:
+                async for update in client.stream_updates():
+                    updates.append(update)
+            finally:
+                await client.close()
+            return updates
+
+        with warnings.catch_warnings():
+            warnings.filterwarnings("ignore", message=".*Task was destroyed.*")
+            updates = asyncio.run(get_updates())
+
+        for update in updates:
+            yield update