feat: model list

docs/cli.mdx

@@ -217,6 +217,16 @@ sandbox-agent api agents modes <AGENT>
 sandbox-agent api agents modes claude
 ```
 
+#### Get Agent Models
+
+```bash
+sandbox-agent api agents models <AGENT>
+```
+
+```bash
+sandbox-agent api agents models claude
+```
+
 ---
 
 ### Sessions
@@ -377,6 +387,7 @@ sandbox-agent api sessions reply-permission my-session perm1 --reply once
 | `api agents list` | `GET /v1/agents` |
 | `api agents install` | `POST /v1/agents/{agent}/install` |
 | `api agents modes` | `GET /v1/agents/{agent}/modes` |
+| `api agents models` | `GET /v1/agents/{agent}/models` |
 | `api sessions list` | `GET /v1/sessions` |
 | `api sessions create` | `POST /v1/sessions/{sessionId}` |
 | `api sessions send-message` | `POST /v1/sessions/{sessionId}/messages` |

docs/openapi.json

@@ -102,6 +102,47 @@
         }
       }
     },
+    "/v1/agents/{agent}/models": {
+      "get": {
+        "tags": [
+          "agents"
+        ],
+        "operationId": "get_agent_models",
+        "parameters": [
+          {
+            "name": "agent",
+            "in": "path",
+            "description": "Agent id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentModelsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/agents/{agent}/modes": {
       "get": {
         "tags": [
@@ -669,6 +710,7 @@
           "mcpTools",
           "streamingDeltas",
           "itemStarted",
+          "variants",
           "sharedProcess"
         ],
         "properties": {
@@ -726,6 +768,9 @@
           },
           "toolResults": {
             "type": "boolean"
+          },
+          "variants": {
+            "type": "boolean"
           }
         }
       },
@@ -832,6 +877,50 @@
           }
         }
       },
+      "AgentModelInfo": {
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "defaultVariant": {
+            "type": "string",
+            "nullable": true
+          },
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "variants": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        }
+      },
+      "AgentModelsResponse": {
+        "type": "object",
+        "required": [
+          "models"
+        ],
+        "properties": {
+          "defaultModel": {
+            "type": "string",
+            "nullable": true
+          },
+          "models": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AgentModelInfo"
+            }
+          }
+        }
+      },
       "AgentModesResponse": {
         "type": "object",
         "required": [

docs/session-transcript-schema.mdx

@@ -29,6 +29,7 @@ This table shows which agent feature coverage appears in the universal event str
 | File Changes       |   -    |   ✓   |      -       |      -       |
 | MCP Tools          |   -    |   ✓   |      -       |      -       |
 | Streaming Deltas   |   ✓    |   ✓   |      ✓       |      -       |
+| Variants           |        |   ✓   |      ✓       |      ✓       |
 
 Agents: [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) · [Codex](https://github.com/openai/codex) · [OpenCode](https://github.com/opencode-ai/opencode) · [Amp](https://ampcode.com)
 
@@ -76,6 +77,9 @@ Agents: [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude
   <Accordion title="Streaming Deltas">
     Native streaming of content deltas. When not supported, the daemon emits a single synthetic delta before `item.completed`.
   </Accordion>
+  <Accordion title="Variants">
+    Model variants such as reasoning effort or depth. Agents may expose different variant sets per model.
+  </Accordion>
 </AccordionGroup>
 
 Want support for another agent? [Open an issue](https://github.com/rivet-dev/sandbox-agent/issues/new) to request it.