thunderphone 0.1.0__py3-none-any.whl

thunderphone/__init__.py

@@ -0,0 +1,6 @@
+"""Official ThunderPhone client and common request types."""
+from .facade import ThunderPhone, ThunderPhoneError
+from .generated.models.agent_request import AgentRequest
+from .generated.models.place_call_request import PlaceCallRequest
+
+__all__ = ["ThunderPhone", "ThunderPhoneError", "AgentRequest", "PlaceCallRequest"]

thunderphone/facade.py

@@ -0,0 +1,137 @@
+"""Small synchronous facade; every endpoint also has generated sync/async clients."""
+
+from __future__ import annotations
+
+import math
+import os
+import time
+from typing import TypeVar
+from urllib.parse import urlsplit
+
+import httpx
+
+from .generated.api.agents import agents_create
+from .generated.api.calls import calls_place, calls_retrieve, calls_transcript_list
+from .generated.client import AuthenticatedClient
+from .generated.models.agent import Agent
+from .generated.models.agent_request import AgentRequest
+from .generated.models.call import Call
+from .generated.models.call_transcript import CallTranscript
+from .generated.models.place_call_request import PlaceCallRequest
+from .generated.models.place_call_response import PlaceCallResponse
+from .generated.types import Response
+
+T = TypeVar("T")
+
+
+class ThunderPhoneError(Exception):
+    def __init__(self, status: int, body: bytes):
+        self.status = status
+        self.body = body
+        super().__init__(f"ThunderPhone API returned HTTP {status}")
+
+
+def _unwrap(response: Response[T]) -> T:
+    if not 200 <= response.status_code < 300:
+        raise ThunderPhoneError(response.status_code, response.content)
+    if response.parsed is None:
+        raise ValueError("ThunderPhone returned an empty success response")
+    return response.parsed
+
+
+class _Agents:
+    def __init__(self, client: AuthenticatedClient):
+        self._client = client
+
+    def create(self, body: AgentRequest) -> Agent:
+        return _unwrap(agents_create.sync_detailed(client=self._client, body=body))
+
+
+class _Calls:
+    def __init__(self, client: AuthenticatedClient):
+        self._client = client
+
+    def place(self, body: PlaceCallRequest) -> PlaceCallResponse:
+        return _unwrap(calls_place.sync_detailed(client=self._client, body=body))
+
+    def get(self, call_id: int) -> Call:
+        return _unwrap(calls_retrieve.sync_detailed(call_id, client=self._client))
+
+    def transcript(self, call_id: int) -> CallTranscript:
+        return _unwrap(
+            calls_transcript_list.sync_detailed(call_id, client=self._client)
+        )
+
+    def wait_for_completion(
+        self, call_id: int, *, timeout: float = 300, poll_interval: float = 1
+    ) -> Call:
+        """Poll completed/failed states. Never retries a mutating request.
+
+        timeout bounds polling; individual HTTP operations have a timeout no
+        larger than the remaining budget. Network timeout errors propagate.
+        """
+        if (
+            not math.isfinite(timeout)
+            or timeout <= 0
+            or not math.isfinite(poll_interval)
+            or poll_interval <= 0
+        ):
+            raise ValueError(
+                "timeout and poll_interval must be positive finite numbers"
+            )
+        deadline = time.monotonic() + timeout
+        while True:
+            remaining = deadline - time.monotonic()
+            if remaining <= 0:
+                raise TimeoutError(f"Timed out waiting for call {call_id}")
+            response = self._client.get_httpx_client().get(
+                f"/v1/calls/{call_id}", timeout=min(30, remaining)
+            )
+            if not response.is_success:
+                raise ThunderPhoneError(response.status_code, response.content)
+            call = Call.from_dict(response.json())
+            if call.status in {"completed", "failed"}:
+                return call
+            time.sleep(min(poll_interval, max(0, deadline - time.monotonic())))
+
+
+class ThunderPhone:
+    def __init__(
+        self,
+        api_key: str | None = None,
+        *,
+        base_url: str = "https://api.thunderphone.com",
+        timeout: float = 30,
+    ):
+        key = api_key if api_key is not None else os.environ.get("THUNDERPHONE_API_KEY")
+        if not key or not key.strip():
+            raise ValueError("Set THUNDERPHONE_API_KEY or provide api_key")
+        parsed = urlsplit(base_url)
+        if (
+            parsed.scheme not in {"http", "https"}
+            or not parsed.netloc
+            or parsed.username
+            or parsed.password
+            or parsed.query
+            or parsed.fragment
+        ):
+            raise ValueError(
+                "base_url must be an HTTP(S) URL without credentials, query, or fragment"
+            )
+        self.client = AuthenticatedClient(
+            base_url=base_url.rstrip("/"),
+            token=key,
+            headers={"X-ThunderPhone-Client": "sdk-python/0.1.0"},
+            timeout=httpx.Timeout(timeout),
+        )
+        self.agents = _Agents(self.client)
+        self.calls = _Calls(self.client)
+
+    def close(self) -> None:
+        self.client.get_httpx_client().close()
+
+    def __enter__(self) -> ThunderPhone:
+        return self
+
+    def __exit__(self, *_args) -> None:
+        self.close()

thunderphone/generated/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing ThunderPhone API"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

thunderphone/generated/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

thunderphone/generated/api/agent_imports/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

thunderphone/generated/api/agent_imports/agent_imports_commit.py

@@ -0,0 +1,186 @@
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+from uuid import UUID
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.agent_import import AgentImport
+from ...models.agent_imports_commit_body import AgentImportsCommitBody
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    public_id: UUID,
+    *,
+    body: AgentImportsCommitBody | Unset = UNSET,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/v1/agent-imports/{public_id}/commit".format(
+            public_id=quote(str(public_id), safe=""),
+        ),
+    }
+
+    if not isinstance(body, Unset):
+        _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> AgentImport | None:
+    if response.status_code == 202:
+        response_202 = AgentImport.from_dict(response.json())
+
+        return response_202
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[AgentImport]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    public_id: UUID,
+    *,
+    client: AuthenticatedClient,
+    body: AgentImportsCommitBody | Unset = UNSET,
+) -> Response[AgentImport]:
+    """Create or run agent imports / commit. Parameters and returned fields are described below;
+    organization-scoped resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        public_id (UUID):
+        body (AgentImportsCommitBody | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AgentImport]
+    """
+
+    kwargs = _get_kwargs(
+        public_id=public_id,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    public_id: UUID,
+    *,
+    client: AuthenticatedClient,
+    body: AgentImportsCommitBody | Unset = UNSET,
+) -> AgentImport | None:
+    """Create or run agent imports / commit. Parameters and returned fields are described below;
+    organization-scoped resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        public_id (UUID):
+        body (AgentImportsCommitBody | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AgentImport
+    """
+
+    return sync_detailed(
+        public_id=public_id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    public_id: UUID,
+    *,
+    client: AuthenticatedClient,
+    body: AgentImportsCommitBody | Unset = UNSET,
+) -> Response[AgentImport]:
+    """Create or run agent imports / commit. Parameters and returned fields are described below;
+    organization-scoped resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        public_id (UUID):
+        body (AgentImportsCommitBody | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AgentImport]
+    """
+
+    kwargs = _get_kwargs(
+        public_id=public_id,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    public_id: UUID,
+    *,
+    client: AuthenticatedClient,
+    body: AgentImportsCommitBody | Unset = UNSET,
+) -> AgentImport | None:
+    """Create or run agent imports / commit. Parameters and returned fields are described below;
+    organization-scoped resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        public_id (UUID):
+        body (AgentImportsCommitBody | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AgentImport
+    """
+
+    return (
+        await asyncio_detailed(
+            public_id=public_id,
+            client=client,
+            body=body,
+        )
+    ).parsed

thunderphone/generated/api/agent_imports/agent_imports_create.py

@@ -0,0 +1,168 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.agent_import import AgentImport
+from ...models.agent_import_create_request import AgentImportCreateRequest
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: AgentImportCreateRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/v1/agent-imports",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> AgentImport | None:
+    if response.status_code == 201:
+        response_201 = AgentImport.from_dict(response.json())
+
+        return response_201
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[AgentImport]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: AgentImportCreateRequest,
+) -> Response[AgentImport]:
+    """Create or run agent imports. Parameters and returned fields are described below; organization-scoped
+    resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        body (AgentImportCreateRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AgentImport]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+    body: AgentImportCreateRequest,
+) -> AgentImport | None:
+    """Create or run agent imports. Parameters and returned fields are described below; organization-scoped
+    resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        body (AgentImportCreateRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AgentImport
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: AgentImportCreateRequest,
+) -> Response[AgentImport]:
+    """Create or run agent imports. Parameters and returned fields are described below; organization-scoped
+    resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        body (AgentImportCreateRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AgentImport]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+    body: AgentImportCreateRequest,
+) -> AgentImport | None:
+    """Create or run agent imports. Parameters and returned fields are described below; organization-scoped
+    resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        body (AgentImportCreateRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AgentImport
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed

thunderphone/generated/api/agent_imports/agent_imports_delete.py

@@ -0,0 +1,107 @@
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+from uuid import UUID
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...types import Response
+
+
+def _get_kwargs(
+    public_id: UUID,
+) -> dict[str, Any]:
+
+    _kwargs: dict[str, Any] = {
+        "method": "delete",
+        "url": "/v1/agent-imports/{public_id}".format(
+            public_id=quote(str(public_id), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Any | None:
+    if response.status_code == 204:
+        return None
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[Any]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    public_id: UUID,
+    *,
+    client: AuthenticatedClient,
+) -> Response[Any]:
+    """Delete agent imports. Parameters and returned fields are described below; organization-scoped
+    resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        public_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+    """
+
+    kwargs = _get_kwargs(
+        public_id=public_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio_detailed(
+    public_id: UUID,
+    *,
+    client: AuthenticatedClient,
+) -> Response[Any]:
+    """Delete agent imports. Parameters and returned fields are described below; organization-scoped
+    resources use the organization associated with the authenticated credential. See
+    https://thunderphone.com/docs for usage and access requirements.
+
+    Args:
+        public_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+    """
+
+    kwargs = _get_kwargs(
+        public_id=public_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)