aiinbx 0.1.0__py3-none-any.whl

aiinbx/resources/threads.py

@@ -0,0 +1,343 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+from typing_extensions import Literal
+
+import httpx
+
+from ..types import thread_search_params
+from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._utils import maybe_transform, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.thread_search_response import ThreadSearchResponse
+from ..types.thread_retrieve_response import ThreadRetrieveResponse
+
+__all__ = ["ThreadsResource", "AsyncThreadsResource"]
+
+
+class ThreadsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> ThreadsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/aiinbx/aiinbx-py#accessing-raw-response-data-eg-headers
+        """
+        return ThreadsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> ThreadsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/aiinbx/aiinbx-py#with_streaming_response
+        """
+        return ThreadsResourceWithStreamingResponse(self)
+
+    def retrieve(
+        self,
+        thread_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> ThreadRetrieveResponse:
+        """
+        Retrieve a specific thread with all its emails by thread ID using API key
+        authentication
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not thread_id:
+            raise ValueError(f"Expected a non-empty value for `thread_id` but received {thread_id!r}")
+        return self._get(
+            f"/threads/{thread_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ThreadRetrieveResponse,
+        )
+
+    def search(
+        self,
+        *,
+        conversation_state: Literal["awaiting_reply", "needs_reply", "active", "stale"] | NotGiven = NOT_GIVEN,
+        created_after: str | NotGiven = NOT_GIVEN,
+        created_before: str | NotGiven = NOT_GIVEN,
+        has_email_from_address: str | NotGiven = NOT_GIVEN,
+        has_email_to_address: str | NotGiven = NOT_GIVEN,
+        has_participant_emails: List[str] | NotGiven = NOT_GIVEN,
+        last_email_after: str | NotGiven = NOT_GIVEN,
+        last_email_before: str | NotGiven = NOT_GIVEN,
+        limit: float | NotGiven = NOT_GIVEN,
+        offset: float | NotGiven = NOT_GIVEN,
+        some_email_has_direction: Literal["INBOUND", "OUTBOUND"] | NotGiven = NOT_GIVEN,
+        some_email_has_status: Literal[
+            "DRAFT",
+            "QUEUED",
+            "ACCEPTED",
+            "SENT",
+            "RECEIVED",
+            "FAILED",
+            "BOUNCED",
+            "COMPLAINED",
+            "REJECTED",
+            "READ",
+            "ARCHIVED",
+        ]
+        | NotGiven = NOT_GIVEN,
+        sort_by: Literal["createdAt", "lastEmailAt", "subject"] | NotGiven = NOT_GIVEN,
+        sort_order: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
+        stale_threshold_days: float | NotGiven = NOT_GIVEN,
+        subject_contains: str | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> ThreadSearchResponse:
+        """
+        Search threads with various filtering options optimized for AI agents
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/threads/search",
+            body=maybe_transform(
+                {
+                    "conversation_state": conversation_state,
+                    "created_after": created_after,
+                    "created_before": created_before,
+                    "has_email_from_address": has_email_from_address,
+                    "has_email_to_address": has_email_to_address,
+                    "has_participant_emails": has_participant_emails,
+                    "last_email_after": last_email_after,
+                    "last_email_before": last_email_before,
+                    "limit": limit,
+                    "offset": offset,
+                    "some_email_has_direction": some_email_has_direction,
+                    "some_email_has_status": some_email_has_status,
+                    "sort_by": sort_by,
+                    "sort_order": sort_order,
+                    "stale_threshold_days": stale_threshold_days,
+                    "subject_contains": subject_contains,
+                },
+                thread_search_params.ThreadSearchParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ThreadSearchResponse,
+        )
+
+
+class AsyncThreadsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncThreadsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/aiinbx/aiinbx-py#accessing-raw-response-data-eg-headers
+        """
+        return AsyncThreadsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncThreadsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/aiinbx/aiinbx-py#with_streaming_response
+        """
+        return AsyncThreadsResourceWithStreamingResponse(self)
+
+    async def retrieve(
+        self,
+        thread_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> ThreadRetrieveResponse:
+        """
+        Retrieve a specific thread with all its emails by thread ID using API key
+        authentication
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not thread_id:
+            raise ValueError(f"Expected a non-empty value for `thread_id` but received {thread_id!r}")
+        return await self._get(
+            f"/threads/{thread_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ThreadRetrieveResponse,
+        )
+
+    async def search(
+        self,
+        *,
+        conversation_state: Literal["awaiting_reply", "needs_reply", "active", "stale"] | NotGiven = NOT_GIVEN,
+        created_after: str | NotGiven = NOT_GIVEN,
+        created_before: str | NotGiven = NOT_GIVEN,
+        has_email_from_address: str | NotGiven = NOT_GIVEN,
+        has_email_to_address: str | NotGiven = NOT_GIVEN,
+        has_participant_emails: List[str] | NotGiven = NOT_GIVEN,
+        last_email_after: str | NotGiven = NOT_GIVEN,
+        last_email_before: str | NotGiven = NOT_GIVEN,
+        limit: float | NotGiven = NOT_GIVEN,
+        offset: float | NotGiven = NOT_GIVEN,
+        some_email_has_direction: Literal["INBOUND", "OUTBOUND"] | NotGiven = NOT_GIVEN,
+        some_email_has_status: Literal[
+            "DRAFT",
+            "QUEUED",
+            "ACCEPTED",
+            "SENT",
+            "RECEIVED",
+            "FAILED",
+            "BOUNCED",
+            "COMPLAINED",
+            "REJECTED",
+            "READ",
+            "ARCHIVED",
+        ]
+        | NotGiven = NOT_GIVEN,
+        sort_by: Literal["createdAt", "lastEmailAt", "subject"] | NotGiven = NOT_GIVEN,
+        sort_order: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
+        stale_threshold_days: float | NotGiven = NOT_GIVEN,
+        subject_contains: str | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> ThreadSearchResponse:
+        """
+        Search threads with various filtering options optimized for AI agents
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/threads/search",
+            body=await async_maybe_transform(
+                {
+                    "conversation_state": conversation_state,
+                    "created_after": created_after,
+                    "created_before": created_before,
+                    "has_email_from_address": has_email_from_address,
+                    "has_email_to_address": has_email_to_address,
+                    "has_participant_emails": has_participant_emails,
+                    "last_email_after": last_email_after,
+                    "last_email_before": last_email_before,
+                    "limit": limit,
+                    "offset": offset,
+                    "some_email_has_direction": some_email_has_direction,
+                    "some_email_has_status": some_email_has_status,
+                    "sort_by": sort_by,
+                    "sort_order": sort_order,
+                    "stale_threshold_days": stale_threshold_days,
+                    "subject_contains": subject_contains,
+                },
+                thread_search_params.ThreadSearchParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ThreadSearchResponse,
+        )
+
+
+class ThreadsResourceWithRawResponse:
+    def __init__(self, threads: ThreadsResource) -> None:
+        self._threads = threads
+
+        self.retrieve = to_raw_response_wrapper(
+            threads.retrieve,
+        )
+        self.search = to_raw_response_wrapper(
+            threads.search,
+        )
+
+
+class AsyncThreadsResourceWithRawResponse:
+    def __init__(self, threads: AsyncThreadsResource) -> None:
+        self._threads = threads
+
+        self.retrieve = async_to_raw_response_wrapper(
+            threads.retrieve,
+        )
+        self.search = async_to_raw_response_wrapper(
+            threads.search,
+        )
+
+
+class ThreadsResourceWithStreamingResponse:
+    def __init__(self, threads: ThreadsResource) -> None:
+        self._threads = threads
+
+        self.retrieve = to_streamed_response_wrapper(
+            threads.retrieve,
+        )
+        self.search = to_streamed_response_wrapper(
+            threads.search,
+        )
+
+
+class AsyncThreadsResourceWithStreamingResponse:
+    def __init__(self, threads: AsyncThreadsResource) -> None:
+        self._threads = threads
+
+        self.retrieve = async_to_streamed_response_wrapper(
+            threads.retrieve,
+        )
+        self.search = async_to_streamed_response_wrapper(
+            threads.search,
+        )

aiinbx/types/__init__.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .email_send_params import EmailSendParams as EmailSendParams
+from .email_reply_params import EmailReplyParams as EmailReplyParams
+from .email_send_response import EmailSendResponse as EmailSendResponse
+from .email_reply_response import EmailReplyResponse as EmailReplyResponse
+from .thread_search_params import ThreadSearchParams as ThreadSearchParams
+from .thread_search_response import ThreadSearchResponse as ThreadSearchResponse
+from .email_retrieve_response import EmailRetrieveResponse as EmailRetrieveResponse
+from .thread_retrieve_response import ThreadRetrieveResponse as ThreadRetrieveResponse

aiinbx/types/email_reply_params.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Union
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["EmailReplyParams"]
+
+
+class EmailReplyParams(TypedDict, total=False):
+    from_: Required[Annotated[str, PropertyInfo(alias="from")]]
+
+    html: Required[str]
+
+    bcc: Union[str, List[str]]
+
+    cc: Union[str, List[str]]
+
+    from_name: str
+
+    is_draft: bool
+
+    reply_all: bool
+
+    subject: str
+
+    text: str
+
+    to: Union[str, List[str]]

aiinbx/types/email_reply_response.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["EmailReplyResponse"]
+
+
+class EmailReplyResponse(BaseModel):
+    email_id: str = FieldInfo(alias="emailId")
+
+    message_id: str = FieldInfo(alias="messageId")
+
+    thread_id: str = FieldInfo(alias="threadId")

aiinbx/types/email_retrieve_response.py

@@ -0,0 +1,90 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["EmailRetrieveResponse", "Attachment"]
+
+
+class Attachment(BaseModel):
+    id: str
+
+    cid: Optional[str] = None
+
+    content_type: str = FieldInfo(alias="contentType")
+
+    created_at: str = FieldInfo(alias="createdAt")
+
+    disposition: Optional[str] = None
+
+    expires_at: str = FieldInfo(alias="expiresAt")
+
+    file_name: str = FieldInfo(alias="fileName")
+
+    signed_url: str = FieldInfo(alias="signedUrl")
+
+    size_in_bytes: float = FieldInfo(alias="sizeInBytes")
+
+
+class EmailRetrieveResponse(BaseModel):
+    id: str
+
+    attachments: List[Attachment]
+
+    bcc_addresses: List[str] = FieldInfo(alias="bccAddresses")
+
+    cc_addresses: List[str] = FieldInfo(alias="ccAddresses")
+
+    created_at: str = FieldInfo(alias="createdAt")
+
+    direction: Literal["INBOUND", "OUTBOUND"]
+
+    from_address: str = FieldInfo(alias="fromAddress")
+
+    from_name: Optional[str] = FieldInfo(alias="fromName", default=None)
+
+    html: Optional[str] = None
+
+    in_reply_to_id: Optional[str] = FieldInfo(alias="inReplyToId", default=None)
+
+    message_id: str = FieldInfo(alias="messageId")
+
+    received_at: Optional[str] = FieldInfo(alias="receivedAt", default=None)
+
+    references: List[str]
+
+    reply_to_addresses: List[str] = FieldInfo(alias="replyToAddresses")
+
+    sent_at: Optional[str] = FieldInfo(alias="sentAt", default=None)
+
+    snippet: Optional[str] = None
+
+    status: Literal[
+        "DRAFT",
+        "QUEUED",
+        "ACCEPTED",
+        "SENT",
+        "RECEIVED",
+        "FAILED",
+        "BOUNCED",
+        "COMPLAINED",
+        "REJECTED",
+        "READ",
+        "ARCHIVED",
+    ]
+
+    stripped_html: Optional[str] = FieldInfo(alias="strippedHtml", default=None)
+
+    stripped_text: Optional[str] = FieldInfo(alias="strippedText", default=None)
+
+    subject: Optional[str] = None
+
+    text: Optional[str] = None
+
+    thread_id: str = FieldInfo(alias="threadId")
+
+    to_addresses: List[str] = FieldInfo(alias="toAddresses")

aiinbx/types/email_send_params.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Union
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["EmailSendParams"]
+
+
+class EmailSendParams(TypedDict, total=False):
+    from_: Required[Annotated[str, PropertyInfo(alias="from")]]
+
+    html: Required[str]
+
+    subject: Required[str]
+
+    to: Required[Union[str, List[str]]]
+
+    bcc: Union[str, List[str]]
+
+    cc: Union[str, List[str]]
+
+    from_name: str
+
+    in_reply_to: str
+
+    is_draft: bool
+
+    references: List[str]
+
+    reply_to: Union[str, List[str]]
+
+    text: str
+
+    thread_id: Annotated[str, PropertyInfo(alias="threadId")]

aiinbx/types/email_send_response.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["EmailSendResponse"]
+
+
+class EmailSendResponse(BaseModel):
+    email_id: str = FieldInfo(alias="emailId")
+
+    message_id: str = FieldInfo(alias="messageId")
+
+    thread_id: str = FieldInfo(alias="threadId")

aiinbx/types/thread_retrieve_response.py

@@ -0,0 +1,100 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["ThreadRetrieveResponse", "Email", "EmailAttachment"]
+
+
+class EmailAttachment(BaseModel):
+    id: str
+
+    cid: Optional[str] = None
+
+    content_type: str = FieldInfo(alias="contentType")
+
+    created_at: str = FieldInfo(alias="createdAt")
+
+    disposition: Optional[str] = None
+
+    expires_at: str = FieldInfo(alias="expiresAt")
+
+    file_name: str = FieldInfo(alias="fileName")
+
+    signed_url: str = FieldInfo(alias="signedUrl")
+
+    size_in_bytes: float = FieldInfo(alias="sizeInBytes")
+
+
+class Email(BaseModel):
+    id: str
+
+    attachments: List[EmailAttachment]
+
+    bcc_addresses: List[str] = FieldInfo(alias="bccAddresses")
+
+    cc_addresses: List[str] = FieldInfo(alias="ccAddresses")
+
+    created_at: str = FieldInfo(alias="createdAt")
+
+    direction: Literal["INBOUND", "OUTBOUND"]
+
+    from_address: str = FieldInfo(alias="fromAddress")
+
+    from_name: Optional[str] = FieldInfo(alias="fromName", default=None)
+
+    html: Optional[str] = None
+
+    in_reply_to_id: Optional[str] = FieldInfo(alias="inReplyToId", default=None)
+
+    message_id: str = FieldInfo(alias="messageId")
+
+    received_at: Optional[str] = FieldInfo(alias="receivedAt", default=None)
+
+    references: List[str]
+
+    reply_to_addresses: List[str] = FieldInfo(alias="replyToAddresses")
+
+    sent_at: Optional[str] = FieldInfo(alias="sentAt", default=None)
+
+    snippet: Optional[str] = None
+
+    status: Literal[
+        "DRAFT",
+        "QUEUED",
+        "ACCEPTED",
+        "SENT",
+        "RECEIVED",
+        "FAILED",
+        "BOUNCED",
+        "COMPLAINED",
+        "REJECTED",
+        "READ",
+        "ARCHIVED",
+    ]
+
+    stripped_html: Optional[str] = FieldInfo(alias="strippedHtml", default=None)
+
+    stripped_text: Optional[str] = FieldInfo(alias="strippedText", default=None)
+
+    subject: Optional[str] = None
+
+    text: Optional[str] = None
+
+    thread_id: str = FieldInfo(alias="threadId")
+
+    to_addresses: List[str] = FieldInfo(alias="toAddresses")
+
+
+class ThreadRetrieveResponse(BaseModel):
+    id: str
+
+    created_at: str = FieldInfo(alias="createdAt")
+
+    emails: List[Email]
+
+    subject: Optional[str] = None