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

agentex/lib/core/temporal/plugins/openai_agents/interceptors/context_interceptor.py

@@ -85,10 +85,12 @@ class ContextWorkflowOutboundInterceptor(WorkflowOutboundInterceptor):
     def start_activity(self, input: StartActivityInput) -> workflow.ActivityHandle:
         """Add task_id, trace_id, and parent_span_id to headers when starting model activities."""
 
-        # Only add headers for invoke_model_activity calls
+        # Only add headers for model activity calls (OpenAI and Claude)
         activity_name = str(input.activity) if hasattr(input, 'activity') else ""
 
-        if "invoke_model_activity" in activity_name or "invoke-model-activity" in activity_name:
+        if ("invoke_model_activity" in activity_name or
+            "invoke-model-activity" in activity_name or
+            "run_claude_agent_activity" in activity_name):
             # Get task_id, trace_id, and parent_span_id from workflow instance instead of inbound interceptor
             try:
                 workflow_instance = workflow.instance()

agentex/lib/environment_variables.py

@@ -39,6 +39,9 @@ class EnvVarKeys(str, Enum):
     # Build Information
     BUILD_INFO_PATH = "BUILD_INFO_PATH"
     AGENT_INPUT_TYPE = "AGENT_INPUT_TYPE"
+    # Claude Agents SDK Configuration
+    ANTHROPIC_API_KEY = "ANTHROPIC_API_KEY"
+    CLAUDE_WORKSPACE_ROOT = "CLAUDE_WORKSPACE_ROOT"
 
 
 class Environment(str, Enum):
@@ -75,6 +78,9 @@ class EnvironmentVariables(BaseModel):
     AUTH_PRINCIPAL_B64: str | None = None
     # Build Information
     BUILD_INFO_PATH: str | None = None
+    # Claude Agents SDK Configuration
+    ANTHROPIC_API_KEY: str | None = None
+    CLAUDE_WORKSPACE_ROOT: str | None = None  # Defaults to project/workspace if not set
 
     @classmethod
     def refresh(cls) -> EnvironmentVariables:

agentex/lib/utils/completions.py

@@ -6,6 +6,7 @@ from functools import reduce, singledispatch
 
 from agentex.lib.types.llm_messages import (
     Delta,
+    Usage,
     Choice,
     ToolCall,
     Completion,
@@ -21,6 +22,8 @@ def _concat_chunks(_a: None, b: Any):
 @_concat_chunks.register
 def _(a: Completion, b: Completion) -> Completion:
     a.choices = [_concat_chunks(*c) for c in zip(a.choices, b.choices, strict=False)]
+    a.usage = _concat_chunks(a.usage, b.usage)
+
     return a
 
 
@@ -35,6 +38,17 @@ def _(a: Choice, b: Choice) -> Choice:
     a.finish_reason = a.finish_reason or b.finish_reason
     return a
 
+@_concat_chunks.register
+def _(a: Usage | None, b: Usage | None) -> Usage | None:
+    if a is not None and b is not None:
+        return Usage(
+            prompt_tokens=a.prompt_tokens + b.prompt_tokens,
+            completion_tokens=a.completion_tokens + b.completion_tokens,
+            total_tokens=a.total_tokens + b.total_tokens,
+        )
+    else:
+        return a or b
+
 
 @_concat_chunks.register
 def _(a: Delta, b: Delta) -> Delta:

agentex/resources/agents.py

@@ -93,6 +93,8 @@ class AgentsResource(SyncAPIResource):
         self,
         *,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         task_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -108,6 +110,10 @@ class AgentsResource(SyncAPIResource):
         Args:
           limit: Limit
 
+          order_by: Field to order by
+
+          order_direction: Order direction (asc or desc)
+
           page_number: Page number
 
           task_id: Task ID
@@ -130,6 +136,8 @@ class AgentsResource(SyncAPIResource):
                 query=maybe_transform(
                     {
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "task_id": task_id,
                     },
@@ -653,6 +661,8 @@ class AsyncAgentsResource(AsyncAPIResource):
         self,
         *,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         task_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -668,6 +678,10 @@ class AsyncAgentsResource(AsyncAPIResource):
         Args:
           limit: Limit
 
+          order_by: Field to order by
+
+          order_direction: Order direction (asc or desc)
+
           page_number: Page number
 
           task_id: Task ID
@@ -690,6 +704,8 @@ class AsyncAgentsResource(AsyncAPIResource):
                 query=await async_maybe_transform(
                     {
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "task_id": task_id,
                     },

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"]
 
@@ -181,6 +187,8 @@ class MessagesResource(SyncAPIResource):
         *,
         task_id: str,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: 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.
@@ -190,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
@@ -214,6 +225,8 @@ class MessagesResource(SyncAPIResource):
                     {
                         "task_id": task_id,
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                     },
                     message_list_params.MessageListParams,
@@ -222,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
@@ -370,6 +447,8 @@ class AsyncMessagesResource(AsyncAPIResource):
         *,
         task_id: str,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: 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.
@@ -379,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
@@ -403,6 +485,8 @@ class AsyncMessagesResource(AsyncAPIResource):
                     {
                         "task_id": task_id,
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                     },
                     message_list_params.MessageListParams,
@@ -411,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:
@@ -428,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:
@@ -450,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:
@@ -472,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:
@@ -494,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/resources/spans.py

@@ -223,6 +223,8 @@ class SpansResource(SyncAPIResource):
         self,
         *,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         trace_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -254,6 +256,8 @@ class SpansResource(SyncAPIResource):
                 query=maybe_transform(
                     {
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "trace_id": trace_id,
                     },
@@ -462,6 +466,8 @@ class AsyncSpansResource(AsyncAPIResource):
         self,
         *,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         trace_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -493,6 +499,8 @@ class AsyncSpansResource(AsyncAPIResource):
                 query=await async_maybe_transform(
                     {
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "trace_id": trace_id,
                     },

agentex/resources/states.py

@@ -167,6 +167,8 @@ class StatesResource(SyncAPIResource):
         *,
         agent_id: Optional[str] | Omit = omit,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         task_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -184,6 +186,10 @@ class StatesResource(SyncAPIResource):
 
           limit: Limit
 
+          order_by: Field to order by
+
+          order_direction: Order direction (asc or desc)
+
           page_number: Page number
 
           task_id: Task ID
@@ -207,6 +213,8 @@ class StatesResource(SyncAPIResource):
                     {
                         "agent_id": agent_id,
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "task_id": task_id,
                     },
@@ -393,6 +401,8 @@ class AsyncStatesResource(AsyncAPIResource):
         *,
         agent_id: Optional[str] | Omit = omit,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         task_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -410,6 +420,10 @@ class AsyncStatesResource(AsyncAPIResource):
 
           limit: Limit
 
+          order_by: Field to order by
+
+          order_direction: Order direction (asc or desc)
+
           page_number: Page number
 
           task_id: Task ID
@@ -433,6 +447,8 @@ class AsyncStatesResource(AsyncAPIResource):
                     {
                         "agent_id": agent_id,
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "task_id": task_id,
                     },

agentex/resources/tasks.py

@@ -92,6 +92,8 @@ class TasksResource(SyncAPIResource):
         agent_id: Optional[str] | Omit = omit,
         agent_name: Optional[str] | Omit = omit,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         relationships: List[Literal["agents"]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -125,6 +127,8 @@ class TasksResource(SyncAPIResource):
                         "agent_id": agent_id,
                         "agent_name": agent_name,
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "relationships": relationships,
                     },
@@ -377,6 +381,8 @@ class AsyncTasksResource(AsyncAPIResource):
         agent_id: Optional[str] | Omit = omit,
         agent_name: Optional[str] | Omit = omit,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         relationships: List[Literal["agents"]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -410,6 +416,8 @@ class AsyncTasksResource(AsyncAPIResource):
                         "agent_id": agent_id,
                         "agent_name": agent_name,
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "relationships": relationships,
                     },

agentex/resources/tracker.py

@@ -132,6 +132,8 @@ class TrackerResource(SyncAPIResource):
         *,
         agent_id: Optional[str] | Omit = omit,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         task_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -149,6 +151,10 @@ class TrackerResource(SyncAPIResource):
 
           limit: Limit
 
+          order_by: Field to order by
+
+          order_direction: Order direction (asc or desc)
+
           page_number: Page number
 
           task_id: Task ID
@@ -172,6 +178,8 @@ class TrackerResource(SyncAPIResource):
                     {
                         "agent_id": agent_id,
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "task_id": task_id,
                     },
@@ -290,6 +298,8 @@ class AsyncTrackerResource(AsyncAPIResource):
         *,
         agent_id: Optional[str] | Omit = omit,
         limit: int | Omit = omit,
+        order_by: Optional[str] | Omit = omit,
+        order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         task_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -307,6 +317,10 @@ class AsyncTrackerResource(AsyncAPIResource):
 
           limit: Limit
 
+          order_by: Field to order by
+
+          order_direction: Order direction (asc or desc)
+
           page_number: Page number
 
           task_id: Task ID
@@ -330,6 +344,8 @@ class AsyncTrackerResource(AsyncAPIResource):
                     {
                         "agent_id": agent_id,
                         "limit": limit,
+                        "order_by": order_by,
+                        "order_direction": order_direction,
                         "page_number": page_number,
                         "task_id": task_id,
                     },

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/agent_list_params.py

@@ -12,6 +12,12 @@ class AgentListParams(TypedDict, total=False):
     limit: int
     """Limit"""
 
+    order_by: Optional[str]
+    """Field to order by"""
+
+    order_direction: str
+    """Order direction (asc or desc)"""
+
     page_number: int
     """Page number"""
 

agentex/types/agent_rpc_result.py

@@ -20,6 +20,8 @@ __all__ = [
 
 
 class StreamTaskMessageStart(BaseModel):
+    """Event for starting a streaming message"""
+
     content: TaskMessageContent
 
     index: Optional[int] = None
@@ -35,6 +37,8 @@ class StreamTaskMessageStart(BaseModel):
 
 
 class StreamTaskMessageDelta(BaseModel):
+    """Event for streaming chunks of content"""
+
     delta: Optional[TaskMessageDelta] = None
     """Delta for text updates"""
 
@@ -51,6 +55,8 @@ class StreamTaskMessageDelta(BaseModel):
 
 
 class StreamTaskMessageFull(BaseModel):
+    """Event for streaming the full content"""
+
     content: TaskMessageContent
 
     index: Optional[int] = None
@@ -66,6 +72,8 @@ class StreamTaskMessageFull(BaseModel):
 
 
 class StreamTaskMessageDone(BaseModel):
+    """Event for indicating the task is done"""
+
     index: Optional[int] = None
 
     parent_task_message: Optional[TaskMessage] = None

agentex/types/data_delta.py

@@ -9,6 +9,8 @@ __all__ = ["DataDelta"]
 
 
 class DataDelta(BaseModel):
+    """Delta for data updates"""
+
     data_delta: Optional[str] = None
 
     type: Optional[Literal["data"]] = None

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