rxresume-python 0.3.0__tar.gz → 0.4.0__tar.gz

{rxresume_python-0.3.0/rxresume_python.egg-info → rxresume_python-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rxresume-python
-Version: 0.3.0
+Version: 0.4.0
 Summary: Unofficial Python API client (SDK) for Reactive Resume v4
 Author: Ata Can Yaymacı
 License: MIT
@@ -42,14 +42,57 @@ It supports both synchronous (`httpx.Client`) and asynchronous (`httpx.AsyncClie
 ## Features
 
 - **Dual client modes**: Support for both sync and async APIs.
-- **Full API coverage**: Integrated modules for Resume management, Auth, Job Tracker (Applications), AI Agent prompts, AI Providers configurations, Statistics, and Storage uploads.
+- **Full API coverage**: Integrated modules for Resume management, Job Applications tracking, AI Agent, AI Providers configurations, Global Statistics, and Feature Flags.
 - **Type safety**: Fully typed models for all entities using Pydantic V2.
 - **Robust error handling**: Raw API status errors are automatically parsed into specific exceptions (`AuthenticationError`, `NotFoundError`, etc.).
 - **Developer Experience (DX)**: Code-completion ready with clear typing and docstrings.
 
+---
+
+## Architecture
+
+```mermaid
+graph TD
+    UserApp[User Application / Script] -->|Instantiates| SyncClient[RxResumeClient]
+    UserApp -->|Instantiates| AsyncClient[AsyncRxResumeClient]
+
+    subgraph "Service Modules (Sync & Async)"
+        SyncClient --> Auth[auth]
+        SyncClient --> Resumes[resumes]
+        SyncClient --> Stats[statistics]
+        SyncClient --> Agent[agent]
+        SyncClient --> AIProviders[ai_providers]
+        SyncClient --> Flags[flags]
+        SyncClient --> AI[ai]
+        SyncClient --> Applications[applications]
+    end
+
+    Auth -->|HTTP/REST Calls| Backend[Reactive Resume v4 API Backend]
+    Resumes -->|HTTP/REST Calls| Backend
+    Stats -->|HTTP/REST Calls| Backend
+    Agent -->|HTTP/REST Calls| Backend
+    AIProviders -->|HTTP/REST Calls| Backend
+    Flags -->|HTTP/REST Calls| Backend
+    AI -->|HTTP/REST Calls| Backend
+    Applications -->|HTTP/REST Calls| Backend
+```
 
 ---
 
+## Capability Matrix
+
+| Service Module | Sync | Async | Key Mapped Endpoints (Postman Collection) |
+| :--- | :---: | :---: | :--- |
+| **Resumes** (`client.resumes`) | Yes | Yes | List, Get, Create, Update, Delete, Import, Download PDF, Set/Verify/Remove Password, Duplicate, Lock, Version History, Public Resume, Statistics |
+| **Applications** (`client.applications`) | Yes | Yes | List, Get, Create, Delete, List Tags, Pipeline Stats, Bulk Import |
+| **Auth** (`client.auth`) | Yes | Yes | List Providers, Export Account, Delete Account |
+| **Statistics** (`client.statistics`) | Yes | Yes | Users Count, GitHub Stars, Resumes Count (Global Stats) |
+| **Agent** (`client.agent`) | Yes | Yes | List Threads, Create/Get/Delete Threads, Send Message, Stop Active Run, Resume Message Stream, Create/Delete Attachment, Revert Action |
+| **AI Providers** (`client.ai_providers`) | Yes | Yes | List, Create, Update, Delete, Test saved AI providers |
+| **AI Functions** (`client.ai`) | Yes | Yes | Parse PDF, Parse DOCX, Chat, Analyze Resume |
+| **Feature Flags** (`client.flags`) | Yes | Yes | List Server-side Feature Flags |
+
+
 ## Installation
 
 Install the package via `pip` or your favorite package manager:
@@ -90,9 +133,9 @@ async def main():
             new_resume = await client.resumes.import_resume(import_data)
             print(f"Created resume: {new_resume.name} (ID: {new_resume.id})")
 
-            # Fetch the generated PDF URL
-            pdf_url = await client.resumes.get_pdf_url(new_resume.id)
-            print(f"PDF URL: {pdf_url}")
+            # Download the compiled PDF bytes
+            pdf_bytes = await client.resumes.download_pdf(new_resume.id)
+            print(f"Downloaded PDF: {len(pdf_bytes)} bytes")
 
         except Exception as e:
             print(f"An error occurred: {e}")
@@ -105,7 +148,6 @@ if __name__ == "__main__":
 
 ```python
 from reactive_resume import RxResumeClient
-from reactive_resume.models import ResumeImportData
 
 with RxResumeClient(base_url="https://rxresu.me", api_key="your_api_key") as client:
     resumes = client.resumes.list()
@@ -113,33 +155,30 @@ with RxResumeClient(base_url="https://rxresu.me", api_key="your_api_key") as cli
         print(f"Resume: {resume.name} (Slug: {resume.slug})")
 ```
 
-### 3. Advanced Features (AI Agent, Storage, Statistics, Applications)
+### 3. Advanced Features (AI Agent, Statistics, Applications)
 
 ```python
 with RxResumeClient(base_url="https://rxresu.me", api_key="your_api_key") as client:
-    # 1. Ask the AI agent to optimize a resume summary
-    ai_response = client.agent.chat("resume_id_here", "Suggest a professional summary for a software developer.")
-    print(f"AI Suggestion: {ai_response.response}")
-
-    # 2. Upload a profile image to storage
-    with open("avatar.png", "rb") as f:
-        file_metadata = client.storage.upload_file(f.read(), "avatar.png")
-    print(f"Uploaded Image URL: {file_metadata.url}")
-
-    # 3. Retrieve resume metrics
-    stats = client.statistics.get("resume_id_here")
-    print(f"Views: {stats.views}, Downloads: {stats.downloads}")
-
-    # 4. Log a new job application
-    from reactive_resume.models import ApplicationCreate
-    app = client.applications.create(ApplicationCreate(
-        company="Google",
-        position="Senior Backend Engineer",
-        stage="Interviewing"
-    ))
-    print(f"Logged Application ID: {app.id}")
+    # 1. Start a new AI Agent thread and send a message
+    thread = client.agent.create_thread()
+    response = client.agent.send_message(thread["id"], "Suggest a professional summary for a software developer.")
+    print(f"AI Suggestion: {response}")
+
+    # 2. Retrieve global resume platform metrics
+    users_count = client.statistics.get_users_count()
+    print(f"Platform Users: {users_count}")
+
+    # 3. List job applications
+    apps = client.applications.list()
+    for app in apps:
+        print(f"Job application: {app.company} - {app.position} ({app.stage})")
+
+    # 4. Check server-side feature flags
+    flags = client.flags.list()
+    print(f"Signups disabled: {flags.get('isSignupsDisabled')}")
 ```
 
+
 ---
 
 

{rxresume_python-0.3.0 → rxresume_python-0.4.0}/README.md

@@ -13,14 +13,57 @@ It supports both synchronous (`httpx.Client`) and asynchronous (`httpx.AsyncClie
 ## Features
 
 - **Dual client modes**: Support for both sync and async APIs.
-- **Full API coverage**: Integrated modules for Resume management, Auth, Job Tracker (Applications), AI Agent prompts, AI Providers configurations, Statistics, and Storage uploads.
+- **Full API coverage**: Integrated modules for Resume management, Job Applications tracking, AI Agent, AI Providers configurations, Global Statistics, and Feature Flags.
 - **Type safety**: Fully typed models for all entities using Pydantic V2.
 - **Robust error handling**: Raw API status errors are automatically parsed into specific exceptions (`AuthenticationError`, `NotFoundError`, etc.).
 - **Developer Experience (DX)**: Code-completion ready with clear typing and docstrings.
 
+---
+
+## Architecture
+
+```mermaid
+graph TD
+    UserApp[User Application / Script] -->|Instantiates| SyncClient[RxResumeClient]
+    UserApp -->|Instantiates| AsyncClient[AsyncRxResumeClient]
+
+    subgraph "Service Modules (Sync & Async)"
+        SyncClient --> Auth[auth]
+        SyncClient --> Resumes[resumes]
+        SyncClient --> Stats[statistics]
+        SyncClient --> Agent[agent]
+        SyncClient --> AIProviders[ai_providers]
+        SyncClient --> Flags[flags]
+        SyncClient --> AI[ai]
+        SyncClient --> Applications[applications]
+    end
+
+    Auth -->|HTTP/REST Calls| Backend[Reactive Resume v4 API Backend]
+    Resumes -->|HTTP/REST Calls| Backend
+    Stats -->|HTTP/REST Calls| Backend
+    Agent -->|HTTP/REST Calls| Backend
+    AIProviders -->|HTTP/REST Calls| Backend
+    Flags -->|HTTP/REST Calls| Backend
+    AI -->|HTTP/REST Calls| Backend
+    Applications -->|HTTP/REST Calls| Backend
+```
 
 ---
 
+## Capability Matrix
+
+| Service Module | Sync | Async | Key Mapped Endpoints (Postman Collection) |
+| :--- | :---: | :---: | :--- |
+| **Resumes** (`client.resumes`) | Yes | Yes | List, Get, Create, Update, Delete, Import, Download PDF, Set/Verify/Remove Password, Duplicate, Lock, Version History, Public Resume, Statistics |
+| **Applications** (`client.applications`) | Yes | Yes | List, Get, Create, Delete, List Tags, Pipeline Stats, Bulk Import |
+| **Auth** (`client.auth`) | Yes | Yes | List Providers, Export Account, Delete Account |
+| **Statistics** (`client.statistics`) | Yes | Yes | Users Count, GitHub Stars, Resumes Count (Global Stats) |
+| **Agent** (`client.agent`) | Yes | Yes | List Threads, Create/Get/Delete Threads, Send Message, Stop Active Run, Resume Message Stream, Create/Delete Attachment, Revert Action |
+| **AI Providers** (`client.ai_providers`) | Yes | Yes | List, Create, Update, Delete, Test saved AI providers |
+| **AI Functions** (`client.ai`) | Yes | Yes | Parse PDF, Parse DOCX, Chat, Analyze Resume |
+| **Feature Flags** (`client.flags`) | Yes | Yes | List Server-side Feature Flags |
+
+
 ## Installation
 
 Install the package via `pip` or your favorite package manager:
@@ -61,9 +104,9 @@ async def main():
             new_resume = await client.resumes.import_resume(import_data)
             print(f"Created resume: {new_resume.name} (ID: {new_resume.id})")
 
-            # Fetch the generated PDF URL
-            pdf_url = await client.resumes.get_pdf_url(new_resume.id)
-            print(f"PDF URL: {pdf_url}")
+            # Download the compiled PDF bytes
+            pdf_bytes = await client.resumes.download_pdf(new_resume.id)
+            print(f"Downloaded PDF: {len(pdf_bytes)} bytes")
 
         except Exception as e:
             print(f"An error occurred: {e}")
@@ -76,7 +119,6 @@ if __name__ == "__main__":
 
 ```python
 from reactive_resume import RxResumeClient
-from reactive_resume.models import ResumeImportData
 
 with RxResumeClient(base_url="https://rxresu.me", api_key="your_api_key") as client:
     resumes = client.resumes.list()
@@ -84,33 +126,30 @@ with RxResumeClient(base_url="https://rxresu.me", api_key="your_api_key") as cli
         print(f"Resume: {resume.name} (Slug: {resume.slug})")
 ```
 
-### 3. Advanced Features (AI Agent, Storage, Statistics, Applications)
+### 3. Advanced Features (AI Agent, Statistics, Applications)
 
 ```python
 with RxResumeClient(base_url="https://rxresu.me", api_key="your_api_key") as client:
-    # 1. Ask the AI agent to optimize a resume summary
-    ai_response = client.agent.chat("resume_id_here", "Suggest a professional summary for a software developer.")
-    print(f"AI Suggestion: {ai_response.response}")
-
-    # 2. Upload a profile image to storage
-    with open("avatar.png", "rb") as f:
-        file_metadata = client.storage.upload_file(f.read(), "avatar.png")
-    print(f"Uploaded Image URL: {file_metadata.url}")
-
-    # 3. Retrieve resume metrics
-    stats = client.statistics.get("resume_id_here")
-    print(f"Views: {stats.views}, Downloads: {stats.downloads}")
-
-    # 4. Log a new job application
-    from reactive_resume.models import ApplicationCreate
-    app = client.applications.create(ApplicationCreate(
-        company="Google",
-        position="Senior Backend Engineer",
-        stage="Interviewing"
-    ))
-    print(f"Logged Application ID: {app.id}")
+    # 1. Start a new AI Agent thread and send a message
+    thread = client.agent.create_thread()
+    response = client.agent.send_message(thread["id"], "Suggest a professional summary for a software developer.")
+    print(f"AI Suggestion: {response}")
+
+    # 2. Retrieve global resume platform metrics
+    users_count = client.statistics.get_users_count()
+    print(f"Platform Users: {users_count}")
+
+    # 3. List job applications
+    apps = client.applications.list()
+    for app in apps:
+        print(f"Job application: {app.company} - {app.position} ({app.stage})")
+
+    # 4. Check server-side feature flags
+    flags = client.flags.list()
+    print(f"Signups disabled: {flags.get('isSignupsDisabled')}")
 ```
 
+
 ---
 
 

{rxresume_python-0.3.0 → rxresume_python-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rxresume-python"
-version = "0.3.0"
+version = "0.4.0"
 description = "Unofficial Python API client (SDK) for Reactive Resume v4"
 readme = "README.md"
 requires-python = ">=3.10"

{rxresume_python-0.3.0 → rxresume_python-0.4.0}/reactive_resume/api/__init__.py

@@ -2,25 +2,28 @@
 
 from .auth import AuthAPI, AsyncAuthAPI
 from .resumes import ResumesAPI, AsyncResumesAPI
-from .applications import ApplicationsAPI, AsyncApplicationsAPI
 from .statistics import StatisticsAPI, AsyncStatisticsAPI
-from .storage import StorageAPI, AsyncStorageAPI
 from .agent import AgentAPI, AsyncAgentAPI
 from .ai_providers import AiProvidersAPI, AsyncAiProvidersAPI
+from .flags import FlagsAPI, AsyncFlagsAPI
+from .ai import AIAPI, AsyncAIAPI
+from .applications import ApplicationsAPI, AsyncApplicationsAPI
 
 __all__ = [
     "AuthAPI",
     "AsyncAuthAPI",
     "ResumesAPI",
     "AsyncResumesAPI",
-    "ApplicationsAPI",
-    "AsyncApplicationsAPI",
     "StatisticsAPI",
     "AsyncStatisticsAPI",
-    "StorageAPI",
-    "AsyncStorageAPI",
     "AgentAPI",
     "AsyncAgentAPI",
     "AiProvidersAPI",
     "AsyncAiProvidersAPI",
+    "FlagsAPI",
+    "AsyncFlagsAPI",
+    "AIAPI",
+    "AsyncAIAPI",
+    "ApplicationsAPI",
+    "AsyncApplicationsAPI",
 ]

rxresume_python-0.4.0/reactive_resume/api/agent.py

@@ -0,0 +1,243 @@
+"""Agent API endpoints implementation."""
+
+from typing import List, Dict, Any, Optional
+
+
+class AgentAPI:
+    """Synchronous AI Agent operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    def list_threads(self) -> List[Dict[str, Any]]:
+        """List all active agent threads."""
+        response = self._client._request("GET", "/api/openapi/agent/threads")
+        return list(response)
+
+    def get_thread(self, thread_id: str) -> Dict[str, Any]:
+        """Get details of a specific agent thread by ID."""
+        response = self._client._request("GET", f"/api/openapi/agent/threads/{thread_id}")
+        return dict(response)
+
+    def delete_thread(self, thread_id: str) -> None:
+        """Delete an agent thread by ID."""
+        self._client._request("DELETE", f"/api/openapi/agent/threads/{thread_id}")
+
+    def create_thread(
+        self, ai_provider_id: Optional[str] = None, source_resume_id: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """Create a new agent thread."""
+        payload = {}
+        if ai_provider_id is not None:
+            payload["aiProviderId"] = ai_provider_id
+        if source_resume_id is not None:
+            payload["sourceResumeId"] = source_resume_id
+        response = self._client._request("POST", "/api/openapi/agent/threads", json=payload)
+        return dict(response)
+
+    def get_or_create_thread_for_resume(
+        self, ai_provider_id: Optional[str] = None, source_resume_id: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """Get or create an in-resume agent thread."""
+        payload = {}
+        if ai_provider_id is not None:
+            payload["aiProviderId"] = ai_provider_id
+        if source_resume_id is not None:
+            payload["sourceResumeId"] = source_resume_id
+        response = self._client._request(
+            "POST", "/api/openapi/agent/threads/for-resume", json=payload
+        )
+        return dict(response)
+
+    def send_message(
+        self, thread_id: str, message: Any, attachment_ids: Optional[List[str]] = None
+    ) -> Dict[str, Any]:
+        """Send an agent message."""
+        payload = {
+            "threadId": thread_id,
+            "message": message,
+        }
+        if attachment_ids is not None:
+            payload["attachmentIds"] = attachment_ids
+        response = self._client._request("POST", "/api/openapi/agent/messages/send", json=payload)
+        return dict(response)
+
+    def archive_thread(
+        self,
+        thread_id: str,
+        ai_provider_id: Optional[str] = None,
+        source_resume_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Archive an agent thread."""
+        payload = {}
+        if ai_provider_id is not None:
+            payload["aiProviderId"] = ai_provider_id
+        if source_resume_id is not None:
+            payload["sourceResumeId"] = source_resume_id
+        response = self._client._request(
+            "POST", f"/api/openapi/agent/threads/{thread_id}/archive", json=payload
+        )
+        return dict(response)
+
+    def stop_run(self, thread_id: str, partial_message: Optional[Any] = None) -> Dict[str, Any]:
+        """Stop active agent run."""
+        payload = {
+            "threadId": thread_id,
+        }
+        if partial_message is not None:
+            payload["partialMessage"] = partial_message
+        response = self._client._request("POST", "/api/openapi/agent/messages/stop", json=payload)
+        return dict(response)
+
+    def resume_message_stream(self, thread_id: str) -> Any:
+        """Resume agent message stream."""
+        return self._client._request(
+            "GET", f"/api/openapi/agent/messages/resume?threadId={thread_id}"
+        )
+
+    def create_attachment(
+        self, thread_id: str, filename: str, media_type: str, data: str
+    ) -> Dict[str, Any]:
+        """Create agent attachment."""
+        payload = {
+            "threadId": thread_id,
+            "filename": filename,
+            "mediaType": media_type,
+            "data": data,
+        }
+        response = self._client._request("POST", "/api/openapi/agent/attachments", json=payload)
+        return dict(response)
+
+    def delete_attachment(self, attachment_id: str) -> None:
+        """Delete agent attachment."""
+        self._client._request("DELETE", f"/api/openapi/agent/attachments/{attachment_id}")
+
+    def revert_action(self, action_id: str) -> Dict[str, Any]:
+        """Restore agent action snapshot."""
+        response = self._client._request("POST", f"/api/openapi/agent/actions/{action_id}/revert")
+        return dict(response)
+
+
+class AsyncAgentAPI:
+    """Asynchronous AI Agent operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    async def list_threads(self) -> List[Dict[str, Any]]:
+        """List all active agent threads asynchronously."""
+        response = await self._client._request("GET", "/api/openapi/agent/threads")
+        return list(response)
+
+    async def get_thread(self, thread_id: str) -> Dict[str, Any]:
+        """Get details of a specific agent thread by ID asynchronously."""
+        response = await self._client._request("GET", f"/api/openapi/agent/threads/{thread_id}")
+        return dict(response)
+
+    async def delete_thread(self, thread_id: str) -> None:
+        """Delete an agent thread by ID asynchronously."""
+        await self._client._request("DELETE", f"/api/openapi/agent/threads/{thread_id}")
+
+    async def create_thread(
+        self, ai_provider_id: Optional[str] = None, source_resume_id: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """Create a new agent thread asynchronously."""
+        payload = {}
+        if ai_provider_id is not None:
+            payload["aiProviderId"] = ai_provider_id
+        if source_resume_id is not None:
+            payload["sourceResumeId"] = source_resume_id
+        response = await self._client._request("POST", "/api/openapi/agent/threads", json=payload)
+        return dict(response)
+
+    async def get_or_create_thread_for_resume(
+        self, ai_provider_id: Optional[str] = None, source_resume_id: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """Get or create an in-resume agent thread asynchronously."""
+        payload = {}
+        if ai_provider_id is not None:
+            payload["aiProviderId"] = ai_provider_id
+        if source_resume_id is not None:
+            payload["sourceResumeId"] = source_resume_id
+        response = await self._client._request(
+            "POST", "/api/openapi/agent/threads/for-resume", json=payload
+        )
+        return dict(response)
+
+    async def send_message(
+        self, thread_id: str, message: Any, attachment_ids: Optional[List[str]] = None
+    ) -> Dict[str, Any]:
+        """Send an agent message asynchronously."""
+        payload = {
+            "threadId": thread_id,
+            "message": message,
+        }
+        if attachment_ids is not None:
+            payload["attachmentIds"] = attachment_ids
+        response = await self._client._request(
+            "POST", "/api/openapi/agent/messages/send", json=payload
+        )
+        return dict(response)
+
+    async def archive_thread(
+        self,
+        thread_id: str,
+        ai_provider_id: Optional[str] = None,
+        source_resume_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Archive an agent thread asynchronously."""
+        payload = {}
+        if ai_provider_id is not None:
+            payload["aiProviderId"] = ai_provider_id
+        if source_resume_id is not None:
+            payload["sourceResumeId"] = source_resume_id
+        response = await self._client._request(
+            "POST", f"/api/openapi/agent/threads/{thread_id}/archive", json=payload
+        )
+        return dict(response)
+
+    async def stop_run(
+        self, thread_id: str, partial_message: Optional[Any] = None
+    ) -> Dict[str, Any]:
+        """Stop active agent run asynchronously."""
+        payload = {
+            "threadId": thread_id,
+        }
+        if partial_message is not None:
+            payload["partialMessage"] = partial_message
+        response = await self._client._request(
+            "POST", "/api/openapi/agent/messages/stop", json=payload
+        )
+        return dict(response)
+
+    async def resume_message_stream(self, thread_id: str) -> Any:
+        """Resume agent message stream asynchronously."""
+        return await self._client._request(
+            "GET", f"/api/openapi/agent/messages/resume?threadId={thread_id}"
+        )
+
+    async def create_attachment(
+        self, thread_id: str, filename: str, media_type: str, data: str
+    ) -> Dict[str, Any]:
+        """Create agent attachment asynchronously."""
+        payload = {
+            "threadId": thread_id,
+            "filename": filename,
+            "mediaType": media_type,
+            "data": data,
+        }
+        response = await self._client._request(
+            "POST", "/api/openapi/agent/attachments", json=payload
+        )
+        return dict(response)
+
+    async def delete_attachment(self, attachment_id: str) -> None:
+        """Delete agent attachment asynchronously."""
+        await self._client._request("DELETE", f"/api/openapi/agent/attachments/{attachment_id}")
+
+    async def revert_action(self, action_id: str) -> Dict[str, Any]:
+        """Restore agent action snapshot asynchronously."""
+        response = await self._client._request(
+            "POST", f"/api/openapi/agent/actions/{action_id}/revert"
+        )
+        return dict(response)

rxresume_python-0.4.0/reactive_resume/api/ai.py

@@ -0,0 +1,89 @@
+"""AI API endpoints implementation."""
+
+from typing import Dict, Any
+
+
+class AIAPI:
+    """Synchronous AI operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    def parse_pdf(self, file_name: str, file_data: str, provider_id: str) -> Dict[str, Any]:
+        """Parse a PDF file into resume data.
+
+        Args:
+            file_name: Name of the file.
+            file_data: Base64 or binary data representation.
+            provider_id: The ID of the configured AI provider.
+        """
+        payload = {
+            "file": {"name": file_name, "data": file_data},
+            "aiProviderId": provider_id,
+        }
+        response = self._client._request("POST", "/api/openapi/ai/parse-pdf", json=payload)
+        return dict(response)
+
+    def parse_docx(self, file_name: str, file_data: str, provider_id: str) -> Dict[str, Any]:
+        """Parse a DOCX file into resume data."""
+        payload = {
+            "file": {"name": file_name, "data": file_data},
+            "aiProviderId": provider_id,
+        }
+        response = self._client._request("POST", "/api/openapi/ai/parse-docx", json=payload)
+        return dict(response)
+
+    def chat(self, payload: Dict[str, Any]) -> Dict[str, Any]:
+        """Chat with AI to modify resume."""
+        response = self._client._request("POST", "/api/openapi/ai/chat", json=payload)
+        return dict(response)
+
+    def analyze_resume(self, resume_id: str, provider_id: str) -> Dict[str, Any]:
+        """Analyze a resume and persist the latest analysis."""
+        payload = {
+            "resumeId": resume_id,
+            "aiProviderId": provider_id,
+        }
+        response = self._client._request("POST", "/api/openapi/ai/analyze-resume", json=payload)
+        return dict(response)
+
+
+class AsyncAIAPI:
+    """Asynchronous AI operations."""
+
+    def __init__(self, client) -> None:
+        self._client = client
+
+    async def parse_pdf(self, file_name: str, file_data: str, provider_id: str) -> Dict[str, Any]:
+        """Parse a PDF file into resume data asynchronously."""
+        payload = {
+            "file": {"name": file_name, "data": file_data},
+            "aiProviderId": provider_id,
+        }
+        response = await self._client._request("POST", "/api/openapi/ai/parse-pdf", json=payload)
+        return dict(response)
+
+    async def parse_docx(self, file_name: str, file_data: str, provider_id: str) -> Dict[str, Any]:
+        """Parse a DOCX file into resume data asynchronously."""
+        payload = {
+            "file": {"name": file_name, "data": file_data},
+            "aiProviderId": provider_id,
+        }
+        response = await self._client._request("POST", "/api/openapi/ai/parse-docx", json=payload)
+        return dict(response)
+
+    async def chat(self, payload: Dict[str, Any]) -> Dict[str, Any]:
+        """Chat with AI asynchronously to modify resume."""
+        response = await self._client._request("POST", "/api/openapi/ai/chat", json=payload)
+        return dict(response)
+
+    async def analyze_resume(self, resume_id: str, provider_id: str) -> Dict[str, Any]:
+        """Analyze a resume asynchronously and persist the latest analysis."""
+        payload = {
+            "resumeId": resume_id,
+            "aiProviderId": provider_id,
+        }
+        response = await self._client._request(
+            "POST", "/api/openapi/ai/analyze-resume", json=payload
+        )
+        return dict(response)