fleeks-sdk 0.7.0__tar.gz → 0.7.2__tar.gz

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fleeks-sdk
-Version: 0.7.0
+Version: 0.7.2
 Summary: Python SDK for the Fleeks AI Development Platform
 Author-email: Fleeks Inc <support@fleeks.com>
 License: MIT
@@ -86,6 +86,8 @@ Fleeks is a revolutionary AI-powered development platform that provides instant
 pip install fleeks-sdk
 ```
 
+For the best compatibility with API key metadata, usage stats, voice, and preview routes, use Fleeks backend `2026.05.13` or newer. The SDK includes fallbacks for older backends where possible.
+
 ## 🚀 Quick Start
 
 ```python

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/README.md

@@ -42,6 +42,8 @@ Fleeks is a revolutionary AI-powered development platform that provides instant
 pip install fleeks-sdk
 ```
 
+For the best compatibility with API key metadata, usage stats, voice, and preview routes, use Fleeks backend `2026.05.13` or newer. The SDK includes fallbacks for older backends where possible.
+
 ## 🚀 Quick Start
 
 ```python

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/__init__.py

@@ -17,7 +17,7 @@ Features:
 - Type hints throughout
 """
 
-__version__ = "0.7.0"
+__version__ = "0.7.2"
 __author__ = "Fleeks Inc"
 __email__ = "support@fleeks.com"
 
@@ -86,7 +86,8 @@ from .exceptions import (
     FleeksFeatureUnsupportedError,
     FleeksConnectionError,
     FleeksStreamingError,
-    FleeksTimeoutError
+    FleeksTimeoutError,
+    WorkspaceNotReadyError,
 )
 
 # Data models
@@ -304,4 +305,5 @@ __all__ = [
     "FleeksConnectionError",
     "FleeksStreamingError",
     "FleeksTimeoutError",
+    "WorkspaceNotReadyError",
 ]

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/automations.py

@@ -106,7 +106,7 @@ class AutomationManager:
         if context_mapping is not None:
             body["context_mapping"] = context_mapping
 
-        response = await self.client.post("automations", json=body)
+        response = await self.client.post("automations/", json=body)
         return Automation.from_dict(response)
 
     async def list(
@@ -132,7 +132,7 @@ class AutomationManager:
             "limit": str(limit),
             "offset": str(offset),
         }
-        response = await self.client.get("automations", params=params)
+        response = await self.client.get("automations/", params=params)
         return AutomationList.from_dict(response)
 
     async def get(self, automation_id: str) -> Automation:

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/channels.py

@@ -49,6 +49,13 @@ class ChannelManager:
         >>> # Initiate OAuth / QR auth
         >>> auth = await client.channels.auth(chan.channel_id)
         >>> print(auth.oauth_url or auth.qr_code_data)
+
+    Notes:
+        - There is no ``send()`` method here. Outbound messaging is
+          handled by the agent daemon once the channel is authenticated
+          and the schedule is running. Use :meth:`test` to verify
+          credentials, and ``client.schedules.start(...)`` to bring the
+          agent online.
     """
 
     def __init__(self, client):
@@ -125,7 +132,7 @@ class ChannelManager:
         if message_filter is not None:
             body["message_filter"] = message_filter
 
-        response = await self.client.post("channels", json=body)
+        response = await self.client.post("channels/", json=body)
         return Channel.from_dict(response)
 
     async def list(
@@ -151,7 +158,7 @@ class ChannelManager:
             "limit": str(limit),
             "offset": str(offset),
         }
-        response = await self.client.get("channels", params=params)
+        response = await self.client.get("channels/", params=params)
         return ChannelList.from_dict(response)
 
     async def get(self, channel_id: str) -> Channel:
@@ -189,12 +196,30 @@ class ChannelManager:
             channel_id: Channel identifier.
             **kwargs: Fields to update. Accepted keys:
                 channel_name, route_to_agents, default_agent,
-                message_filter, rate_limit_per_minute, rate_limit_per_hour.
+                message_filter, rate_limit_per_minute,
+                rate_limit_per_hour, is_active, credentials.
+
+                ``credentials`` is rotated through the secrets vault
+                (GCP Secret Manager when available, Fernet otherwise)
+                and never persisted to the database directly.
 
         Returns:
             Channel: Updated channel.
         """
-        body = {k: v for k, v in kwargs.items() if v is not None}
+        allowed = {
+            "channel_name",
+            "route_to_agents",
+            "default_agent",
+            "message_filter",
+            "rate_limit_per_minute",
+            "rate_limit_per_hour",
+            "is_active",
+            "credentials",
+        }
+        body = {
+            k: v for k, v in kwargs.items()
+            if v is not None and k in allowed
+        }
         response = await self.client.put(f"channels/{channel_id}", json=body)
         return Channel.from_dict(response)
 
@@ -241,25 +266,35 @@ class ChannelManager:
         """
         Check the authentication status of a pending auth flow.
 
+        The backend returns a flatter payload here than :meth:`auth`
+        (no ``data`` envelope): the QR image / OAuth URL is folded
+        directly into the response. ``AuthFlowResult.from_dict`` handles
+        both shapes, so ``.oauth_url``, ``.qr_image`` and ``.qr_code_data``
+        work uniformly.
+
         Args:
             channel_id: Channel identifier.
 
         Returns:
-            AuthFlowResult: Current auth status.
+            AuthFlowResult: Current auth status. Use
+            :attr:`AuthFlowResult.is_authenticated` to check completion.
         """
-        response = await self.client.get(f"channels/{channel_id}/auth/status")
+        response = await self.client.get(
+            f"channels/{channel_id}/auth/status"
+        )
         return AuthFlowResult.from_dict(response)
 
     async def test(self, channel_id: str) -> Dict[str, Any]:
         """
         Test a channel connection.
 
-        Sends a test message and verifies connectivity.
+        Validates the stored credentials. A full end-to-end message
+        round-trip additionally requires the schedule to be running.
 
         Args:
             channel_id: Channel identifier.
 
         Returns:
-            dict: Test result with status and message.
+            dict: ``{channel_id, channel_type, test_result, message}``.
         """
         return await self.client.post(f"channels/{channel_id}/test")

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/client.py

@@ -8,11 +8,17 @@ from typing import Dict, Any, Optional, List, Union, AsyncContextManager
 from contextlib import asynccontextmanager
 
 import httpx
-from tenacity import retry, stop_after_attempt, wait_exponential
+from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception
 from pydantic import BaseModel
 
 from .config import Config
 from .exceptions import FleeksAPIError, FleeksException, FleeksRateLimitError
+
+
+def _is_transient_error(exc: BaseException) -> bool:
+    """Retry only on rate-limits and network-level errors, never on 4xx API errors."""
+    import asyncio
+    return isinstance(exc, (FleeksRateLimitError, httpx.RequestError, asyncio.CancelledError))
 from .auth import APIKeyAuth
 from .workspaces import WorkspaceManager
 from .agents import AgentManager
@@ -104,7 +110,8 @@ class FleeksClient:
                 base_url=self.base_url,
                 timeout=httpx.Timeout(self.config.timeout),
                 headers={
-                    'X-API-Key': self.api_key,  # Backend expects X-API-Key header, not Bearer
+                    'X-API-Key': self.api_key,
+                    'Authorization': f'Bearer {self.api_key}',
                     'Content-Type': 'application/json',
                     'User-Agent': f'fleeks-python-sdk/{self.config.version}',
                     'Accept': 'application/json'
@@ -114,7 +121,8 @@ class FleeksClient:
 
     @retry(
         stop=stop_after_attempt(3),
-        wait=wait_exponential(multiplier=1, min=1, max=10)
+        wait=wait_exponential(multiplier=1, min=1, max=10),
+        retry=retry_if_exception(_is_transient_error),
     )
     async def _make_request(
         self,
@@ -140,8 +148,9 @@ class FleeksClient:
         """
         await self._ensure_client()
         
-        # Normalize endpoint — no trailing slash (FastAPI convention)
-        normalized_endpoint = endpoint.strip('/')
+        # Strip leading slash only; preserve any trailing slash the caller explicitly adds
+        # (collection routes like /sdk/schedules/ require it when redirect_slashes=False).
+        normalized_endpoint = endpoint.lstrip('/')
         prefix = kwargs.pop('_url_prefix', '/api/v1/sdk')
         url = f"{prefix}/{normalized_endpoint}"
         
@@ -166,6 +175,10 @@ class FleeksClient:
             
             response.raise_for_status()
             
+            # Handle empty bodies (e.g. 204 No Content from PUT/DELETE)
+            if not response.content:
+                return {}
+
             # Handle different content types
             content_type = response.headers.get('content-type', '')
             if 'application/json' in content_type:
@@ -472,11 +485,21 @@ class FleeksClient:
 
     async def get_usage_stats(self) -> Dict[str, Any]:
         """Get current usage statistics and rate limits."""
-        return await self.get('/usage/stats')
+        try:
+            return await self.get('usage/stats')  # /api/v1/sdk/usage/stats (backend >= 2026.05.13)
+        except FleeksAPIError as exc:
+            if exc.status_code in (404, 500):
+                return await self._make_request('GET', 'billing/usage', _url_prefix='/api/v1')
+            raise
 
     async def get_api_key_info(self) -> Dict[str, Any]:
         """Get information about the current API key."""
-        return await self.get('/auth/key-info')
+        try:
+            return await self.get('auth/key-info')  # /api/v1/sdk/auth/key-info (backend >= 2026.05.13)
+        except FleeksAPIError as exc:
+            if exc.status_code in (404, 500):
+                return await self._make_request('GET', 'auth/me', _url_prefix='/api/v1')
+            raise
 
 
 # Convenience function for quick usage

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/exceptions.py

@@ -122,4 +122,29 @@ class FleeksStreamingError(FleeksException):
 
 class FleeksTimeoutError(FleeksException):
     """Exception raised for timeout errors."""
-    pass
+    pass
+
+
+class WorkspaceNotReadyError(FleeksAPIError):
+    """
+    Raised when an operation requires a running workspace container but none
+    is available (HTTP 409 with error_code='container_not_running').
+
+    Attributes:
+        ready_for_preview: Always False when raised.
+        remediation: List of suggested remediation steps from the backend.
+        project_id: Project ID that triggered the error.
+    """
+
+    def __init__(
+        self,
+        message: str = "Workspace exists but no running container is available. Start the workspace container first.",
+        status_code: int = 409,
+        response: Optional[Any] = None,
+        project_id: Optional[int] = None,
+        remediation: Optional[list] = None,
+    ):
+        super().__init__(message, status_code, response)
+        self.ready_for_preview: bool = False
+        self.project_id = project_id
+        self.remediation: list = remediation or []

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/files.py

@@ -220,17 +220,11 @@ class FileManager:
             ...     content='{"debug": true}'
             ... )
         """
-        data = {
-            'path': path,
-            'content': content,
-            'encoding': encoding,
-            'create_if_missing': create_if_missing
-        }
-        
         response = await self.client._make_request(
             'PUT',
             f'files/{self.project_id}/content',
-            json=data
+            params={'path': path},
+            json={'content': content, 'encoding': encoding}
         )
         return FileInfo.from_dict(response)
     

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/models.py

@@ -1688,44 +1688,111 @@ class ChannelType(str, Enum):
 
 @dataclass
 class ChannelTypeInfo:
-    """Information about a supported channel type."""
-    channel_type: str
-    display_name: str
+    """
+    Information about a supported messaging channel type.
+
+    Matches backend ``ChannelTypeInfo`` in
+    ``app/api/api_v1/endpoints/sdk/agent_channels.py``::
+
+        {
+          "type_id": "slack",
+          "name": "Slack",
+          "description": "...",
+          "required_credentials": ["bot_token"],
+          "optional_credentials": ["app_token"],
+          "auth_flow": "oauth",     # token | oauth | qr_code | api_key
+          "docs_url": "https://..."
+        }
+    """
+    type_id: str
+    name: str
     description: str
-    auth_required: bool = True
-    auth_flow: str = "oauth2"
-    supported_features: List[str] = field(default_factory=list)
+    auth_flow: str = "token"
+    required_credentials: List[str] = field(default_factory=list)
+    optional_credentials: List[str] = field(default_factory=list)
+    docs_url: str = ""
+
+    # ── Backwards-compat aliases ─────────────────────────────
+    @property
+    def channel_type(self) -> str:
+        """Alias for ``type_id`` (older SDK callers)."""
+        return self.type_id
+
+    @property
+    def display_name(self) -> str:
+        """Alias for ``name`` (older SDK callers)."""
+        return self.name
+
+    @property
+    def auth_required(self) -> bool:
+        """True unless the channel explicitly has no required credentials
+        AND no OAuth/QR step (e.g. a future fully-public channel)."""
+        return bool(self.required_credentials) or self.auth_flow in (
+            "oauth", "qr_code"
+        )
 
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> 'ChannelTypeInfo':
+        # Accept either backend field names (preferred) or legacy SDK
+        # field names so demo code written against the old model keeps
+        # working.
+        type_id = data.get('type_id') or data.get('channel_type')
+        if not type_id:
+            raise KeyError(
+                "ChannelTypeInfo response missing 'type_id' "
+                f"(got keys: {sorted(data.keys())})"
+            )
         return cls(
-            channel_type=data['channel_type'],
-            display_name=data.get('display_name', ''),
+            type_id=type_id,
+            name=data.get('name') or data.get('display_name', ''),
             description=data.get('description', ''),
-            auth_required=data.get('auth_required', True),
-            auth_flow=data.get('auth_flow', 'oauth2'),
-            supported_features=data.get('supported_features', []),
+            auth_flow=data.get('auth_flow', 'token'),
+            required_credentials=list(data.get('required_credentials', [])),
+            optional_credentials=list(data.get('optional_credentials', [])),
+            docs_url=data.get('docs_url', ''),
         )
 
 
 @dataclass
 class Channel:
     """
-    Messaging channel — matches backend ChannelResponse.
+    Messaging channel — matches backend ``ChannelResponse``.
 
     Represents a connected messaging platform integration.
     """
     channel_id: str
     schedule_id: str
     channel_type: str
-    name: str
+    channel_name: Optional[str]
     status: str
+    is_active: bool
     created_at: str
-    updated_at: str
-    config: Dict[str, Any] = field(default_factory=dict)
+    connected_at: Optional[str] = None
+    route_to_agents: List[str] = field(default_factory=list)
+    default_agent: Optional[str] = None
+    rate_limit_per_minute: int = 60
+    rate_limit_per_hour: int = 1000
+    messages_received: int = 0
+    messages_sent: int = 0
     last_message_at: Optional[str] = None
-    message_count: int = 0
-    error_message: Optional[str] = None
+    last_error: Optional[str] = None
+    last_error_at: Optional[str] = None
+
+    # ── Backwards-compat aliases ─────────────────────────────
+    @property
+    def name(self) -> str:
+        """Alias for ``channel_name``."""
+        return self.channel_name or ""
+
+    @property
+    def message_count(self) -> int:
+        """Total messages handled by the channel (in + out)."""
+        return (self.messages_received or 0) + (self.messages_sent or 0)
+
+    @property
+    def error_message(self) -> Optional[str]:
+        """Alias for ``last_error``."""
+        return self.last_error
 
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> 'Channel':
@@ -1733,14 +1800,20 @@ class Channel:
             channel_id=data['channel_id'],
             schedule_id=data['schedule_id'],
             channel_type=data['channel_type'],
-            name=data.get('name', ''),
-            status=data.get('status', 'inactive'),
-            created_at=data['created_at'],
-            updated_at=data.get('updated_at', data['created_at']),
-            config=data.get('config', {}),
+            channel_name=data.get('channel_name') or data.get('name'),
+            status=data.get('status', 'disconnected'),
+            is_active=bool(data.get('is_active', True)),
+            created_at=data.get('created_at', ''),
+            connected_at=data.get('connected_at'),
+            route_to_agents=list(data.get('route_to_agents', []) or []),
+            default_agent=data.get('default_agent'),
+            rate_limit_per_minute=int(data.get('rate_limit_per_minute', 60)),
+            rate_limit_per_hour=int(data.get('rate_limit_per_hour', 1000)),
+            messages_received=int(data.get('messages_received', 0) or 0),
+            messages_sent=int(data.get('messages_sent', 0) or 0),
             last_message_at=data.get('last_message_at'),
-            message_count=data.get('message_count', 0),
-            error_message=data.get('error_message'),
+            last_error=data.get('last_error') or data.get('error_message'),
+            last_error_at=data.get('last_error_at'),
         )
 
 
@@ -1755,25 +1828,102 @@ class ChannelList:
         channels = [Channel.from_dict(c) for c in data.get('channels', [])]
         return cls(
             channels=channels,
-            total=data.get('total', len(channels)),
+            total=int(data.get('total', len(channels))),
         )
 
 
 @dataclass
 class AuthFlowResult:
-    """Result of initiating an OAuth/auth flow for a channel."""
-    channel_id: str
-    auth_url: str
-    expires_in: int = 600
-    state: str = ""
+    """
+    Result of initiating a channel auth flow.
+
+    Matches backend ``AuthFlowResponse``::
+
+        {
+          "auth_type": "oauth" | "qr_code" | "token",
+          "status":    "pending" | "authenticated" | "incomplete" | ...,
+          "data":      { ... provider-specific payload ... },
+          "message":   "human readable"
+        }
+
+    Provider-specific payloads in ``data``:
+        - OAuth (Slack/Teams/Google Chat): ``oauth_url`` (or ``auth_url``)
+        - QR (WhatsApp/Signal):            ``qr_payload`` and ``qr_image``
+        - Token:                           empty or ``{"missing_fields": [...]}``
+    """
+    auth_type: str
+    status: str
+    message: str
+    data: Dict[str, Any] = field(default_factory=dict)
+    channel_id: Optional[str] = None
+
+    # ── Convenience accessors (match the docstring in channels.py) ──
+    def _lookup(self, *keys: str) -> Optional[str]:
+        """Look up a key in either ``data`` or ``data['details']``.
+
+        ``POST /auth`` returns ``{auth_type, status, data: {...}}`` but
+        ``GET /auth/status`` returns a flatter shape with a ``details``
+        sub-dict — accept both.
+        """
+        details = self.data.get('details') if isinstance(
+            self.data.get('details'), dict
+        ) else {}
+        for k in keys:
+            v = self.data.get(k) or details.get(k)
+            if v:
+                return v
+        return None
+
+    @property
+    def oauth_url(self) -> Optional[str]:
+        """OAuth redirect URL (Slack / Teams / Google Chat)."""
+        return self._lookup('oauth_url', 'auth_url')
+
+    # Older callers used ``auth_url`` directly on the result.
+    @property
+    def auth_url(self) -> Optional[str]:
+        return self.oauth_url
+
+    @property
+    def qr_code_data(self) -> Optional[str]:
+        """Raw QR payload string (e.g. WhatsApp pairing code)."""
+        return self._lookup('qr_payload', 'qr_code_data')
+
+    @property
+    def qr_image(self) -> Optional[str]:
+        """Base64-encoded PNG of the QR code (data URL), if provided."""
+        return self._lookup('qr_image')
+
+    @property
+    def missing_fields(self) -> List[str]:
+        """Credential fields the user still needs to supply (token auth)."""
+        return list(self.data.get('missing_fields', []) or [])
+
+    @property
+    def is_authenticated(self) -> bool:
+        return self.status == 'authenticated'
+
+    @property
+    def is_pending(self) -> bool:
+        return self.status == 'pending'
 
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> 'AuthFlowResult':
+        # Be lenient: some endpoints (auth/status) return a flatter shape
+        # without the outer ``data`` envelope; absorb the whole dict so
+        # ``.oauth_url`` / ``.qr_payload`` still resolve.
+        payload = data.get('data')
+        if not isinstance(payload, dict):
+            payload = {
+                k: v for k, v in data.items()
+                if k not in {'auth_type', 'status', 'message', 'channel_id'}
+            }
         return cls(
-            channel_id=data.get('channel_id', ''),
-            auth_url=data['auth_url'],
-            expires_in=data.get('expires_in', 600),
-            state=data.get('state', ''),
+            auth_type=data.get('auth_type', 'unknown'),
+            status=data.get('status', 'pending'),
+            message=data.get('message', ''),
+            data=payload,
+            channel_id=data.get('channel_id'),
         )
 
 
@@ -1966,12 +2116,21 @@ class PreviewSessionList:
     project_id: int
 
     @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> 'PreviewSessionList':
+    def from_dict(cls, data: Any) -> 'PreviewSessionList':
+        if isinstance(data, list):
+            sessions = [PreviewSession.from_dict(item) for item in data]
+            project_id = sessions[0].project_id if sessions else 0
+            return cls(
+                sessions=sessions,
+                total=len(sessions),
+                project_id=project_id,
+            )
+
         sessions = [PreviewSession.from_dict(s) for s in data.get('sessions', [])]
         return cls(
             sessions=sessions,
             total=data.get('total', len(sessions)),
-            project_id=data.get('project_id', 0),
+            project_id=data.get('project_id', sessions[0].project_id if sessions else 0),
         )
 
 

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/previews.py

@@ -33,9 +33,30 @@ from .exceptions import (
     FleeksAPIError,
     FleeksResourceNotFoundError,
     FleeksValidationError,
+    WorkspaceNotReadyError,
 )
 
 
+def _raise_if_container_not_running(exc: FleeksAPIError) -> None:
+    """Convert a 409 container_not_running API error into WorkspaceNotReadyError."""
+    if exc.status_code != 409:
+        return
+    try:
+        detail = exc.response.json().get("detail", {}) if exc.response else {}
+        if isinstance(detail, dict) and detail.get("error_code") == "container_not_running":
+            raise WorkspaceNotReadyError(
+                message=detail.get("message", str(exc)),
+                status_code=409,
+                response=exc.response,
+                project_id=detail.get("project_id"),
+                remediation=detail.get("remediation", []),
+            ) from exc
+    except WorkspaceNotReadyError:
+        raise
+    except Exception:
+        pass
+
+
 class PreviewManager:
     """
     Manage preview sessions for projects.
@@ -127,12 +148,18 @@ class PreviewManager:
         if env_vars is not None:
             body["env_vars"] = env_vars
 
-        response = await self._client._make_request(
-            "POST",
-            f"preview/sessions/{project_id}/start",
-            json=body,
-        )
-        return PreviewSession.from_dict(response)
+        try:
+            response = await self._client._make_request(
+                "POST",
+                f"preview/sessions/{project_id}/start",
+                json=body,
+                _url_prefix="/api/v1",
+            )
+            return PreviewSession.from_dict(response)
+        except FleeksAPIError as exc:
+            _raise_if_container_not_running(exc)
+            raise
+        raise
 
     async def get(self, session_id: str) -> PreviewSession:
         """
@@ -153,6 +180,7 @@ class PreviewManager:
             response = await self._client._make_request(
                 "GET",
                 f"preview/sessions/{session_id}",
+                _url_prefix="/api/v1",
             )
             return PreviewSession.from_dict(response)
         except FleeksAPIError as exc:
@@ -200,6 +228,7 @@ class PreviewManager:
             "GET",
             f"preview/sessions/project/{project_id}",
             params=params,
+            _url_prefix="/api/v1",
         )
         return PreviewSessionList.from_dict(response)
 
@@ -228,6 +257,7 @@ class PreviewManager:
             return await self._client._make_request(
                 "DELETE",
                 f"preview/sessions/{session_id}",
+                _url_prefix="/api/v1",
             )
         except FleeksAPIError as exc:
             if exc.status_code == 404:
@@ -262,6 +292,7 @@ class PreviewManager:
             response = await self._client._make_request(
                 "POST",
                 f"preview/sessions/{session_id}/refresh",
+                _url_prefix="/api/v1",
             )
             return PreviewSession.from_dict(response)
         except FleeksAPIError as exc:
@@ -296,6 +327,7 @@ class PreviewManager:
         response = await self._client._make_request(
             "GET",
             f"preview/sessions/{session_id}/health",
+            _url_prefix="/api/v1",
         )
         return PreviewHealth.from_dict(response)
 
@@ -322,11 +354,16 @@ class PreviewManager:
             ...       f"(confidence {det.confidence:.0%})")
             >>> print(f"Suggested command: {det.suggested_command}")
         """
-        response = await self._client._make_request(
-            "POST",
-            f"preview/sessions/{project_id}/detect",
-        )
-        return PreviewDetectResult.from_dict(response)
+        try:
+            response = await self._client._make_request(
+                "POST",
+                f"preview/sessions/{project_id}/detect",
+                _url_prefix="/api/v1",
+            )
+            return PreviewDetectResult.from_dict(response)
+        except FleeksAPIError as exc:
+            _raise_if_container_not_running(exc)
+            raise
 
     # ------------------------------------------------------------------
     # Batch / convenience

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/schedules.py

@@ -168,7 +168,7 @@ class ScheduleManager:
         if tags is not None:
             body["tags"] = tags
 
-        response = await self.client.post("schedules", json=body)
+        response = await self.client.post("schedules/", json=body)
         return Schedule.from_dict(response)
 
     async def list(
@@ -199,7 +199,7 @@ class ScheduleManager:
         if schedule_type:
             params["schedule_type"] = schedule_type
 
-        response = await self.client.get("schedules", params=params)
+        response = await self.client.get("schedules/", params=params)
         return ScheduleList.from_dict(response)
 
     async def get(self, schedule_id: str) -> Schedule:

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk/voice.py

@@ -176,7 +176,7 @@ class VoiceManager:
         Returns:
             Dict with models, voices, limits, and default config.
         """
-        return await self._client.get("voice/config")
+        return await self._client._make_request("GET", "voice/config", _url_prefix="/api/v1")
 
     async def get_sessions(self) -> List[Dict[str, Any]]:
         """
@@ -185,8 +185,14 @@ class VoiceManager:
         Returns:
             List of active voice session info dicts.
         """
-        result = await self._client.get("voice/sessions")
-        return result.get("sessions", [])
+        result = await self._client._make_request("GET", "voice/sessions", _url_prefix="/api/v1")
+        # Backend (>= 2026.05.13) returns {"sessions": [...], "total": N}
+        if isinstance(result, dict):
+            return result.get("sessions", [])
+        # Bare-list fallback for older backends
+        if isinstance(result, list):
+            return result
+        return []
 
     async def get_stats(self) -> Dict[str, Any]:
         """
@@ -195,7 +201,7 @@ class VoiceManager:
         Returns:
             Dict with active sessions count, total, and capacity info.
         """
-        return await self._client.get("voice/stats")
+        return await self._client._make_request("GET", "voice/stats", _url_prefix="/api/v1")
 
     async def health(self) -> Dict[str, Any]:
         """
@@ -204,7 +210,7 @@ class VoiceManager:
         Returns:
             Dict with health status and component checks.
         """
-        return await self._client.get("voice/health")
+        return await self._client._make_request("GET", "voice/health", _url_prefix="/api/v1")
 
     # ── Socket.IO session management ────────────────────────
 

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/fleeks_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fleeks-sdk
-Version: 0.7.0
+Version: 0.7.2
 Summary: Python SDK for the Fleeks AI Development Platform
 Author-email: Fleeks Inc <support@fleeks.com>
 License: MIT
@@ -86,6 +86,8 @@ Fleeks is a revolutionary AI-powered development platform that provides instant
 pip install fleeks-sdk
 ```
 
+For the best compatibility with API key metadata, usage stats, voice, and preview routes, use Fleeks backend `2026.05.13` or newer. The SDK includes fallbacks for older backends where possible.
+
 ## 🚀 Quick Start
 
 ```python

{fleeks_sdk-0.7.0 → fleeks_sdk-0.7.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fleeks-sdk"
-version = "0.7.0"
+version = "0.7.2"
 description = "Python SDK for the Fleeks AI Development Platform"
 readme = "README.md"
 license = {text = "MIT"}