Add discovery API to Python SDK

openapi/openapi.yml

@@ -1209,6 +1209,31 @@ paths:
           format: uuid
         description: Organization ID. This is required for access control. It can
           be provided via query or request body depending on the endpoint.
+  /v1/agents/models/:
+    get:
+      operationId: discovery_supported_models_list
+      description: Returns non-deprecated text-capable model IDs accepted in engine_config.model,
+        with capability and context metadata. Use this before create_agent or create_agent_version
+        when choosing a model. The list is tenant-agnostic and excludes customer-specific
+        or deployment-specific providers.
+      summary: List supported model IDs
+      parameters:
+      - in: query
+        name: capability
+        schema:
+          type: string
+        description: 'Optional capability filter: image, audio, or video (text-capable
+          models are always included)'
+      tags:
+      - discovery
+      - sdk
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SupportedLLMModelList'
+          description: ''
   /v1/agents/run/{agent_id}/:
     post:
       operationId: agents_run
@@ -1621,6 +1646,24 @@ paths:
                   value:
                     error: Internal server error
           description: Internal server error
+  /v1/agents/types/:
+    get:
+      operationId: discovery_agent_engine_types_list
+      description: Returns the production engine_class_id values accepted by agent
+        creation APIs, plus human-readable metadata and input schemas. Use this before
+        create_agent or create_agent_version when choosing an engine and constructing
+        engine_config.
+      summary: List supported agent engine types
+      tags:
+      - discovery
+      - sdk
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentEngineTypeList'
+          description: ''
   /v1/policies/:
     get:
       operationId: policies_list
@@ -1964,6 +2007,30 @@ components:
       - data_type
       - key
       - value
+    AgentEngineTypeList:
+      type: object
+      description: Serializer for public agent engine type discovery.
+      properties:
+        engine_types:
+          type: array
+          items:
+            type: string
+          description: Valid agent engine_class_id values accepted by create-agent
+            APIs
+        total_count:
+          type: integer
+          description: Number of engine types returned
+        engines:
+          type: array
+          items:
+            type: object
+            additionalProperties: {}
+          description: Production agent engine metadata, including descriptions, input
+            schemas, and default engine_config values
+      required:
+      - engine_types
+      - engines
+      - total_count
     AgentExecutionRequestRequest:
       type: object
       description: Serializer for agent execution requests with dynamic input fields.
@@ -2734,6 +2801,68 @@ components:
       - display_name
       - email
       - id
+    SupportedLLMModel:
+      type: object
+      description: Serializer for tenant-agnostic supported LLM metadata.
+      properties:
+        id:
+          type: string
+          description: Model identifier accepted in engine_config.model
+        providers:
+          type: array
+          items:
+            type: string
+          description: Non-customer-specific providers registered for this model
+        capabilities:
+          type: array
+          items:
+            type: string
+          description: Input capabilities supported by this model
+        context_window:
+          type: integer
+          description: Largest context window across global providers
+        max_output_tokens:
+          type: integer
+          description: Largest max output token limit across global providers
+        supports_system_message:
+          type: boolean
+        supports_temperature:
+          type: boolean
+        supports_reasoning_effort:
+          type: boolean
+        supports_json_output:
+          type: boolean
+        supports_json_schema:
+          type: boolean
+      required:
+      - capabilities
+      - context_window
+      - id
+      - max_output_tokens
+      - providers
+      - supports_json_output
+      - supports_json_schema
+      - supports_reasoning_effort
+      - supports_system_message
+      - supports_temperature
+    SupportedLLMModelList:
+      type: object
+      description: Serializer for non-deprecated LLM discovery.
+      properties:
+        models:
+          type: array
+          items:
+            $ref: '#/components/schemas/SupportedLLMModel'
+        total_count:
+          type: integer
+        tenant_scope:
+          type: string
+          description: Scope of the model list; this endpoint returns all-tenants
+            models
+      required:
+      - models
+      - tenant_scope
+      - total_count
     UpdatePolicy:
       type: object
       description: Serializer for updating policy metadata (name, description)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "roe-ai"
-version = "1.0.801"
+version = "1.0.802"
 authors = [
     { name = "Roe AI", email = "founders@roe-ai.com" },
 ]

src/roe/_generated/api/discovery/__init__.py

@@ -0,0 +1 @@
+""" Contains endpoint functions for accessing the API """

src/roe/_generated/api/discovery/discovery_agent_engine_types_list.py

@@ -0,0 +1,166 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.agent_engine_type_list import AgentEngineTypeList
+from typing import cast
+
+
+
+def _get_kwargs(
+
+) -> dict[str, Any]:
+
+
+
+
+
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/agents/types/",
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> AgentEngineTypeList | None:
+    if response.status_code == 200:
+        response_200 = AgentEngineTypeList.from_dict(response.json())
+
+
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[AgentEngineTypeList]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[AgentEngineTypeList]:
+    """ List supported agent engine types
+
+     Returns the production engine_class_id values accepted by agent creation APIs, plus human-readable
+    metadata and input schemas. Use this before create_agent or create_agent_version when choosing an
+    engine and constructing engine_config.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AgentEngineTypeList]
+     """
+
+
+    kwargs = _get_kwargs(
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> AgentEngineTypeList | None:
+    """ List supported agent engine types
+
+     Returns the production engine_class_id values accepted by agent creation APIs, plus human-readable
+    metadata and input schemas. Use this before create_agent or create_agent_version when choosing an
+    engine and constructing engine_config.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AgentEngineTypeList
+     """
+
+
+    return sync_detailed(
+        client=client,
+
+    ).parsed
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[AgentEngineTypeList]:
+    """ List supported agent engine types
+
+     Returns the production engine_class_id values accepted by agent creation APIs, plus human-readable
+    metadata and input schemas. Use this before create_agent or create_agent_version when choosing an
+    engine and constructing engine_config.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AgentEngineTypeList]
+     """
+
+
+    kwargs = _get_kwargs(
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> AgentEngineTypeList | None:
+    """ List supported agent engine types
+
+     Returns the production engine_class_id values accepted by agent creation APIs, plus human-readable
+    metadata and input schemas. Use this before create_agent or create_agent_version when choosing an
+    engine and constructing engine_config.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AgentEngineTypeList
+     """
+
+
+    return (await asyncio_detailed(
+        client=client,
+
+    )).parsed