feat(api): add agent_message parameter to agents.send_to_execution

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 180
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-16b360cee45543059c71209bed8235e5e1a37b61fbeb513a63ee7e67b577e165.yml
-openapi_spec_hash: f22e39876f664dced8af26d4bd51f20c
-config_hash: 0ec0dc7b6891f666565cf1521a8d172f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-b4ac05534b28936c4fe9d86221fb30415a39826e6a5414b5a7ffb2ad87a021ed.yml
+openapi_spec_hash: c5ae4a889864c5255ce9aa0a1fe98631
+config_hash: 9629844f3bf40631adbcfe7c739494a1

api.md

@@ -65,10 +65,12 @@ Types:
 from gitpod.types import (
     AgentCodeContext,
     AgentExecution,
+    AgentMessage,
     AgentMode,
     Prompt,
     PromptMetadata,
     PromptSpec,
+    Type,
     UserInputBlock,
     AgentCreateExecutionConversationTokenResponse,
     AgentCreatePromptResponse,

src/gitpod/resources/agents.py

@@ -36,6 +36,7 @@
 from ..types.prompt import Prompt
 from ..types.agent_mode import AgentMode
 from ..types.agent_execution import AgentExecution
+from ..types.agent_message_param import AgentMessageParam
 from ..types.user_input_block_param import UserInputBlockParam
 from ..types.agent_code_context_param import AgentCodeContextParam
 from ..types.agent_create_prompt_response import AgentCreatePromptResponse
@@ -483,6 +484,7 @@ def send_to_execution(
         self,
         *,
         agent_execution_id: str | Omit = omit,
+        agent_message: AgentMessageParam | Omit = omit,
         user_input: UserInputBlockParam | 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.
@@ -510,6 +512,9 @@ def send_to_execution(
           ```
 
         Args:
+          agent_message: AgentMessage is a message sent between agents (e.g. from a parent agent to a
+              child agent execution, or vice versa).
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -523,6 +528,7 @@ def send_to_execution(
             body=maybe_transform(
                 {
                     "agent_execution_id": agent_execution_id,
+                    "agent_message": agent_message,
                     "user_input": user_input,
                 },
                 agent_send_to_execution_params.AgentSendToExecutionParams,
@@ -1154,6 +1160,7 @@ async def send_to_execution(
         self,
         *,
         agent_execution_id: str | Omit = omit,
+        agent_message: AgentMessageParam | Omit = omit,
         user_input: UserInputBlockParam | 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.
@@ -1181,6 +1188,9 @@ async def send_to_execution(
           ```
 
         Args:
+          agent_message: AgentMessage is a message sent between agents (e.g. from a parent agent to a
+              child agent execution, or vice versa).
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1194,6 +1204,7 @@ async def send_to_execution(
             body=await async_maybe_transform(
                 {
                     "agent_execution_id": agent_execution_id,
+                    "agent_message": agent_message,
                     "user_input": user_input,
                 },
                 agent_send_to_execution_params.AgentSendToExecutionParams,

src/gitpod/types/__init__.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from .type import Type as Type
 from .user import User as User
 from .veto import Veto as Veto
 from .group import Group as Group
@@ -99,6 +100,7 @@
 from .secret_list_params import SecretListParams as SecretListParams
 from .secret_scope_param import SecretScopeParam as SecretScopeParam
 from .warm_pool_metadata import WarmPoolMetadata as WarmPoolMetadata
+from .agent_message_param import AgentMessageParam as AgentMessageParam
 from .event_list_response import EventListResponse as EventListResponse
 from .gateway_list_params import GatewayListParams as GatewayListParams
 from .group_create_params import GroupCreateParams as GroupCreateParams

src/gitpod/types/agent_message_param.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+from .type import Type
+
+__all__ = ["AgentMessageParam"]
+
+
+class AgentMessageParam(TypedDict, total=False):
+    """AgentMessage is a message sent between agents (e.g.
+
+    from a parent agent to a
+     child agent execution, or vice versa).
+    """
+
+    payload: str
+    """Free-form payload of the message."""
+
+    type: Type

src/gitpod/types/agent_send_to_execution_params.py

@@ -5,6 +5,7 @@
 from typing_extensions import Annotated, TypedDict
 
 from .._utils import PropertyInfo
+from .agent_message_param import AgentMessageParam
 from .user_input_block_param import UserInputBlockParam
 
 __all__ = ["AgentSendToExecutionParams"]
@@ -13,4 +14,10 @@
 class AgentSendToExecutionParams(TypedDict, total=False):
     agent_execution_id: Annotated[str, PropertyInfo(alias="agentExecutionId")]
 
+    agent_message: Annotated[AgentMessageParam, PropertyInfo(alias="agentMessage")]
+    """AgentMessage is a message sent between agents (e.g.
+
+    from a parent agent to a child agent execution, or vice versa).
+    """
+
     user_input: Annotated[UserInputBlockParam, PropertyInfo(alias="userInput")]

src/gitpod/types/type.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["Type"]
+
+Type: TypeAlias = Literal["TYPE_UNSPECIFIED", "TYPE_UPDATE", "TYPE_COMPLETE"]

tests/api_resources/test_agents.py

@@ -360,6 +360,10 @@ def test_method_send_to_execution(self, client: Gitpod) -> None:
     def test_method_send_to_execution_with_all_params(self, client: Gitpod) -> None:
         agent = client.agents.send_to_execution(
             agent_execution_id="6fa1a3c7-fbb7-49d1-ba56-1890dc7c4c35",
+            agent_message={
+                "payload": "payload",
+                "type": "TYPE_UNSPECIFIED",
+            },
             user_input={
                 "id": "id",
                 "created_at": parse_datetime("2019-12-27T18:11:19.117Z"),
@@ -890,6 +894,10 @@ async def test_method_send_to_execution(self, async_client: AsyncGitpod) -> None
     async def test_method_send_to_execution_with_all_params(self, async_client: AsyncGitpod) -> None:
         agent = await async_client.agents.send_to_execution(
             agent_execution_id="6fa1a3c7-fbb7-49d1-ba56-1890dc7c4c35",
+            agent_message={
+                "payload": "payload",
+                "type": "TYPE_UNSPECIFIED",
+            },
             user_input={
                 "id": "id",
                 "created_at": parse_datetime("2019-12-27T18:11:19.117Z"),