robosystems-client 0.2.14__py3-none-any.whl → 0.2.16__py3-none-any.whl

robosystems_client/api/agent/auto_select_agent.py

@@ -1,5 +1,5 @@
 from http import HTTPStatus
-from typing import Any, Optional, Union, cast
+from typing import Any, cast
 
 import httpx
 
@@ -17,13 +17,13 @@ def _get_kwargs(
   graph_id: str,
   *,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
+  mode: None | ResponseMode | Unset = UNSET,
 ) -> dict[str, Any]:
   headers: dict[str, Any] = {}
 
   params: dict[str, Any] = {}
 
-  json_mode: Union[None, Unset, str]
+  json_mode: None | str | Unset
   if isinstance(mode, Unset):
     json_mode = UNSET
   elif isinstance(mode, ResponseMode):
@@ -49,8 +49,8 @@ def _get_kwargs(
 
 
 def _parse_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> AgentResponse | Any | ErrorResponse | HTTPValidationError | None:
   if response.status_code == 200:
     response_200 = AgentResponse.from_dict(response.json())
 
@@ -89,8 +89,8 @@ def _parse_response(
 
 
 def _build_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]:
   return Response(
     status_code=HTTPStatus(response.status_code),
     content=response.content,
@@ -104,8 +104,8 @@ def sync_detailed(
   *,
   client: AuthenticatedClient,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-) -> Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  mode: None | ResponseMode | Unset = UNSET,
+) -> Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]:
   r"""Auto-select agent for query
 
    Automatically select the best agent for your query with intelligent execution strategy.
@@ -158,12 +158,18 @@ def sync_detailed(
   - Leverage conversation history for contextual understanding
   - Enable RAG for knowledge base enrichment
 
+  **Subgraph Support:**
+  This endpoint accepts both parent graph IDs and subgraph IDs.
+  - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+  - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+  Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+  and knowledge base search are scoped to the specific graph/subgraph.
+
   See request/response examples in the \"Examples\" dropdown below.
 
   Args:
       graph_id (str):
-      mode (Union[None, ResponseMode, Unset]): Override execution mode: sync, async, stream, or
-          auto
+      mode (None | ResponseMode | Unset): Override execution mode: sync, async, stream, or auto
       body (AgentRequest): Request model for agent interactions.
 
   Raises:
@@ -171,7 +177,7 @@ def sync_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]
+      Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -192,8 +198,8 @@ def sync(
   *,
   client: AuthenticatedClient,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-) -> Optional[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  mode: None | ResponseMode | Unset = UNSET,
+) -> AgentResponse | Any | ErrorResponse | HTTPValidationError | None:
   r"""Auto-select agent for query
 
    Automatically select the best agent for your query with intelligent execution strategy.
@@ -246,12 +252,18 @@ def sync(
   - Leverage conversation history for contextual understanding
   - Enable RAG for knowledge base enrichment
 
+  **Subgraph Support:**
+  This endpoint accepts both parent graph IDs and subgraph IDs.
+  - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+  - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+  Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+  and knowledge base search are scoped to the specific graph/subgraph.
+
   See request/response examples in the \"Examples\" dropdown below.
 
   Args:
       graph_id (str):
-      mode (Union[None, ResponseMode, Unset]): Override execution mode: sync, async, stream, or
-          auto
+      mode (None | ResponseMode | Unset): Override execution mode: sync, async, stream, or auto
       body (AgentRequest): Request model for agent interactions.
 
   Raises:
@@ -259,7 +271,7 @@ def sync(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]
+      AgentResponse | Any | ErrorResponse | HTTPValidationError
   """
 
   return sync_detailed(
@@ -275,8 +287,8 @@ async def asyncio_detailed(
   *,
   client: AuthenticatedClient,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-) -> Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  mode: None | ResponseMode | Unset = UNSET,
+) -> Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]:
   r"""Auto-select agent for query
 
    Automatically select the best agent for your query with intelligent execution strategy.
@@ -329,12 +341,18 @@ async def asyncio_detailed(
   - Leverage conversation history for contextual understanding
   - Enable RAG for knowledge base enrichment
 
+  **Subgraph Support:**
+  This endpoint accepts both parent graph IDs and subgraph IDs.
+  - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+  - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+  Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+  and knowledge base search are scoped to the specific graph/subgraph.
+
   See request/response examples in the \"Examples\" dropdown below.
 
   Args:
       graph_id (str):
-      mode (Union[None, ResponseMode, Unset]): Override execution mode: sync, async, stream, or
-          auto
+      mode (None | ResponseMode | Unset): Override execution mode: sync, async, stream, or auto
       body (AgentRequest): Request model for agent interactions.
 
   Raises:
@@ -342,7 +360,7 @@ async def asyncio_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]
+      Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -361,8 +379,8 @@ async def asyncio(
   *,
   client: AuthenticatedClient,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-) -> Optional[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  mode: None | ResponseMode | Unset = UNSET,
+) -> AgentResponse | Any | ErrorResponse | HTTPValidationError | None:
   r"""Auto-select agent for query
 
    Automatically select the best agent for your query with intelligent execution strategy.
@@ -415,12 +433,18 @@ async def asyncio(
   - Leverage conversation history for contextual understanding
   - Enable RAG for knowledge base enrichment
 
+  **Subgraph Support:**
+  This endpoint accepts both parent graph IDs and subgraph IDs.
+  - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+  - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+  Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+  and knowledge base search are scoped to the specific graph/subgraph.
+
   See request/response examples in the \"Examples\" dropdown below.
 
   Args:
       graph_id (str):
-      mode (Union[None, ResponseMode, Unset]): Override execution mode: sync, async, stream, or
-          auto
+      mode (None | ResponseMode | Unset): Override execution mode: sync, async, stream, or auto
       body (AgentRequest): Request model for agent interactions.
 
   Raises:
@@ -428,7 +452,7 @@ async def asyncio(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]
+      AgentResponse | Any | ErrorResponse | HTTPValidationError
   """
 
   return (

robosystems_client/api/agent/batch_process_queries.py

@@ -1,5 +1,5 @@
 from http import HTTPStatus
-from typing import Any, Optional, Union, cast
+from typing import Any, cast
 
 import httpx
 
@@ -32,8 +32,8 @@ def _get_kwargs(
 
 
 def _parse_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[Any, BatchAgentResponse, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Any | BatchAgentResponse | HTTPValidationError | None:
   if response.status_code == 200:
     response_200 = BatchAgentResponse.from_dict(response.json())
 
@@ -63,8 +63,8 @@ def _parse_response(
 
 
 def _build_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[Any, BatchAgentResponse, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[Any | BatchAgentResponse | HTTPValidationError]:
   return Response(
     status_code=HTTPStatus(response.status_code),
     content=response.content,
@@ -78,7 +78,7 @@ def sync_detailed(
   *,
   client: AuthenticatedClient,
   body: BatchAgentRequest,
-) -> Response[Union[Any, BatchAgentResponse, HTTPValidationError]]:
+) -> Response[Any | BatchAgentResponse | HTTPValidationError]:
   """Batch process multiple queries
 
    Process multiple queries either sequentially or in parallel.
@@ -105,7 +105,7 @@ def sync_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[Any, BatchAgentResponse, HTTPValidationError]]
+      Response[Any | BatchAgentResponse | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -125,7 +125,7 @@ def sync(
   *,
   client: AuthenticatedClient,
   body: BatchAgentRequest,
-) -> Optional[Union[Any, BatchAgentResponse, HTTPValidationError]]:
+) -> Any | BatchAgentResponse | HTTPValidationError | None:
   """Batch process multiple queries
 
    Process multiple queries either sequentially or in parallel.
@@ -152,7 +152,7 @@ def sync(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[Any, BatchAgentResponse, HTTPValidationError]
+      Any | BatchAgentResponse | HTTPValidationError
   """
 
   return sync_detailed(
@@ -167,7 +167,7 @@ async def asyncio_detailed(
   *,
   client: AuthenticatedClient,
   body: BatchAgentRequest,
-) -> Response[Union[Any, BatchAgentResponse, HTTPValidationError]]:
+) -> Response[Any | BatchAgentResponse | HTTPValidationError]:
   """Batch process multiple queries
 
    Process multiple queries either sequentially or in parallel.
@@ -194,7 +194,7 @@ async def asyncio_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[Any, BatchAgentResponse, HTTPValidationError]]
+      Response[Any | BatchAgentResponse | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -212,7 +212,7 @@ async def asyncio(
   *,
   client: AuthenticatedClient,
   body: BatchAgentRequest,
-) -> Optional[Union[Any, BatchAgentResponse, HTTPValidationError]]:
+) -> Any | BatchAgentResponse | HTTPValidationError | None:
   """Batch process multiple queries
 
    Process multiple queries either sequentially or in parallel.
@@ -239,7 +239,7 @@ async def asyncio(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[Any, BatchAgentResponse, HTTPValidationError]
+      Any | BatchAgentResponse | HTTPValidationError
   """
 
   return (

robosystems_client/api/agent/execute_specific_agent.py

@@ -1,5 +1,5 @@
 from http import HTTPStatus
-from typing import Any, Optional, Union, cast
+from typing import Any, cast
 
 import httpx
 
@@ -18,13 +18,13 @@ def _get_kwargs(
   agent_type: str,
   *,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
+  mode: None | ResponseMode | Unset = UNSET,
 ) -> dict[str, Any]:
   headers: dict[str, Any] = {}
 
   params: dict[str, Any] = {}
 
-  json_mode: Union[None, Unset, str]
+  json_mode: None | str | Unset
   if isinstance(mode, Unset):
     json_mode = UNSET
   elif isinstance(mode, ResponseMode):
@@ -50,8 +50,8 @@ def _get_kwargs(
 
 
 def _parse_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> AgentResponse | Any | ErrorResponse | HTTPValidationError | None:
   if response.status_code == 200:
     response_200 = AgentResponse.from_dict(response.json())
 
@@ -94,8 +94,8 @@ def _parse_response(
 
 
 def _build_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]:
   return Response(
     status_code=HTTPStatus(response.status_code),
     content=response.content,
@@ -110,8 +110,8 @@ def sync_detailed(
   *,
   client: AuthenticatedClient,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-) -> Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  mode: None | ResponseMode | Unset = UNSET,
+) -> Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]:
   """Execute specific agent
 
    Execute a specific agent type directly with intelligent execution strategy.
@@ -134,8 +134,7 @@ def sync_detailed(
   Args:
       graph_id (str):
       agent_type (str):
-      mode (Union[None, ResponseMode, Unset]): Override execution mode: sync, async, stream, or
-          auto
+      mode (None | ResponseMode | Unset): Override execution mode: sync, async, stream, or auto
       body (AgentRequest): Request model for agent interactions.
 
   Raises:
@@ -143,7 +142,7 @@ def sync_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]
+      Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -166,8 +165,8 @@ def sync(
   *,
   client: AuthenticatedClient,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-) -> Optional[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  mode: None | ResponseMode | Unset = UNSET,
+) -> AgentResponse | Any | ErrorResponse | HTTPValidationError | None:
   """Execute specific agent
 
    Execute a specific agent type directly with intelligent execution strategy.
@@ -190,8 +189,7 @@ def sync(
   Args:
       graph_id (str):
       agent_type (str):
-      mode (Union[None, ResponseMode, Unset]): Override execution mode: sync, async, stream, or
-          auto
+      mode (None | ResponseMode | Unset): Override execution mode: sync, async, stream, or auto
       body (AgentRequest): Request model for agent interactions.
 
   Raises:
@@ -199,7 +197,7 @@ def sync(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]
+      AgentResponse | Any | ErrorResponse | HTTPValidationError
   """
 
   return sync_detailed(
@@ -217,8 +215,8 @@ async def asyncio_detailed(
   *,
   client: AuthenticatedClient,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-) -> Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  mode: None | ResponseMode | Unset = UNSET,
+) -> Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]:
   """Execute specific agent
 
    Execute a specific agent type directly with intelligent execution strategy.
@@ -241,8 +239,7 @@ async def asyncio_detailed(
   Args:
       graph_id (str):
       agent_type (str):
-      mode (Union[None, ResponseMode, Unset]): Override execution mode: sync, async, stream, or
-          auto
+      mode (None | ResponseMode | Unset): Override execution mode: sync, async, stream, or auto
       body (AgentRequest): Request model for agent interactions.
 
   Raises:
@@ -250,7 +247,7 @@ async def asyncio_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]
+      Response[AgentResponse | Any | ErrorResponse | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -271,8 +268,8 @@ async def asyncio(
   *,
   client: AuthenticatedClient,
   body: AgentRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-) -> Optional[Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]]:
+  mode: None | ResponseMode | Unset = UNSET,
+) -> AgentResponse | Any | ErrorResponse | HTTPValidationError | None:
   """Execute specific agent
 
    Execute a specific agent type directly with intelligent execution strategy.
@@ -295,8 +292,7 @@ async def asyncio(
   Args:
       graph_id (str):
       agent_type (str):
-      mode (Union[None, ResponseMode, Unset]): Override execution mode: sync, async, stream, or
-          auto
+      mode (None | ResponseMode | Unset): Override execution mode: sync, async, stream, or auto
       body (AgentRequest): Request model for agent interactions.
 
   Raises:
@@ -304,7 +300,7 @@ async def asyncio(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[AgentResponse, Any, ErrorResponse, HTTPValidationError]
+      AgentResponse | Any | ErrorResponse | HTTPValidationError
   """
 
   return (

robosystems_client/api/agent/get_agent_metadata.py

@@ -1,5 +1,5 @@
 from http import HTTPStatus
-from typing import Any, Optional, Union, cast
+from typing import Any, cast
 
 import httpx
 
@@ -23,8 +23,8 @@ def _get_kwargs(
 
 
 def _parse_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[AgentMetadataResponse, Any, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> AgentMetadataResponse | Any | HTTPValidationError | None:
   if response.status_code == 200:
     response_200 = AgentMetadataResponse.from_dict(response.json())
 
@@ -46,8 +46,8 @@ def _parse_response(
 
 
 def _build_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[AgentMetadataResponse, Any, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[AgentMetadataResponse | Any | HTTPValidationError]:
   return Response(
     status_code=HTTPStatus(response.status_code),
     content=response.content,
@@ -61,7 +61,7 @@ def sync_detailed(
   agent_type: str,
   *,
   client: AuthenticatedClient,
-) -> Response[Union[AgentMetadataResponse, Any, HTTPValidationError]]:
+) -> Response[AgentMetadataResponse | Any | HTTPValidationError]:
   """Get agent metadata
 
    Get comprehensive metadata for a specific agent type.
@@ -85,7 +85,7 @@ def sync_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[AgentMetadataResponse, Any, HTTPValidationError]]
+      Response[AgentMetadataResponse | Any | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -105,7 +105,7 @@ def sync(
   agent_type: str,
   *,
   client: AuthenticatedClient,
-) -> Optional[Union[AgentMetadataResponse, Any, HTTPValidationError]]:
+) -> AgentMetadataResponse | Any | HTTPValidationError | None:
   """Get agent metadata
 
    Get comprehensive metadata for a specific agent type.
@@ -129,7 +129,7 @@ def sync(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[AgentMetadataResponse, Any, HTTPValidationError]
+      AgentMetadataResponse | Any | HTTPValidationError
   """
 
   return sync_detailed(
@@ -144,7 +144,7 @@ async def asyncio_detailed(
   agent_type: str,
   *,
   client: AuthenticatedClient,
-) -> Response[Union[AgentMetadataResponse, Any, HTTPValidationError]]:
+) -> Response[AgentMetadataResponse | Any | HTTPValidationError]:
   """Get agent metadata
 
    Get comprehensive metadata for a specific agent type.
@@ -168,7 +168,7 @@ async def asyncio_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[AgentMetadataResponse, Any, HTTPValidationError]]
+      Response[AgentMetadataResponse | Any | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -186,7 +186,7 @@ async def asyncio(
   agent_type: str,
   *,
   client: AuthenticatedClient,
-) -> Optional[Union[AgentMetadataResponse, Any, HTTPValidationError]]:
+) -> AgentMetadataResponse | Any | HTTPValidationError | None:
   """Get agent metadata
 
    Get comprehensive metadata for a specific agent type.
@@ -210,7 +210,7 @@ async def asyncio(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[AgentMetadataResponse, Any, HTTPValidationError]
+      AgentMetadataResponse | Any | HTTPValidationError
   """
 
   return (