feat(api): add task/interrupt method and INTERRUPTED status to agents/tasks

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 74
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-f3f1b47fa785a0d7b4e1cce1932a2ab0c0b6531d67d499e6188292ea2a00c9d8.yml
-openapi_spec_hash: 77044dc5774eb88f1541ebbe53b413a7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-03cb3b4d6f3c371f060a90c8baa03c050c20319d7879af0603788cc35f6f0506.yml
+openapi_spec_hash: 132e9efdb0535d9594abadf799431cf5
 config_hash: 5c4e326f797c879e72d6bf32fc1ea49d

src/agentex/resources/agents/agents.py

@@ -326,7 +326,7 @@ def rpc(
         self,
         agent_id: str,
         *,
-        method: Literal["event/send", "task/create", "message/send", "task/cancel"],
+        method: Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"],
         params: agent_rpc_params.Params,
         id: Union[int, str, None] | Omit = omit,
         jsonrpc: Literal["2.0"] | Omit = omit,
@@ -374,7 +374,7 @@ def rpc_by_name(
         self,
         agent_name: str,
         *,
-        method: Literal["event/send", "task/create", "message/send", "task/cancel"],
+        method: Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"],
         params: agent_rpc_by_name_params.Params,
         id: Union[int, str, None] | Omit = omit,
         jsonrpc: Literal["2.0"] | Omit = omit,
@@ -987,7 +987,7 @@ async def rpc(
         self,
         agent_id: str,
         *,
-        method: Literal["event/send", "task/create", "message/send", "task/cancel"],
+        method: Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"],
         params: agent_rpc_params.Params,
         id: Union[int, str, None] | Omit = omit,
         jsonrpc: Literal["2.0"] | Omit = omit,
@@ -1035,7 +1035,7 @@ async def rpc_by_name(
         self,
         agent_name: str,
         *,
-        method: Literal["event/send", "task/create", "message/send", "task/cancel"],
+        method: Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"],
         params: agent_rpc_by_name_params.Params,
         id: Union[int, str, None] | Omit = omit,
         jsonrpc: Literal["2.0"] | Omit = omit,

src/agentex/resources/agents/deployments.py

@@ -242,7 +242,7 @@ def preview_rpc(
         deployment_id: str,
         *,
         agent_id: str,
-        method: Literal["event/send", "task/create", "message/send", "task/cancel"],
+        method: Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"],
         params: deployment_preview_rpc_params.Params,
         id: Union[int, str, None] | Omit = omit,
         jsonrpc: Literal["2.0"] | Omit = omit,
@@ -542,7 +542,7 @@ async def preview_rpc(
         deployment_id: str,
         *,
         agent_id: str,
-        method: Literal["event/send", "task/create", "message/send", "task/cancel"],
+        method: Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"],
         params: deployment_preview_rpc_params.Params,
         id: Union[int, str, None] | Omit = omit,
         jsonrpc: Literal["2.0"] | Omit = omit,

src/agentex/resources/tasks.py

@@ -109,7 +109,9 @@ def list(
         order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         relationships: List[Literal["agents"]] | Omit = omit,
-        status: Optional[Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "TERMINATED", "TIMED_OUT", "DELETED"]]
+        status: Optional[
+            Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "INTERRUPTED", "TERMINATED", "TIMED_OUT", "DELETED"]
+        ]
         | Omit = omit,
         task_metadata: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -705,7 +707,9 @@ async def list(
         order_direction: str | Omit = omit,
         page_number: int | Omit = omit,
         relationships: List[Literal["agents"]] | Omit = omit,
-        status: Optional[Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "TERMINATED", "TIMED_OUT", "DELETED"]]
+        status: Optional[
+            Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "INTERRUPTED", "TERMINATED", "TIMED_OUT", "DELETED"]
+        ]
         | Omit = omit,
         task_metadata: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.

src/agentex/types/agent_rpc_by_name_params.py

@@ -12,13 +12,14 @@
     "Params",
     "ParamsCreateTaskRequest",
     "ParamsCancelTaskRequest",
+    "ParamsInterruptTaskRequest",
     "ParamsSendMessageRequest",
     "ParamsSendEventRequest",
 ]
 
 
 class AgentRpcByNameParams(TypedDict, total=False):
-    method: Required[Literal["event/send", "task/create", "message/send", "task/cancel"]]
+    method: Required[Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"]]
 
     params: Required[Params]
     """The parameters for the agent RPC request"""
@@ -61,6 +62,14 @@ class ParamsCancelTaskRequest(TypedDict, total=False):
     """The name of the task to cancel. Either this or task_id must be provided."""
 
 
+class ParamsInterruptTaskRequest(TypedDict, total=False):
+    task_id: Optional[str]
+    """The ID of the task to interrupt. Either this or task_name must be provided."""
+
+    task_name: Optional[str]
+    """The name of the task to interrupt. Either this or task_id must be provided."""
+
+
 class ParamsSendMessageRequest(TypedDict, total=False):
     content: Required[TaskMessageContentParam]
     """The message that was sent to the agent"""
@@ -90,5 +99,9 @@ class ParamsSendEventRequest(TypedDict, total=False):
 
 
 Params: TypeAlias = Union[
-    ParamsCreateTaskRequest, ParamsCancelTaskRequest, ParamsSendMessageRequest, ParamsSendEventRequest
+    ParamsCreateTaskRequest,
+    ParamsCancelTaskRequest,
+    ParamsInterruptTaskRequest,
+    ParamsSendMessageRequest,
+    ParamsSendEventRequest,
 ]

src/agentex/types/agent_rpc_params.py

@@ -12,13 +12,14 @@
     "Params",
     "ParamsCreateTaskRequest",
     "ParamsCancelTaskRequest",
+    "ParamsInterruptTaskRequest",
     "ParamsSendMessageRequest",
     "ParamsSendEventRequest",
 ]
 
 
 class AgentRpcParams(TypedDict, total=False):
-    method: Required[Literal["event/send", "task/create", "message/send", "task/cancel"]]
+    method: Required[Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"]]
 
     params: Required[Params]
     """The parameters for the agent RPC request"""
@@ -61,6 +62,14 @@ class ParamsCancelTaskRequest(TypedDict, total=False):
     """The name of the task to cancel. Either this or task_id must be provided."""
 
 
+class ParamsInterruptTaskRequest(TypedDict, total=False):
+    task_id: Optional[str]
+    """The ID of the task to interrupt. Either this or task_name must be provided."""
+
+    task_name: Optional[str]
+    """The name of the task to interrupt. Either this or task_id must be provided."""
+
+
 class ParamsSendMessageRequest(TypedDict, total=False):
     content: Required[TaskMessageContentParam]
     """The message that was sent to the agent"""
@@ -90,5 +99,9 @@ class ParamsSendEventRequest(TypedDict, total=False):
 
 
 Params: TypeAlias = Union[
-    ParamsCreateTaskRequest, ParamsCancelTaskRequest, ParamsSendMessageRequest, ParamsSendEventRequest
+    ParamsCreateTaskRequest,
+    ParamsCancelTaskRequest,
+    ParamsInterruptTaskRequest,
+    ParamsSendMessageRequest,
+    ParamsSendEventRequest,
 ]

src/agentex/types/agents/deployment_preview_rpc_params.py

@@ -12,6 +12,7 @@
     "Params",
     "ParamsCreateTaskRequest",
     "ParamsCancelTaskRequest",
+    "ParamsInterruptTaskRequest",
     "ParamsSendMessageRequest",
     "ParamsSendEventRequest",
 ]
@@ -20,7 +21,7 @@
 class DeploymentPreviewRpcParams(TypedDict, total=False):
     agent_id: Required[str]
 
-    method: Required[Literal["event/send", "task/create", "message/send", "task/cancel"]]
+    method: Required[Literal["event/send", "task/create", "message/send", "task/cancel", "task/interrupt"]]
 
     params: Required[Params]
     """The parameters for the agent RPC request"""
@@ -63,6 +64,14 @@ class ParamsCancelTaskRequest(TypedDict, total=False):
     """The name of the task to cancel. Either this or task_id must be provided."""
 
 
+class ParamsInterruptTaskRequest(TypedDict, total=False):
+    task_id: Optional[str]
+    """The ID of the task to interrupt. Either this or task_name must be provided."""
+
+    task_name: Optional[str]
+    """The name of the task to interrupt. Either this or task_id must be provided."""
+
+
 class ParamsSendMessageRequest(TypedDict, total=False):
     content: Required[TaskMessageContentParam]
     """The message that was sent to the agent"""
@@ -92,5 +101,9 @@ class ParamsSendEventRequest(TypedDict, total=False):
 
 
 Params: TypeAlias = Union[
-    ParamsCreateTaskRequest, ParamsCancelTaskRequest, ParamsSendMessageRequest, ParamsSendEventRequest
+    ParamsCreateTaskRequest,
+    ParamsCancelTaskRequest,
+    ParamsInterruptTaskRequest,
+    ParamsSendMessageRequest,
+    ParamsSendEventRequest,
 ]

src/agentex/types/task.py

@@ -20,7 +20,9 @@ class Task(BaseModel):
 
     params: Optional[Dict[str, object]] = None
 
-    status: Optional[Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "TERMINATED", "TIMED_OUT", "DELETED"]] = None
+    status: Optional[
+        Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "INTERRUPTED", "TERMINATED", "TIMED_OUT", "DELETED"]
+    ] = None
 
     status_reason: Optional[str] = None
 

src/agentex/types/task_list_params.py

@@ -23,7 +23,9 @@ class TaskListParams(TypedDict, total=False):
 
     relationships: List[Literal["agents"]]
 
-    status: Optional[Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "TERMINATED", "TIMED_OUT", "DELETED"]]
+    status: Optional[
+        Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "INTERRUPTED", "TERMINATED", "TIMED_OUT", "DELETED"]
+    ]
     """Filter tasks by status (e.g. RUNNING, COMPLETED)."""
 
     task_metadata: Optional[str]

src/agentex/types/task_list_response.py

@@ -25,7 +25,9 @@ class TaskListResponseItem(BaseModel):
 
     params: Optional[Dict[str, object]] = None
 
-    status: Optional[Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "TERMINATED", "TIMED_OUT", "DELETED"]] = None
+    status: Optional[
+        Literal["CANCELED", "COMPLETED", "FAILED", "RUNNING", "INTERRUPTED", "TERMINATED", "TIMED_OUT", "DELETED"]
+    ] = None
 
     status_reason: Optional[str] = None