feat(api): add agent_card_metadata parameter to agents list method

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 75
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-ee0c521f0612c31b874bd595b90cd9209545bab603983552a1a7a87f38ed931e.yml
-openapi_spec_hash: 917a1ffe9e353bed2740524dec786ed2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-fbc0683871d6abb03588f30d9468eeeeacb2b8538eb0c9002813e6df68c5802b.yml
+openapi_spec_hash: 4ecd8d496f056dccf80826264ddf8fe1
 config_hash: 593e89b291976a5e84e4c3c3f8324354

src/agentex/resources/agents/agents.py

@@ -116,6 +116,7 @@ def retrieve(
     def list(
         self,
         *,
+        agent_card_metadata: Optional[str] | Omit = omit,
         limit: int | Omit = omit,
         order_by: Optional[str] | Omit = omit,
         order_direction: str | Omit = omit,
@@ -132,6 +133,13 @@ def list(
         List all registered agents, optionally filtered by query parameters.
 
         Args:
+          agent_card_metadata: JSON-encoded object used to filter agents on
+              `registration_metadata.agent_card.metadata` via JSONB containment. Example:
+              {"permits_capable": true}. Only matches cards published through the direct
+              registration path: registrations that carry a `deployment_id` write the card to
+              the deployment record instead of `registration_metadata`, so those agents never
+              match this filter.
+
           limit: Limit
 
           order_by: Field to order by
@@ -159,6 +167,7 @@ def list(
                 timeout=timeout,
                 query=maybe_transform(
                     {
+                        "agent_card_metadata": agent_card_metadata,
                         "limit": limit,
                         "order_by": order_by,
                         "order_direction": order_direction,
@@ -777,6 +786,7 @@ async def retrieve(
     async def list(
         self,
         *,
+        agent_card_metadata: Optional[str] | Omit = omit,
         limit: int | Omit = omit,
         order_by: Optional[str] | Omit = omit,
         order_direction: str | Omit = omit,
@@ -793,6 +803,13 @@ async def list(
         List all registered agents, optionally filtered by query parameters.
 
         Args:
+          agent_card_metadata: JSON-encoded object used to filter agents on
+              `registration_metadata.agent_card.metadata` via JSONB containment. Example:
+              {"permits_capable": true}. Only matches cards published through the direct
+              registration path: registrations that carry a `deployment_id` write the card to
+              the deployment record instead of `registration_metadata`, so those agents never
+              match this filter.
+
           limit: Limit
 
           order_by: Field to order by
@@ -820,6 +837,7 @@ async def list(
                 timeout=timeout,
                 query=await async_maybe_transform(
                     {
+                        "agent_card_metadata": agent_card_metadata,
                         "limit": limit,
                         "order_by": order_by,
                         "order_direction": order_direction,

src/agentex/types/agent_list_params.py

@@ -9,6 +9,16 @@
 
 
 class AgentListParams(TypedDict, total=False):
+    agent_card_metadata: Optional[str]
+    """
+    JSON-encoded object used to filter agents on
+    `registration_metadata.agent_card.metadata` via JSONB containment. Example:
+    {"permits_capable": true}. Only matches cards published through the direct
+    registration path: registrations that carry a `deployment_id` write the card to
+    the deployment record instead of `registration_metadata`, so those agents never
+    match this filter.
+    """
+
     limit: int
     """Limit"""
 

tests/api_resources/test_agents.py

@@ -75,6 +75,7 @@ def test_method_list(self, client: Agentex) -> None:
     @parametrize
     def test_method_list_with_all_params(self, client: Agentex) -> None:
         agent = client.agents.list(
+            agent_card_metadata="agent_card_metadata",
             limit=1,
             order_by="order_by",
             order_direction="order_direction",
@@ -469,6 +470,7 @@ async def test_method_list(self, async_client: AsyncAgentex) -> None:
     @parametrize
     async def test_method_list_with_all_params(self, async_client: AsyncAgentex) -> None:
         agent = await async_client.agents.list(
+            agent_card_metadata="agent_card_metadata",
             limit=1,
             order_by="order_by",
             order_direction="order_direction",