wiil-python 0.0.0__tar.gz → 0.0.2__tar.gz

{wiil_python-0.0.0 → wiil_python-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wiil-python
-Version: 0.0.0
+Version: 0.0.2
 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
@@ -82,7 +82,7 @@ venv\Scripts\activate
 ### 2. Install the SDK
 
 ```bash
-pip install wiil
+pip install wiil-python
 ```
 
 ## Quick Start
@@ -169,6 +169,7 @@ The platform integrates two core architectural domains through the **Conversatio
 |--------|----------------|---------------------|
 | **Appointment Management** | Business Services | Service Appointments |
 | **Reservation Management** | Reservable Assets (Resources) | Reservations |
+| **Property Management** | Properties & Listings | Property Inquiries |
 | **Menu Management** | Menu Categories & Items | Menu Orders |
 | **Product Management** | Product Categories & Products | Product Orders |
 
@@ -176,6 +177,7 @@ The platform integrates two core architectural domains through the **Conversatio
 
 - **Business Services** - Bookable services (salons, clinics, consulting)
 - **Reservable Assets** - Bookable resources (tables, rooms, equipment)
+- **Properties & Listings** - Managed properties and listing availability data
 - **Menu Categories & Items** - Food and beverage offerings
 - **Product Categories & Products** - Retail products
 
@@ -183,10 +185,11 @@ The platform integrates two core architectural domains through the **Conversatio
 
 - **Service Appointments** - Created through AI conversations
 - **Reservations** - Created through AI conversations
+- **Property Inquiries** - Created through AI conversations
 - **Menu Orders** - Created through AI conversations
 - **Product Orders** - Created through AI conversations
 
-**SDK Resources**: `business_services`, `reservation_resources`, `menus`, `products`, `customers`, `service_appointments`, `reservations`, `menu_orders`, `product_orders`
+**SDK Resources**: `business_services`, `reservation_resources`, `property_config`, `property_inquiry`, `menus`, `products`, `customers`, `service_appointments`, `reservations`, `menu_orders`, `product_orders`
 
 ### Integration Hub: Conversations
 
@@ -241,7 +244,8 @@ The **Conversations** entity serves as the central integration point, bridging S
          ↓
 6. Transaction Created
    • Service Appointment
-   • Reservation
+    • Reservation
+    • Property Inquiry
    • Menu Order
    • Product Order
          ↓
@@ -264,7 +268,125 @@ The **Conversations** entity serves as the central integration point, bridging S
 
 ## Usage Examples
 
-### Account Management
+### 1. Dynamic Agent Setup (Recommended)
+
+The Dynamic Agent Setup APIs are the fastest way to deploy agents. Instead of creating each service-management component separately, you can provision a deployable assistant in one call.
+
+#### Phone Agent - Single Call Deployment
+
+```python
+from wiil import WiilClient
+from wiil.models.service_mgt.dynamic_setup import DynamicPhoneAgentSetup
+from wiil.types import BusinessSupportServices
+
+client = WiilClient(api_key="your-api-key")
+
+result = client.dynamic_phone_agent.create(
+    DynamicPhoneAgentSetup(
+        assistant_name="Sarah",
+        language="en-US",
+        capabilities=[BusinessSupportServices.APPOINTMENT_MANAGEMENT],
+    )
+)
+
+print("Phone number:", result.phone_number)
+print("Agent ID:", result.agent_configuration_id)
+```
+
+#### Web Agent - Single Call Deployment
+
+```python
+from wiil import WiilClient
+from wiil.models.service_mgt.dynamic_setup import DynamicWebAgentSetup
+from wiil.types import BusinessSupportServices
+
+client = WiilClient(api_key="your-api-key")
+
+result = client.dynamic_web_agent.create(
+    DynamicWebAgentSetup(
+        assistant_name="Emma",
+        website_url="https://example.com",
+        communication_type="UNIFIED",
+        language="en-US",
+        capabilities=[BusinessSupportServices.APPOINTMENT_MANAGEMENT],
+    )
+)
+
+print("Integration snippets:", result.integration_snippets)
+print("Agent ID:", result.agent_configuration_id)
+```
+
+#### Dynamic Agent with Chained STT/TTS Configuration
+
+```python
+from wiil import WiilClient
+from wiil.models.service_mgt.dynamic_setup import DynamicWebAgentSetup
+from wiil.types import BusinessSupportServices
+
+client = WiilClient(api_key="your-api-key")
+
+result = client.dynamic_web_agent.create(
+    DynamicWebAgentSetup(
+        assistant_name="Marcus",
+        website_url="https://example.com",
+        communication_type="VOICE",
+        language="en-US",
+        capabilities=[
+            BusinessSupportServices.APPOINTMENT_MANAGEMENT,
+            BusinessSupportServices.PRODUCT_ORDER_MANAGEMENT,
+        ],
+        stt_configuration={
+            "provider_type": "Deepgram",
+            "provider_model_id": "nova-2",
+            "language_id": "en-US",
+        },
+        tts_configuration={
+            "provider_type": "ElevenLabs",
+            "provider_model_id": "eleven_turbo_v2",
+            "language_id": "en-US",
+            "voice_id": "voice_rachel",
+        },
+    )
+)
+
+print("Agent ID:", result.agent_configuration_id)
+```
+
+#### Dynamic Agent Operations
+
+```python
+from wiil import WiilClient
+from wiil.models.service_mgt.dynamic_setup import DynamicPhoneAgentSetup, UpdateDynamicPhoneAgent
+
+client = WiilClient(api_key="your-api-key")
+
+# Create
+created = client.dynamic_phone_agent.create(
+    DynamicPhoneAgentSetup(
+        assistant_name="Nathan",
+        language="en-US",
+        capabilities=[],
+    )
+)
+
+# Update (partial)
+updated = client.dynamic_phone_agent.update(
+    UpdateDynamicPhoneAgent(
+        id=created.id,
+        assistant_name="Nathan Updated",
+    )
+)
+
+# Delete
+deleted = client.dynamic_phone_agent.delete(created.id)
+print("Deleted:", deleted)
+```
+
+For full walkthroughs, see `../guides/dynamic-agent-setup-guide.md`.
+
+---
+
+### 2. Account Management
 
 ```python
 from wiil import WiilClient
@@ -297,7 +419,7 @@ deleted = client.projects.delete("proj_123")
 projects = client.projects.list(page=1, page_size=20)
 ```
 
-### Service Configuration
+### 3. Service Configuration
 
 ```python
 # Create an agent configuration
@@ -313,7 +435,7 @@ agent = client.agent_configs.get("agent_123")
 agents = client.agent_configs.list(page=1, page_size=20)
 ```
 
-### Business Management
+### 4. Business Management
 
 ```python
 # Create a business service

{wiil_python-0.0.0 → wiil_python-0.0.2}/README.md

@@ -43,7 +43,7 @@ venv\Scripts\activate
 ### 2. Install the SDK
 
 ```bash
-pip install wiil
+pip install wiil-python
 ```
 
 ## Quick Start
@@ -130,6 +130,7 @@ The platform integrates two core architectural domains through the **Conversatio
 |--------|----------------|---------------------|
 | **Appointment Management** | Business Services | Service Appointments |
 | **Reservation Management** | Reservable Assets (Resources) | Reservations |
+| **Property Management** | Properties & Listings | Property Inquiries |
 | **Menu Management** | Menu Categories & Items | Menu Orders |
 | **Product Management** | Product Categories & Products | Product Orders |
 
@@ -137,6 +138,7 @@ The platform integrates two core architectural domains through the **Conversatio
 
 - **Business Services** - Bookable services (salons, clinics, consulting)
 - **Reservable Assets** - Bookable resources (tables, rooms, equipment)
+- **Properties & Listings** - Managed properties and listing availability data
 - **Menu Categories & Items** - Food and beverage offerings
 - **Product Categories & Products** - Retail products
 
@@ -144,10 +146,11 @@ The platform integrates two core architectural domains through the **Conversatio
 
 - **Service Appointments** - Created through AI conversations
 - **Reservations** - Created through AI conversations
+- **Property Inquiries** - Created through AI conversations
 - **Menu Orders** - Created through AI conversations
 - **Product Orders** - Created through AI conversations
 
-**SDK Resources**: `business_services`, `reservation_resources`, `menus`, `products`, `customers`, `service_appointments`, `reservations`, `menu_orders`, `product_orders`
+**SDK Resources**: `business_services`, `reservation_resources`, `property_config`, `property_inquiry`, `menus`, `products`, `customers`, `service_appointments`, `reservations`, `menu_orders`, `product_orders`
 
 ### Integration Hub: Conversations
 
@@ -202,7 +205,8 @@ The **Conversations** entity serves as the central integration point, bridging S
          ↓
 6. Transaction Created
    • Service Appointment
-   • Reservation
+    • Reservation
+    • Property Inquiry
    • Menu Order
    • Product Order
          ↓
@@ -225,7 +229,125 @@ The **Conversations** entity serves as the central integration point, bridging S
 
 ## Usage Examples
 
-### Account Management
+### 1. Dynamic Agent Setup (Recommended)
+
+The Dynamic Agent Setup APIs are the fastest way to deploy agents. Instead of creating each service-management component separately, you can provision a deployable assistant in one call.
+
+#### Phone Agent - Single Call Deployment
+
+```python
+from wiil import WiilClient
+from wiil.models.service_mgt.dynamic_setup import DynamicPhoneAgentSetup
+from wiil.types import BusinessSupportServices
+
+client = WiilClient(api_key="your-api-key")
+
+result = client.dynamic_phone_agent.create(
+    DynamicPhoneAgentSetup(
+        assistant_name="Sarah",
+        language="en-US",
+        capabilities=[BusinessSupportServices.APPOINTMENT_MANAGEMENT],
+    )
+)
+
+print("Phone number:", result.phone_number)
+print("Agent ID:", result.agent_configuration_id)
+```
+
+#### Web Agent - Single Call Deployment
+
+```python
+from wiil import WiilClient
+from wiil.models.service_mgt.dynamic_setup import DynamicWebAgentSetup
+from wiil.types import BusinessSupportServices
+
+client = WiilClient(api_key="your-api-key")
+
+result = client.dynamic_web_agent.create(
+    DynamicWebAgentSetup(
+        assistant_name="Emma",
+        website_url="https://example.com",
+        communication_type="UNIFIED",
+        language="en-US",
+        capabilities=[BusinessSupportServices.APPOINTMENT_MANAGEMENT],
+    )
+)
+
+print("Integration snippets:", result.integration_snippets)
+print("Agent ID:", result.agent_configuration_id)
+```
+
+#### Dynamic Agent with Chained STT/TTS Configuration
+
+```python
+from wiil import WiilClient
+from wiil.models.service_mgt.dynamic_setup import DynamicWebAgentSetup
+from wiil.types import BusinessSupportServices
+
+client = WiilClient(api_key="your-api-key")
+
+result = client.dynamic_web_agent.create(
+    DynamicWebAgentSetup(
+        assistant_name="Marcus",
+        website_url="https://example.com",
+        communication_type="VOICE",
+        language="en-US",
+        capabilities=[
+            BusinessSupportServices.APPOINTMENT_MANAGEMENT,
+            BusinessSupportServices.PRODUCT_ORDER_MANAGEMENT,
+        ],
+        stt_configuration={
+            "provider_type": "Deepgram",
+            "provider_model_id": "nova-2",
+            "language_id": "en-US",
+        },
+        tts_configuration={
+            "provider_type": "ElevenLabs",
+            "provider_model_id": "eleven_turbo_v2",
+            "language_id": "en-US",
+            "voice_id": "voice_rachel",
+        },
+    )
+)
+
+print("Agent ID:", result.agent_configuration_id)
+```
+
+#### Dynamic Agent Operations
+
+```python
+from wiil import WiilClient
+from wiil.models.service_mgt.dynamic_setup import DynamicPhoneAgentSetup, UpdateDynamicPhoneAgent
+
+client = WiilClient(api_key="your-api-key")
+
+# Create
+created = client.dynamic_phone_agent.create(
+    DynamicPhoneAgentSetup(
+        assistant_name="Nathan",
+        language="en-US",
+        capabilities=[],
+    )
+)
+
+# Update (partial)
+updated = client.dynamic_phone_agent.update(
+    UpdateDynamicPhoneAgent(
+        id=created.id,
+        assistant_name="Nathan Updated",
+    )
+)
+
+# Delete
+deleted = client.dynamic_phone_agent.delete(created.id)
+print("Deleted:", deleted)
+```
+
+For full walkthroughs, see `../guides/dynamic-agent-setup-guide.md`.
+
+---
+
+### 2. Account Management
 
 ```python
 from wiil import WiilClient
@@ -258,7 +380,7 @@ deleted = client.projects.delete("proj_123")
 projects = client.projects.list(page=1, page_size=20)
 ```
 
-### Service Configuration
+### 3. Service Configuration
 
 ```python
 # Create an agent configuration
@@ -274,7 +396,7 @@ agent = client.agent_configs.get("agent_123")
 agents = client.agent_configs.list(page=1, page_size=20)
 ```
 
-### Business Management
+### 4. Business Management
 
 ```python
 # Create a business service

{wiil_python-0.0.0 → wiil_python-0.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wiil-python"
-version = "0.0.0"
+version = "0.0.2"
 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"
@@ -79,7 +79,7 @@ Repository = "https://github.com/wiil-io/wiil-python"
 Issues = "https://github.com/wiil-io/wiil-python/issues"
 
 [tool.setuptools]
-packages = ["wiil"]
+packages = { find = { include = ["wiil", "wiil.*"] } }
 
 [tool.setuptools.package-data]
 wiil = ["py.typed"]

wiil_python-0.0.2/setup.py

@@ -0,0 +1,8 @@
+"""Setup script for WIIL Python SDK."""
+from setuptools import find_packages, setup
+
+# Keep metadata in pyproject.toml while forcing reliable package discovery.
+setup(
+	packages=find_packages(include=["wiil", "wiil.*"]),
+	package_data={"wiil": ["py.typed"]},
+)

wiil_python-0.0.2/wiil/client/__init__.py

@@ -0,0 +1,17 @@
+"""WIIL SDK client module."""
+
+from wiil.client.types import WiilClientConfig, APIResponse, APIErrorResponse
+from wiil.client.http_client import HttpClient
+from wiil.client.async_wiil_client import AsyncWiilClient
+from wiil.client.will_service import WillService
+from wiil.client.wiil_client import WiilClient
+
+__all__ = [
+    'WiilClient',
+    'AsyncWiilClient',
+    'WillService',
+    'WiilClientConfig',
+    'HttpClient',
+    'APIResponse',
+    'APIErrorResponse',
+]

wiil_python-0.0.2/wiil/client/async_wiil_client.py

@@ -0,0 +1,80 @@
+"""Async WIIL SDK client.
+
+This module provides an async facade over the existing synchronous WIIL SDK
+resources. Resource method calls are executed in worker threads via
+``asyncio.to_thread`` so consumers can use ``await`` and async context
+managers.
+"""
+
+import asyncio
+from typing import Any
+
+from wiil.client.wiil_client import WiilClient
+
+
+class _AsyncResourceProxy:
+    """Async wrapper for a synchronous resource object."""
+
+    def __init__(self, target: Any):
+        self._target = target
+
+    def __getattr__(self, name: str) -> Any:
+        attribute = getattr(self._target, name)
+
+        if callable(attribute):
+            async def _async_call(*args: Any, **kwargs: Any) -> Any:
+                return await asyncio.to_thread(attribute, *args, **kwargs)
+
+            return _async_call
+
+        return attribute
+
+
+class AsyncWiilClient:
+    """Async client for interacting with the WIIL Platform API.
+
+    This client mirrors ``WiilClient`` properties while exposing resource
+    method calls as awaitable coroutines.
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://api.wiil.io/v1",
+        timeout: int = 30,
+    ):
+        self._sync_client = WiilClient(
+            api_key=api_key,
+            base_url=base_url,
+            timeout=timeout,
+        )
+
+        for name, value in vars(self._sync_client).items():
+            if name.startswith("_"):
+                continue
+            setattr(self, name, _AsyncResourceProxy(value))
+
+    def __getattr__(self, name: str) -> Any:
+        """Proxy any additional attributes to the underlying sync client."""
+        attribute = getattr(self._sync_client, name)
+
+        if callable(attribute):
+            async def _async_call(*args: Any, **kwargs: Any) -> Any:
+                return await asyncio.to_thread(attribute, *args, **kwargs)
+
+            return _async_call
+
+        return attribute
+
+    async def aclose(self) -> None:
+        """Close the underlying HTTP session."""
+        await asyncio.to_thread(self._sync_client._http.session.close)
+
+    async def __aenter__(self) -> "AsyncWiilClient":
+        return self
+
+    async def __aexit__(self, exc_type, exc, tb) -> None:
+        await self.aclose()
+
+
+__all__ = ["AsyncWiilClient"]