agentex-sdk 0.7.0__py3-none-any.whl → 0.7.1__py3-none-any.whl

agentex/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "agentex"
-__version__ = "0.7.0"  # x-release-please-version
+__version__ = "0.7.1"  # x-release-please-version

agentex/resources/messages/messages.py

@@ -15,7 +15,12 @@ from .batch import (
     BatchResourceWithStreamingResponse,
     AsyncBatchResourceWithStreamingResponse,
 )
-from ...types import message_list_params, message_create_params, message_update_params
+from ...types import (
+    message_list_params,
+    message_create_params,
+    message_update_params,
+    message_list_paginated_params,
+)
 from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
@@ -30,6 +35,7 @@ from ..._base_client import make_request_options
 from ...types.task_message import TaskMessage
 from ...types.message_list_response import MessageListResponse
 from ...types.task_message_content_param import TaskMessageContentParam
+from ...types.message_list_paginated_response import MessageListPaginatedResponse
 
 __all__ = ["MessagesResource", "AsyncMessagesResource"]
 
@@ -192,7 +198,10 @@ class MessagesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MessageListResponse:
         """
-        List Messages
+        List messages for a task with offset-based pagination.
+
+        For cursor-based pagination with infinite scroll support, use
+        /messages/paginated.
 
         Args:
           task_id: The task ID
@@ -226,6 +235,70 @@ class MessagesResource(SyncAPIResource):
             cast_to=MessageListResponse,
         )
 
+    def list_paginated(
+        self,
+        *,
+        task_id: str,
+        cursor: Optional[str] | Omit = omit,
+        direction: Literal["older", "newer"] | Omit = omit,
+        limit: int | Omit = omit,
+        # 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,
+    ) -> MessageListPaginatedResponse:
+        """
+        List messages for a task with cursor-based pagination.
+
+        This endpoint is designed for infinite scroll UIs where new messages may arrive
+        while paginating through older ones.
+
+        Args: task_id: The task ID to filter messages by limit: Maximum number of
+        messages to return (default: 50) cursor: Opaque cursor string for pagination.
+        Pass the `next_cursor` from a previous response to get the next page. direction:
+        Pagination direction - "older" to get older messages (default), "newer" to get
+        newer messages.
+
+        Returns: PaginatedMessagesResponse with: - data: List of messages (newest first
+        when direction="older") - next_cursor: Cursor for fetching the next page (null
+        if no more pages) - has_more: Whether there are more messages to fetch
+
+        Example: First request: GET /messages/paginated?task_id=xxx&limit=50 Next page:
+        GET /messages/paginated?task_id=xxx&limit=50&cursor=<next_cursor>
+
+        Args:
+          task_id: The task ID
+
+          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._get(
+            "/messages/paginated",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "task_id": task_id,
+                        "cursor": cursor,
+                        "direction": direction,
+                        "limit": limit,
+                    },
+                    message_list_paginated_params.MessageListPaginatedParams,
+                ),
+            ),
+            cast_to=MessageListPaginatedResponse,
+        )
+
 
 class AsyncMessagesResource(AsyncAPIResource):
     @cached_property
@@ -385,7 +458,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MessageListResponse:
         """
-        List Messages
+        List messages for a task with offset-based pagination.
+
+        For cursor-based pagination with infinite scroll support, use
+        /messages/paginated.
 
         Args:
           task_id: The task ID
@@ -419,6 +495,70 @@ class AsyncMessagesResource(AsyncAPIResource):
             cast_to=MessageListResponse,
         )
 
+    async def list_paginated(
+        self,
+        *,
+        task_id: str,
+        cursor: Optional[str] | Omit = omit,
+        direction: Literal["older", "newer"] | Omit = omit,
+        limit: int | Omit = omit,
+        # 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,
+    ) -> MessageListPaginatedResponse:
+        """
+        List messages for a task with cursor-based pagination.
+
+        This endpoint is designed for infinite scroll UIs where new messages may arrive
+        while paginating through older ones.
+
+        Args: task_id: The task ID to filter messages by limit: Maximum number of
+        messages to return (default: 50) cursor: Opaque cursor string for pagination.
+        Pass the `next_cursor` from a previous response to get the next page. direction:
+        Pagination direction - "older" to get older messages (default), "newer" to get
+        newer messages.
+
+        Returns: PaginatedMessagesResponse with: - data: List of messages (newest first
+        when direction="older") - next_cursor: Cursor for fetching the next page (null
+        if no more pages) - has_more: Whether there are more messages to fetch
+
+        Example: First request: GET /messages/paginated?task_id=xxx&limit=50 Next page:
+        GET /messages/paginated?task_id=xxx&limit=50&cursor=<next_cursor>
+
+        Args:
+          task_id: The task ID
+
+          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._get(
+            "/messages/paginated",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "task_id": task_id,
+                        "cursor": cursor,
+                        "direction": direction,
+                        "limit": limit,
+                    },
+                    message_list_paginated_params.MessageListPaginatedParams,
+                ),
+            ),
+            cast_to=MessageListPaginatedResponse,
+        )
+
 
 class MessagesResourceWithRawResponse:
     def __init__(self, messages: MessagesResource) -> None:
@@ -436,6 +576,9 @@ class MessagesResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             messages.list,
         )
+        self.list_paginated = to_raw_response_wrapper(
+            messages.list_paginated,
+        )
 
     @cached_property
     def batch(self) -> BatchResourceWithRawResponse:
@@ -458,6 +601,9 @@ class AsyncMessagesResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             messages.list,
         )
+        self.list_paginated = async_to_raw_response_wrapper(
+            messages.list_paginated,
+        )
 
     @cached_property
     def batch(self) -> AsyncBatchResourceWithRawResponse:
@@ -480,6 +626,9 @@ class MessagesResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             messages.list,
         )
+        self.list_paginated = to_streamed_response_wrapper(
+            messages.list_paginated,
+        )
 
     @cached_property
     def batch(self) -> BatchResourceWithStreamingResponse:
@@ -502,6 +651,9 @@ class AsyncMessagesResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             messages.list,
         )
+        self.list_paginated = async_to_streamed_response_wrapper(
+            messages.list_paginated,
+        )
 
     @cached_property
     def batch(self) -> AsyncBatchResourceWithStreamingResponse:

agentex/types/__init__.py

@@ -64,5 +64,7 @@ from .tool_request_content_param import ToolRequestContentParam as ToolRequestCo
 from .tool_response_content_param import ToolResponseContentParam as ToolResponseContentParam
 from .task_retrieve_by_name_params import TaskRetrieveByNameParams as TaskRetrieveByNameParams
 from .deployment_history_list_params import DeploymentHistoryListParams as DeploymentHistoryListParams
+from .message_list_paginated_params import MessageListPaginatedParams as MessageListPaginatedParams
 from .task_retrieve_by_name_response import TaskRetrieveByNameResponse as TaskRetrieveByNameResponse
 from .deployment_history_list_response import DeploymentHistoryListResponse as DeploymentHistoryListResponse
+from .message_list_paginated_response import MessageListPaginatedResponse as MessageListPaginatedResponse

agentex/types/message_list_paginated_params.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["MessageListPaginatedParams"]
+
+
+class MessageListPaginatedParams(TypedDict, total=False):
+    task_id: Required[str]
+    """The task ID"""
+
+    cursor: Optional[str]
+
+    direction: Literal["older", "newer"]
+
+    limit: int

agentex/types/message_list_paginated_response.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .._models import BaseModel
+from .task_message import TaskMessage
+
+__all__ = ["MessageListPaginatedResponse"]
+
+
+class MessageListPaginatedResponse(BaseModel):
+    """Response with cursor pagination metadata."""
+
+    data: List[TaskMessage]
+    """List of messages"""
+
+    has_more: Optional[bool] = None
+    """Whether there are more messages to fetch"""
+
+    next_cursor: Optional[str] = None
+    """Cursor for fetching the next page of older messages"""

{agentex_sdk-0.7.0.dist-info → agentex_sdk-0.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: agentex-sdk
-Version: 0.7.0
+Version: 0.7.1
 Summary: The official Python library for the agentex API
 Project-URL: Homepage, https://github.com/scaleapi/scale-agentex-python
 Project-URL: Repository, https://github.com/scaleapi/scale-agentex-python

{agentex_sdk-0.7.0.dist-info → agentex_sdk-0.7.1.dist-info}/RECORD

@@ -11,7 +11,7 @@ agentex/_resource.py,sha256=S1t7wmR5WUvoDIhZjo_x-E7uoTJBynJ3d8tPJMQYdjw,1106
 agentex/_response.py,sha256=Tb9zazsnemO2rTxWtBjAD5WBqlhli5ZaXGbiKgdu5DE,28794
 agentex/_streaming.py,sha256=aOvLOte7kaclPGm-D0iNdM3uRcWrZ-T2B8t9BDNmpuA,10225
 agentex/_types.py,sha256=00q2kgDxUPJC16dU-YIUeOFsN5MzNW0zjzVXMlBYGV0,7296
-agentex/_version.py,sha256=hPeQtgytB3A7v7y2cNrZ9b5aUb3tRdUBraPY_Wg1Rig,159
+agentex/_version.py,sha256=t63Lp-Z3w7p36sPMg2u_dX0Gm4PvvBY3HRChIRJXIgQ,159
 agentex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
 agentex/_utils/_compat.py,sha256=D8gtAvjJQrDWt9upS0XaG9Rr5l1QhiAx_I_1utT_tt0,1195
@@ -263,8 +263,8 @@ agentex/resources/tasks.py,sha256=PYclyozaR1az30ZcsEtP4WMvBoXPeF1mEvcNYOAWt0I,27
 agentex/resources/tracker.py,sha256=bxRuzI9ThHrZtJbZoctU9vodE1kxAqcdlwQVrcbQTb4,15089
 agentex/resources/messages/__init__.py,sha256=_J1eusFtr_k6zrAntJSuqx6LWEUBSTrV1OZZh7MaDPE,1015
 agentex/resources/messages/batch.py,sha256=bYDIf0ZF3-sTKnGfFmzFQUn8LMtMYoniY977J3zr8q8,9653
-agentex/resources/messages/messages.py,sha256=BNKPRle5TwVtYuLQPytFFoEMmQz5ObjJectU7ZUoseg,18470
-agentex/types/__init__.py,sha256=JEDsom9CZpig5AWGV5UH_JRQ7ewW7_q1DUP6TQnnioI,4519
+agentex/resources/messages/messages.py,sha256=ae48_YXRBqPiwBkHavhZpJaFVhIL-MYng6Y8BUlnAYU,24756
+agentex/types/__init__.py,sha256=zmdABr-KEqbFkBIZIqWgeWI-C9bSqCfJ-sm2OzBQFB0,4725
 agentex/types/acp_type.py,sha256=lEn_w4z-RIgyUVTQr8mm5l9OdFDQMDclbJU_lKa4Mi8,217
 agentex/types/agent.py,sha256=hwgmtylJYezzmGJbzbBQ7sn3oV2_bCZqgqlNq9WpZ0g,1318
 agentex/types/agent_list_params.py,sha256=s4heb3MQwMprmuol_smUDL2N0u-5WUbUCxt3J5Dqnag,515
@@ -285,6 +285,8 @@ agentex/types/event_list_params.py,sha256=Rrz0yo2w3gMTNYe3HQS9YCX1VktE_aaktuHezx
 agentex/types/event_list_response.py,sha256=rjUCkwS0pXnfqHEVPEKZdLIGJ14uXOrjatuOfR36s5s,254
 agentex/types/message_author.py,sha256=_IIVLAcZsLTG_vQWFpjWuxLIaHrc6wkv3q7qu5gam0o,218
 agentex/types/message_create_params.py,sha256=Vt7Hig0lI8qxWDpJ4JhjfjglSzptI2PjzbrOD1Qkmxk,502
+agentex/types/message_list_paginated_params.py,sha256=FSlXXsrm7gZZP5-bnvNswo4EFuzlA3weHWakBSUDI6I,446
+agentex/types/message_list_paginated_response.py,sha256=VRPr20UNkBRchJrkroujPT46d830qK1Z-G6h1ziSUS4,582
 agentex/types/message_list_params.py,sha256=dGhDWqZddCh5BIz-ebhQhwgiNEn8yujGjaVXdpHLbrc,427
 agentex/types/message_list_response.py,sha256=YYDf-57zLS-E1eX3EZxz7c6XCuBcRBws01_q2G7uk4Y,277
 agentex/types/message_style.py,sha256=nuoXzoDyP3KAQsQeKHaiby1EMxeY-8TJjWr8eMMpQEE,219
@@ -335,8 +337,8 @@ agentex/types/messages/batch_update_params.py,sha256=Ug5CThbD49a8j4qucg04OdmVrp_
 agentex/types/messages/batch_update_response.py,sha256=TbSBe6SuPzjXXWSj-nRjT1JHGBooTshHQQDa1AixQA8,278
 agentex/types/shared/__init__.py,sha256=IKs-Qn5Yja0kFh1G1kDqYZo43qrOu1hSoxlPdN-85dI,149
 agentex/types/shared/delete_response.py,sha256=8qH3zvQXaOHYQSHyXi7UQxdR4miTzR7V9K4zXVsiUyk,215
-agentex_sdk-0.7.0.dist-info/METADATA,sha256=8aDhuHqr6cjoSDQaWnBBk-2I7wgP0i11Y0M0d7rRlSw,15553
-agentex_sdk-0.7.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-agentex_sdk-0.7.0.dist-info/entry_points.txt,sha256=V7vJuMZdF0UlvgX6KiBN7XUvq_cxF5kplcYvc1QlFaQ,62
-agentex_sdk-0.7.0.dist-info/licenses/LICENSE,sha256=Q1AOx2FtRcMlyMgQJ9eVN2WKPq2mQ33lnB4tvWxabLA,11337
-agentex_sdk-0.7.0.dist-info/RECORD,,
+agentex_sdk-0.7.1.dist-info/METADATA,sha256=te0uU6OMYnh-QGBzUIHcL5izI4PS22QeLn8LbS87gqs,15553
+agentex_sdk-0.7.1.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+agentex_sdk-0.7.1.dist-info/entry_points.txt,sha256=V7vJuMZdF0UlvgX6KiBN7XUvq_cxF5kplcYvc1QlFaQ,62
+agentex_sdk-0.7.1.dist-info/licenses/LICENSE,sha256=Q1AOx2FtRcMlyMgQJ9eVN2WKPq2mQ33lnB4tvWxabLA,11337
+agentex_sdk-0.7.1.dist-info/RECORD,,