feat(api): add messages/paginated to stainless config

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 34
+configured_endpoints: 35
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp%2Fagentex-sdk-8f9296ac9fa68bb264c4739463e55ce27cdafb31b705b27600d6656db7b0dac5.yml
 openapi_spec_hash: 8df92140f49cace852d7b71b0964da5b
-config_hash: 0197f86ba1a4b1b5ce813d0e62138588
+config_hash: 32eb65911c08ac84d117cecdf2759869

api.md

@@ -72,6 +72,7 @@ from agentex.types import (
     ToolRequestContent,
     ToolResponseContent,
     MessageListResponse,
+    MessageListPaginatedResponse,
 )
 ```
 
@@ -81,6 +82,7 @@ Methods:
 - <code title="get /messages/{message_id}">client.messages.<a href="./src/agentex/resources/messages/messages.py">retrieve</a>(message_id) -> <a href="./src/agentex/types/task_message.py">TaskMessage</a></code>
 - <code title="put /messages/{message_id}">client.messages.<a href="./src/agentex/resources/messages/messages.py">update</a>(message_id, \*\*<a href="src/agentex/types/message_update_params.py">params</a>) -> <a href="./src/agentex/types/task_message.py">TaskMessage</a></code>
 - <code title="get /messages">client.messages.<a href="./src/agentex/resources/messages/messages.py">list</a>(\*\*<a href="src/agentex/types/message_list_params.py">params</a>) -> <a href="./src/agentex/types/message_list_response.py">MessageListResponse</a></code>
+- <code title="get /messages/paginated">client.messages.<a href="./src/agentex/resources/messages/messages.py">list_paginated</a>(\*\*<a href="src/agentex/types/message_list_paginated_params.py">params</a>) -> <a href="./src/agentex/types/message_list_paginated_response.py">MessageListPaginatedResponse</a></code>
 
 ## Batch
 

src/agentex/resources/messages/messages.py

@@ -15,7 +15,12 @@
     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 ...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"]
 
@@ -229,6 +235,70 @@ def list(
             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
@@ -425,6 +495,70 @@ async def list(
             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:
@@ -442,6 +576,9 @@ def __init__(self, messages: MessagesResource) -> None:
         self.list = to_raw_response_wrapper(
             messages.list,
         )
+        self.list_paginated = to_raw_response_wrapper(
+            messages.list_paginated,
+        )
 
     @cached_property
     def batch(self) -> BatchResourceWithRawResponse:
@@ -464,6 +601,9 @@ def __init__(self, messages: AsyncMessagesResource) -> None:
         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:
@@ -486,6 +626,9 @@ def __init__(self, messages: MessagesResource) -> None:
         self.list = to_streamed_response_wrapper(
             messages.list,
         )
+        self.list_paginated = to_streamed_response_wrapper(
+            messages.list_paginated,
+        )
 
     @cached_property
     def batch(self) -> BatchResourceWithStreamingResponse:
@@ -508,6 +651,9 @@ def __init__(self, messages: AsyncMessagesResource) -> None:
         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:

src/agentex/types/__init__.py

@@ -64,5 +64,7 @@
 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

src/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

src/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"""

tests/api_resources/test_messages.py

@@ -11,6 +11,7 @@
 from agentex.types import (
     TaskMessage,
     MessageListResponse,
+    MessageListPaginatedResponse,
 )
 
 from ..utils import assert_matches_type
@@ -273,6 +274,51 @@ def test_streaming_response_list(self, client: Agentex) -> None:
 
         assert cast(Any, response.is_closed) is True
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_list_paginated(self, client: Agentex) -> None:
+        message = client.messages.list_paginated(
+            task_id="task_id",
+        )
+        assert_matches_type(MessageListPaginatedResponse, message, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_list_paginated_with_all_params(self, client: Agentex) -> None:
+        message = client.messages.list_paginated(
+            task_id="task_id",
+            cursor="cursor",
+            direction="older",
+            limit=0,
+        )
+        assert_matches_type(MessageListPaginatedResponse, message, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_raw_response_list_paginated(self, client: Agentex) -> None:
+        response = client.messages.with_raw_response.list_paginated(
+            task_id="task_id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        message = response.parse()
+        assert_matches_type(MessageListPaginatedResponse, message, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_streaming_response_list_paginated(self, client: Agentex) -> None:
+        with client.messages.with_streaming_response.list_paginated(
+            task_id="task_id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            message = response.parse()
+            assert_matches_type(MessageListPaginatedResponse, message, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
 
 class TestAsyncMessages:
     parametrize = pytest.mark.parametrize(
@@ -530,3 +576,48 @@ async def test_streaming_response_list(self, async_client: AsyncAgentex) -> None
             assert_matches_type(MessageListResponse, message, path=["response"])
 
         assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_list_paginated(self, async_client: AsyncAgentex) -> None:
+        message = await async_client.messages.list_paginated(
+            task_id="task_id",
+        )
+        assert_matches_type(MessageListPaginatedResponse, message, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_list_paginated_with_all_params(self, async_client: AsyncAgentex) -> None:
+        message = await async_client.messages.list_paginated(
+            task_id="task_id",
+            cursor="cursor",
+            direction="older",
+            limit=0,
+        )
+        assert_matches_type(MessageListPaginatedResponse, message, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_raw_response_list_paginated(self, async_client: AsyncAgentex) -> None:
+        response = await async_client.messages.with_raw_response.list_paginated(
+            task_id="task_id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        message = await response.parse()
+        assert_matches_type(MessageListPaginatedResponse, message, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_streaming_response_list_paginated(self, async_client: AsyncAgentex) -> None:
+        async with async_client.messages.with_streaming_response.list_paginated(
+            task_id="task_id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            message = await response.parse()
+            assert_matches_type(MessageListPaginatedResponse, message, path=["response"])
+
+        assert cast(Any, response.is_closed) is True