wiil-python 0.0.6__tar.gz → 0.0.9__tar.gz

{wiil_python-0.0.6 → wiil_python-0.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wiil-python
-Version: 0.0.6
+Version: 0.0.9
 Summary: Official Python SDK for WIIL Platform - AI-powered conversational services for intelligent customer interactions, voice processing, real-time translation, and business management
 Author-email: WIIL <dev-support@wiil.io>
 License: MIT

{wiil_python-0.0.6 → wiil_python-0.0.9}/pyproject.toml

@@ -1,136 +1,136 @@
-[build-system]
-requires = ["setuptools>=68.0", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "wiil-python"
-version = "0.0.6"
-description = "Official Python SDK for WIIL Platform - AI-powered conversational services for intelligent customer interactions, voice processing, real-time translation, and business management"
-readme = "README.md"
-requires-python = ">=3.8"
-license = {text = "MIT"}
-authors = [
-    {name = "WIIL", email = "dev-support@wiil.io"}
-]
-keywords = [
-    "wiil",
-    "wiil-platform",
-    "wiil-sdk",
-    "ai",
-    "artificial-intelligence",
-    "conversational-ai",
-    "chatbot",
-    "voice-ai",
-    "speech-to-text",
-    "text-to-speech",
-    "stt",
-    "tts",
-    "translation",
-    "real-time-translation",
-    "voice-translation",
-    "business-automation",
-    "appointment-booking",
-    "reservation-system",
-    "order-management",
-    "customer-service",
-    "telephony",
-    "voice-calls",
-    "agent-deployment",
-    "python",
-    "sdk"
-]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Topic :: Software Development :: Libraries :: Python Modules",
-    "Typing :: Typed",
-]
-dependencies = [
-    "requests>=2.31.0",
-    "pydantic>=2.0.0,<3.0.0",
-    "email-validator>=2.0.0",
-    "typing-extensions>=4.5.0; python_version < '3.11'",
-]
-
-[project.optional-dependencies]
-dev = [
-    "pytest>=7.0.0",
-    "pytest-asyncio>=0.21.0",
-    "pytest-cov>=4.0.0",
-    "httpx>=0.28.0",
-    "responses>=0.25.0",
-    "black>=23.0.0",
-    "ruff>=0.1.0",
-    "mypy>=1.0.0",
-    "respx>=0.20.0",
-]
-
-[project.urls]
-Homepage = "https://console.wiil.io"
-Documentation = "https://docs.wiil.io"
-Repository = "https://github.com/wiil-io/wiil-python"
-Issues = "https://github.com/wiil-io/wiil-python/issues"
-
-[tool.setuptools]
-packages = { find = { include = ["wiil", "wiil.*"] } }
-
-[tool.setuptools.package-data]
-wiil = ["py.typed"]
-
-[tool.black]
-line-length = 100
-target-version = ["py38", "py39", "py310", "py311", "py312"]
-
-[tool.ruff]
-line-length = 100
-target-version = "py38"
-select = [
-    "E",  # pycodestyle errors
-    "W",  # pycodestyle warnings
-    "F",  # pyflakes
-    "I",  # isort
-    "B",  # flake8-bugbear
-    "C4", # flake8-comprehensions
-    "UP", # pyupgrade
-]
-ignore = [
-    "E501", # line too long (handled by black)
-    "B008", # do not perform function calls in argument defaults
-]
-
-[tool.ruff.per-file-ignores]
-"__init__.py" = ["F401"]
-
-[tool.mypy]
-python_version = "3.8"
-strict = true
-warn_return_any = true
-warn_unused_configs = true
-disallow_untyped_defs = true
-disallow_any_unimported = false
-no_implicit_optional = true
-warn_redundant_casts = true
-warn_unused_ignores = true
-warn_no_return = true
-check_untyped_defs = true
-strict_equality = true
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-python_files = ["test_*.py"]
-python_classes = ["Test*"]
-python_functions = ["test_*"]
-asyncio_mode = "auto"
-addopts = [
-    "--strict-markers",
-    "--cov=wiil",
-    "--cov-report=term-missing",
-    "--cov-report=html",
-]
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wiil-python"
+version = "0.0.9"
+description = "Official Python SDK for WIIL Platform - AI-powered conversational services for intelligent customer interactions, voice processing, real-time translation, and business management"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "WIIL", email = "dev-support@wiil.io"}
+]
+keywords = [
+    "wiil",
+    "wiil-platform",
+    "wiil-sdk",
+    "ai",
+    "artificial-intelligence",
+    "conversational-ai",
+    "chatbot",
+    "voice-ai",
+    "speech-to-text",
+    "text-to-speech",
+    "stt",
+    "tts",
+    "translation",
+    "real-time-translation",
+    "voice-translation",
+    "business-automation",
+    "appointment-booking",
+    "reservation-system",
+    "order-management",
+    "customer-service",
+    "telephony",
+    "voice-calls",
+    "agent-deployment",
+    "python",
+    "sdk"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "requests>=2.31.0",
+    "pydantic>=2.0.0,<3.0.0",
+    "email-validator>=2.0.0",
+    "typing-extensions>=4.5.0; python_version < '3.11'",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "httpx>=0.28.0",
+    "responses>=0.25.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+    "respx>=0.20.0",
+]
+
+[project.urls]
+Homepage = "https://console.wiil.io"
+Documentation = "https://docs.wiil.io"
+Repository = "https://github.com/wiil-io/wiil-python"
+Issues = "https://github.com/wiil-io/wiil-python/issues"
+
+[tool.setuptools]
+packages = { find = { include = ["wiil", "wiil.*"] } }
+
+[tool.setuptools.package-data]
+wiil = ["py.typed"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311", "py312"]
+
+[tool.ruff]
+line-length = 100
+target-version = "0.0.9"
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgrade
+]
+ignore = [
+    "E501", # line too long (handled by black)
+    "B008", # do not perform function calls in argument defaults
+]
+
+[tool.ruff.per-file-ignores]
+"__init__.py" = ["F401"]
+
+[tool.mypy]
+python_version = "0.0.9"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_any_unimported = false
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+check_untyped_defs = true
+strict_equality = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+asyncio_mode = "auto"
+addopts = [
+    "--strict-markers",
+    "--cov=wiil",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+]

{wiil_python-0.0.6 → wiil_python-0.0.9}/wiil/models/request/paginated_result.py

@@ -32,7 +32,7 @@ class PaginationMeta(BaseModel):
     page: int = Field(..., gt=0, description="Current page number (1-based indexing)")
     page_size: int = Field(
         ...,
-        gt=0,
+        ge=0,
         le=1000,
         description="Number of items per page - limited to 1000 for performance",
         alias="pageSize"

{wiil_python-0.0.6 → wiil_python-0.0.9}/wiil/resources/service_mgt/__init__.py

@@ -21,6 +21,7 @@ from wiil.resources.service_mgt.support_models import SupportModelsResource
 from wiil.resources.service_mgt.telephony_provider import TelephonyProviderResource
 from wiil.resources.service_mgt.dynamic_agent_status import (
     DynamicAgentStatusResource,
+    PollOptions,
     PollTimeoutError,
 )
 from wiil.resources.service_mgt.dynamic_web_agent import (
@@ -45,6 +46,7 @@ __all__ = [
     'SupportModelsResource',
     'TelephonyProviderResource',
     'DynamicAgentStatusResource',
+    'PollOptions',
     'PollTimeoutError',
     'DynamicWebAgentResource',
     'WebAgentCreateOptions',

wiil_python-0.0.9/wiil/resources/service_mgt/dynamic_agent_status.py

@@ -0,0 +1,224 @@
+"""Dynamic Agent Status resource for polling agent setup progress.
+
+This module provides functionality for checking and polling the status of
+dynamic agent setup operations. Supports both phone and web agent configurations.
+"""
+
+import time
+from dataclasses import dataclass
+from typing import Callable, Optional, Union
+
+from wiil.client.http_client import HttpClient
+from wiil.models.service_mgt.dynamic_setup import (
+    DynamicAgentProcessingState,
+    DynamicAgentSetupResult,
+)
+from wiil.models.service_mgt.dynamic_setup.phone_agent_setup import (
+    DynamicPhoneAgentSetupResult,
+)
+from wiil.models.service_mgt.dynamic_setup.web_agent_setup import (
+    DynamicWebAgentSetupResult,
+)
+
+
+@dataclass
+class PollOptions:
+    """Options for configuring long-polling behavior.
+
+    Attributes:
+        interval: Polling interval in milliseconds. Defaults to 5000.
+        timeout: Maximum wait time in milliseconds before timing out. Defaults to 120000.
+        on_progress: Callback invoked on each poll with current state.
+    """
+
+    interval: int = 5000
+    timeout: int = 120000
+    on_progress: Optional[Callable[[DynamicAgentProcessingState], None]] = None
+
+
+class PollTimeoutError(Exception):
+    """Error thrown when polling times out before completion.
+
+    Attributes:
+        last_state: The last known processing state before timeout.
+    """
+
+    def __init__(self, message: str, last_state: DynamicAgentProcessingState):
+        super().__init__(message)
+        self.last_state = last_state
+
+
+class DynamicAgentStatusResource:
+    """Resource class for polling dynamic agent setup status.
+
+    Provides methods for checking and polling the status of dynamic agent setup
+    operations. Supports both phone and web agent configurations. Use this resource
+    to track long-running setup operations and wait for completion.
+
+    Example:
+        ```python
+        from wiil import WiilClient
+        from wiil.models.service_mgt import BusinessSupportServices
+
+        client = WiilClient(api_key='your-api-key')
+
+        # Create a dynamic agent (returns immediately)
+        result = client.dynamic_phone_agent.create(
+            DynamicPhoneAgentSetup(
+                assistant_name='Support Agent',
+                capabilities=[BusinessSupportServices.APPOINTMENT_MANAGEMENT],
+            )
+        )
+
+        # Poll until setup completes
+        def on_progress(state):
+            print(f'{state.progress_percentage}% - {state.message}')
+
+        final = client.dynamic_agent_status.poll(
+            result.id,
+            PollOptions(
+                interval=2000,
+                timeout=60000,
+                on_progress=on_progress,
+            )
+        )
+
+        if final.success:
+            print('Agent ready:', final.agent_configuration_id)
+        ```
+    """
+
+    def __init__(self, http: HttpClient):
+        """Creates a new DynamicAgentStatusResource instance.
+
+        Args:
+            http: HTTP client for API communication
+        """
+        self._http = http
+        self._base_path = '/dynamic-setup'
+
+    def get(
+        self, id: str
+    ) -> Union[DynamicAgentSetupResult, DynamicWebAgentSetupResult, DynamicPhoneAgentSetupResult]:
+        """Retrieves the current status of a dynamic agent setup operation.
+
+        Args:
+            id: Dynamic agent setup ID
+
+        Returns:
+            The setup result (base, web, or phone agent type)
+
+        Raises:
+            WiilAPIError: When the setup ID is not found or API returns an error
+            WiilNetworkError: When network communication fails
+
+        Example:
+            ```python
+            status = client.dynamic_agent_status.get('setup_123')
+            print('Status:', status.processing_state.status)
+            print('Progress:', status.processing_state.progress_percentage)
+
+            # Access web agent specific properties
+            if hasattr(status, 'integration_snippets') and status.integration_snippets:
+                print('Snippets:', status.integration_snippets)
+
+            # Access phone agent specific properties
+            if hasattr(status, 'phone_number') and status.phone_number:
+                print('Phone:', status.phone_number)
+            ```
+        """
+        return self._http.get(
+            f'{self._base_path}/{id}',
+            response_model=DynamicAgentSetupResult
+        )
+
+    def poll(
+        self,
+        id: str,
+        options: Optional[PollOptions] = None
+    ) -> Union[DynamicAgentSetupResult, DynamicWebAgentSetupResult, DynamicPhoneAgentSetupResult]:
+        """Polls the status of a dynamic agent setup until completion or failure.
+
+        Args:
+            id: Dynamic agent setup ID
+            options: Polling configuration options
+
+        Returns:
+            The final setup result (base, web, or phone agent type)
+
+        Raises:
+            PollTimeoutError: When polling times out before completion
+            WiilAPIError: When the setup ID is not found or API returns an error
+            WiilNetworkError: When network communication fails
+
+        Remarks:
+            This method will continuously poll the API until the processing state
+            reaches 'completed' or 'failed'. If the timeout is reached before
+            completion, a PollTimeoutError is thrown containing the last known state.
+
+        Example:
+            ```python
+            from wiil.resources.service_mgt import PollOptions, PollTimeoutError
+
+            try:
+                def on_progress(state):
+                    print(f'Progress: {state.progress_percentage}%')
+
+                result = client.dynamic_agent_status.poll(
+                    'setup_123',
+                    PollOptions(
+                        interval=5000,
+                        timeout=120000,
+                        on_progress=on_progress,
+                    )
+                )
+
+                if result.success:
+                    print('Agent ID:', result.agent_configuration_id)
+
+                    # Web agent: access integration snippets
+                    if hasattr(result, 'integration_snippets') and result.integration_snippets:
+                        print('Snippets:', result.integration_snippets)
+
+                    # Phone agent: access phone number
+                    if hasattr(result, 'phone_number') and result.phone_number:
+                        print('Phone:', result.phone_number)
+
+            except PollTimeoutError as e:
+                print(f'Polling timed out at: {e.last_state.progress_percentage}%')
+            ```
+        """
+        opts = options or PollOptions()
+        interval = opts.interval
+        timeout = opts.timeout
+        on_progress = opts.on_progress
+
+        start_time = time.time() * 1000  # Convert to milliseconds
+        last_state: Optional[DynamicAgentProcessingState] = None
+
+        while True:
+            result = self.get(id)
+            last_state = result.processing_state
+
+            # Invoke progress callback if provided
+            if on_progress:
+                on_progress(result.processing_state)
+
+            # Check for terminal states
+            if result.processing_state.status in ('completed', 'failed'):
+                return result
+
+            # Check for timeout
+            elapsed = (time.time() * 1000) - start_time
+            if elapsed >= timeout:
+                raise PollTimeoutError(
+                    f'Polling timed out after {timeout}ms. '
+                    f'Last status: {last_state.status} at {last_state.progress_percentage}%',
+                    last_state
+                )
+
+            # Wait before next poll
+            time.sleep(interval / 1000)  # Convert to seconds
+
+
+__all__ = ['DynamicAgentStatusResource', 'PollOptions', 'PollTimeoutError']