miniopenenv

tests/fixtures/reference-corpus.json → html

The corpus

Byte-exact capture. HTTP entries include the status line and headers. WS entries include the RFC 6455 handshake.

tests/fixtures/reference-corpus.json · 103 byte-exact cases · 78 HTTP · 25 WebSocket · reference revision 60ecc7b7

>>
bytes the client sent
<<
bytes the server sent
~
a WebSocket frame boundary — never a byte
CASE 0 · HTTP · :8901

GET /health

>> GET /health HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 20
<< content-type: application/json
<< connection: close
<<
<< {"status":"healthy"}
CASE 1 · HTTP · :8901

GET /metadata

>> GET /metadata HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 155
<< content-type: application/json
<< connection: close
<<
<< {"name":"CounterEnvironment","description":"CounterEnvironment environment","readme_content":null,"version":"1.0.0","author":null,"documentation_url":null}
CASE 2 · HTTP · :8901

GET /schema

>> GET /schema HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 1468
<< content-type: application/json
<< connection: close
<<
<< {"action":{"additionalProperties":false,"properties":{"metadata":{"additionalProperties":true,"description":"Additional metadata for the action","title":"Metadata","type":"object"},"amount":{"default":1,"title":"Amount","type":"integer"},"note":{"default":"","title":"Note","type":"string"}},"title":"CounterAction","type":"object"},"observation":{"additionalProperties":false,"properties":{"done":{"default":false,"description":"Whether the episode has terminated","title":"Done","type":"boolean"},"reward":{"anyOf":[{"type":"boolean"},{"type":"integer"},{"type":"number"},{"type":"null"}],"default":null,"description":"Reward signal from the last action","title":"Reward"},"metadata":{"additionalProperties":true,"description":"Additional metadata for the observation","title":"Metadata","type":"object"},"total":{"default":0,"title":"Total","type":"integer"},"last_note":{"default":"","title":"Last Note","type":"string"}},"title":"CounterObservation","type":"object"},"state":{"additionalProperties":true,"description":"Base class for environment state.\n\nRepresents internal environment state, separate from observations.","properties":{"episode_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Unique identifier for the current episode","title":"Episode Id"},"step_count":{"default":0,"description":"Number of steps taken in the current episode","minimum":0,"title":"Step Count","type":"integer"}},"title":"State","type":"object"}}
CASE 3 · HTTP · :8901

GET /state

>> GET /state HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 34
<< content-type: application/json
<< connection: close
<<
<< {"episode_id":null,"step_count":0}
CASE 4 · HTTP · :8901

GET /openapi.json

>> GET /openapi.json HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 17082
<< content-type: application/json
<< connection: close
<<
<< {"openapi":"3.1.0","info":{"title":"OpenEnv Environment HTTP API","description":"\n# OpenEnv Environment HTTP API\n\nHTTP API for interacting with OpenEnv environments through a standardized interface.\n\n## Features\n\n* **Environment Reset**: Initialize or restart episodes\n* **Action Execution**: Send actions and receive observations\n* **State Inspection**: Query current environment state\n* **Schema Access**: Retrieve JSON schemas for actions and observations\n\n## Workflow\n\n1. Call `/reset` to start a new episode and get initial observation\n2. Call `/step` repeatedly with actions to interact with environment\n3. Episode ends when observation returns `done: true`\n4. Call `/state` anytime to inspect current environment state\n\n## Documentation\n\n* **Swagger UI**: Available at `/docs`\n* **ReDoc**: Available at `/redoc`\n* **OpenAPI Schema**: Available at `/openapi.json`\n        ","contact":{"name":"OpenEnv Team","url":"https://github.com/huggingface/OpenEnv"},"license":{"name":"BSD-3-Clause","url":"https://github.com/huggingface/OpenEnv/blob/main/LICENSE"},"version":"1.0.0"},"paths":{"/list_environments":{"get":{"tags":["Task API"],"summary":"List Environments","operationId":"list_environments_list_environments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response List Environments List Environments Get"}}}}}}},"/{env_name}/splits":{"get":{"tags":["Task API"],"summary":"List Splits","operationId":"list_splits__env_name__splits_get","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Splits  Env Name  Splits Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{env_name}/tasks":{"post":{"tags":["Task API"],"summary":"List Tasks","operationId":"list_tasks__env_name__tasks_post","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListTasksRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Tasks  Env Name  Tasks Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{env_name}/num_tasks":{"post":{"tags":["Task API"],"summary":"Num Tasks","operationId":"num_tasks__env_name__num_tasks_post","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumTasksRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Num Tasks  Env Name  Num Tasks Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{env_name}/task":{"post":{"tags":["Task API"],"summary":"Get Task","operationId":"get_task__env_name__task_post","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTaskRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Task  Env Name  Task Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{env_name}/task_range":{"post":{"tags":["Task API"],"summary":"Get Task Range","operationId":"get_task_range__env_name__task_range_post","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTaskRangeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Task Range  Env Name  Task Range Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/reset":{"post":{"tags":["Environment Control"],"summary":"Reset the environment","description":"Reset the environment to its initial state and return the first observation.\n\nYou can optionally provide a seed for reproducibility and an episode_id for tracking.","operationId":"reset_reset_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetRequest"}}}},"responses":{"200":{"description":"Environment reset successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetResponse"},"example":{"observation":{"status":"ready","data":{}},"done":false}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/step":{"post":{"tags":["Environment Control"],"summary":"Execute an action in the environment","description":"Execute an action in the environment and receive the resulting observation.\n\nThe action must conform to the environment's action schema, which can be\nretrieved from the `/schema` endpoint. If the action is invalid,\nthe endpoint will return HTTP 422 with detailed validation errors.\n\nThe response includes:\n- **observation**: The environment's response to the action\n- **reward**: Optional reward signal (float or None)\n- **done**: Boolean indicating if the episode has terminated","operationId":"step_step_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StepRequest"}}},"required":true},"responses":{"200":{"description":"Action executed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StepResponse"},"example":{"observation":{"status":"success","data":{}},"reward":1.0,"done":false}}}},"422":{"description":"Validation error - invalid action format or values","content":{"application/json":{"example":{"detail":[{"type":"string_too_short","loc":["body","action","message"],"msg":"String should have at least 1 character","input":""}]}}}},"500":{"description":"Internal server error during action execution"}}}},"/state":{"get":{"tags":["State Management"],"summary":"Get current environment state","description":"Retrieve the current internal state of the environment.\n\nThe structure of the state object is defined by the environment's State model.","operationId":"endpoint_state_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/State"}}}}}}},"/metadata":{"get":{"tags":["Environment Info"],"summary":"Get environment metadata","description":"Get metadata about this environment.\n\nReturns information about the environment including name, description,\nversion, author, and documentation links.","operationId":"endpoint_metadata_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvironmentMetadata"}}}}}}},"/health":{"get":{"tags":["Health"],"summary":"Health check","description":"Check if the environment server is running and healthy.","operationId":"endpoint_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/schema":{"get":{"tags":["Schema"],"summary":"Get all JSON schemas","description":"Get JSON schemas for actions, observations, and state in a single response.\n\nReturns a combined schema object containing:\n- **action**: JSON schema for actions accepted by this environment\n- **observation**: JSON schema for observations returned by this environment\n- **state**: JSON schema for environment state objects\n\nThis is more efficient than calling individual schema endpoints and provides\nall schema information needed to interact with the environment.","operationId":"get_schemas_schema_get","responses":{"200":{"description":"Combined schemas retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchemaResponse"},"example":{"action":{"type":"object","properties":{"message":{"type":"string"}}},"observation":{"type":"object","properties":{"response":{"type":"string"}}},"state":{"type":"object","properties":{"step_count":{"type":"integer"}}}}}}}}}},"/mcp":{"post":{"summary":"Mcp Endpoint","description":"MCP JSON-RPC endpoint for production mode.\n\nBypasses step() overhead and provides direct access to MCP tools.\nSupports tools/list and tools/call methods.","operationId":"mcp_endpoint_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mcp Endpoint Mcp Post"}}}}}}}},"components":{"schemas":{"EnvironmentMetadata":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the environment"},"description":{"type":"string","title":"Description","description":"Description of what the environment does"},"readme_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Readme Content","description":"Content of the README file for the environment"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","description":"Version of the environment"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"Author of the environment"},"documentation_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Documentation Url","description":"URL to the environment's documentation"}},"additionalProperties":false,"type":"object","required":["name","description"],"title":"EnvironmentMetadata","description":"Metadata about an environment for documentation and UI purposes."},"GetTaskRangeRequest":{"properties":{"split":{"type":"string","title":"Split","description":"Task split name"},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start","description":"Inclusive start index"},"stop":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stop","description":"Exclusive stop index"}},"additionalProperties":false,"type":"object","required":["split"],"title":"GetTaskRangeRequest","description":"Request model for ORS-compatible task range lookup."},"GetTaskRequest":{"properties":{"split":{"type":"string","title":"Split","description":"Task split name"},"index":{"type":"integer","title":"Index","description":"Task index within the split"}},"additionalProperties":false,"type":"object","required":["split","index"],"title":"GetTaskRequest","description":"Request model for ORS-compatible task lookup."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"$ref":"#/components/schemas/HealthStatus","description":"Health status of the environment server","default":"healthy"}},"additionalProperties":false,"type":"object","title":"HealthResponse","description":"Response model for health check endpoint."},"HealthStatus":{"type":"string","enum":["healthy","unhealthy","degraded"],"title":"HealthStatus","description":"Server health status values."},"ListTasksRequest":{"properties":{"split":{"type":"string","title":"Split","description":"Task split name"}},"additionalProperties":false,"type":"object","required":["split"],"title":"ListTasksRequest","description":"Request model for ORS-compatible task listing."},"NumTasksRequest":{"properties":{"split":{"type":"string","title":"Split","description":"Task split name"}},"additionalProperties":false,"type":"object","required":["split"],"title":"NumTasksRequest","description":"Request model for ORS-compatible task counts."},"ResetRequest":{"properties":{"seed":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Seed","description":"Random seed for reproducible episodes"},"episode_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Episode Id","description":"Custom episode identifier"}},"additionalProperties":true,"type":"object","title":"ResetRequest","description":"Request model for environment reset.","examples":[{"episode_id":"episode-001","seed":42},{}]},"ResetResponse":{"properties":{"observation":{"additionalProperties":true,"type":"object","title":"Observation","description":"Initial observation from the environment"},"reward":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward","description":"Initial reward (typically None at reset)"},"done":{"type":"boolean","title":"Done","description":"Whether episode is already done (typically False)","default":false},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata from the environment"}},"additionalProperties":false,"type":"object","required":["observation"],"title":"ResetResponse","description":"Response model for environment reset."},"SchemaResponse":{"properties":{"action":{"additionalProperties":true,"type":"object","title":"Action","description":"JSON schema for actions accepted by this environment"},"observation":{"additionalProperties":true,"type":"object","title":"Observation","description":"JSON schema for observations returned by this environment"},"state":{"additionalProperties":true,"type":"object","title":"State","description":"JSON schema for environment state objects"}},"additionalProperties":false,"type":"object","required":["action","observation","state"],"title":"SchemaResponse","description":"Response model for the combined schema endpoint."},"State":{"properties":{"episode_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Episode Id","description":"Unique identifier for the current episode"},"step_count":{"type":"integer","minimum":0.0,"title":"Step Count","description":"Number of steps taken in the current episode","default":0}},"additionalProperties":true,"type":"object","title":"State","description":"Base class for environment state.\n\nRepresents internal environment state, separate from observations."},"StepRequest":{"properties":{"action":{"additionalProperties":true,"type":"object","title":"Action","description":"Action to execute, must conform to environment's action schema"},"timeout_s":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Timeout S","description":"Optional timeout in seconds for action execution"},"request_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Request Id","description":"Optional request identifier for tracking"}},"additionalProperties":true,"type":"object","required":["action"],"title":"StepRequest","description":"Request model for environment step.","examples":[{"action":{"value":1},"timeout_s":30.0},{"action":{"value":1},"render":true,"verbose":false}]},"StepResponse":{"properties":{"observation":{"additionalProperties":true,"type":"object","title":"Observation","description":"Observation resulting from the action"},"reward":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward","description":"Reward signal from the action"},"done":{"type":"boolean","title":"Done","description":"Whether the episode has terminated","default":false},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata from the environment"}},"additionalProperties":false,"type":"object","required":["observation"],"title":"StepResponse","description":"Response model for environment step."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"Environment Control","description":"Core operations for environment interaction (reset, step)"},{"name":"State Management","description":"Operations for inspecting environment state"},{"name":"Environment Info","description":"Information about the environment"},{"name":"Schema","description":"JSON Schema endpoints for actions, observations, and state"},{"name":"Health","description":"Service health and status checks"}]}
CASE 5 · HTTP · :8901

GET /list_environments

>> GET /list_environments HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 15
<< content-type: application/json
<< connection: close
<<
<< ["counter_env"]
CASE 6 · HTTP · :8901

GET /health/ (trailing slash -> 307)

>> GET /health/ HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 307 Temporary Redirect
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 0
<< location: http://127.0.0.1:8901/health
<< connection: close
<<
Case 6. 307 with Location header
CASE 7 · HTTP · :8901

GET /reset (wrong method -> 405)

>> GET /reset HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 405 Method Not Allowed
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< allow: POST
<< content-length: 31
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Method Not Allowed"}
Case 7. 405 with Allow: POST
CASE 8 · HTTP · :8901

GET /nope (unknown -> 404)

>> GET /nope HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 22
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Not Found"}
CASE 9 · HTTP · :8901

GET / (no web UI -> 404)

>> GET / HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 22
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Not Found"}
CASE 10 · HTTP · :8901

HEAD /health -> 405

>> HEAD /health HTTP/1.1
>> Host: h
>> Connection: close
>>
<< HTTP/1.1 405 Method Not Allowed
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< allow: GET
<< content-length: 31
<< content-type: application/json
<< connection: close
<<
CASE 11 · HTTP · :8901

OPTIONS /health -> 405

>> OPTIONS /health HTTP/1.1
>> Host: h
>> Connection: close
>>
<< HTTP/1.1 405 Method Not Allowed
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< allow: GET
<< content-length: 31
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Method Not Allowed"}
CASE 12 · HTTP · :8901

POST /reset {}

>> POST /reset HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 2
>>
>> {}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 104
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false,"metadata":null}
CASE 13 · HTTP · :8901

POST /reset {seed,episode_id}

>> POST /reset HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 33
>>
>> {"seed": 7, "episode_id": "ep-1"}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 104
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false,"metadata":null}
CASE 14 · HTTP · :8901

POST /reset (no body at all)

>> POST /reset HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 104
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false,"metadata":null}
Case 14. 200 - body is optional entirely
CASE 15 · HTTP · :8901

POST /reset wrong Content-Type

>> POST /reset HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/x-www-form-urlencoded
>> Content-Length: 2
>>
>> {}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 149
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"model_attributes_type","loc":["body"],"msg":"Input should be a valid dictionary or object to extract fields from","input":"{}"}]}
Case 15. 422 model_attributes_type
CASE 16 · HTTP · :8901

POST /reset absent Content-Type

>> POST /reset HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Length: 2
>>
>> {}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 149
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"model_attributes_type","loc":["body"],"msg":"Input should be a valid dictionary or object to extract fields from","input":"{}"}]}
Case 16. 422
CASE 17 · HTTP · :8901

POST /reset seed=-1

>> POST /reset HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 12
>>
>> {"seed": -1}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 141
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"greater_than_equal","loc":["body","seed"],"msg":"Input should be greater than or equal to 0","input":-1,"ctx":{"ge":0}}]}
Case 17. 422 greater_than_equal
CASE 18 · HTTP · :8901

POST /step ok

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 39
>>
>> {"action": {"amount": 2, "note": "hi"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 116
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{"steps":1},"total":2,"last_note":"hi"},"reward":2.0,"done":false,"metadata":{"steps":1}}
CASE 19 · HTTP · :8901

POST /step extra envelope key (forwarded as kwarg)

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 39
>>
>> {"action": {"amount": 2}, "foo": "bar"}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 114
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{"steps":1},"total":2,"last_note":""},"reward":2.0,"done":false,"metadata":{"steps":1}}
CASE 20 · HTTP · :8901

POST /step bad type

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 27
>>
>> {"action": {"amount": "x"}}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 197
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"int_parsing","loc":["amount"],"msg":"Input should be a valid integer, unable to parse string as an integer","input":"x","url":"https://errors.pydantic.dev/2.13/v/int_parsing"}]}
Case 20. 422 int_parsing, loc action-relative, HAS url
CASE 21 · HTTP · :8901

POST /step missing action

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 2
>>
>> {}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 89
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"missing","loc":["body","action"],"msg":"Field required","input":{}}]}
Case 21. 422 missing, loc=[body,action], NO url <-- the url discriminator
CASE 22 · HTTP · :8901

POST /step extra_forbidden

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 40
>>
>> {"action": {"amount": 1, "bogus": true}}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 166
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"extra_forbidden","loc":["bogus"],"msg":"Extra inputs are not permitted","input":true,"url":"https://errors.pydantic.dev/2.13/v/extra_forbidden"}]}
CASE 23 · HTTP · :8901

POST /step malformed JSON

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 9
>>
>> {not json
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 158
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"json_invalid","loc":["body",1],"msg":"JSON decode error","input":{},"ctx":{"error":"Expecting property name enclosed in double quotes"}}]}
Case 23. 422 json_invalid
CASE 24 · HTTP · :8901

POST /step timeout_s=0

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 41
>>
>> {"action": {"amount": 1}, "timeout_s": 0}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 129
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"greater_than","loc":["body","timeout_s"],"msg":"Input should be greater than 0","input":0,"ctx":{"gt":0.0}}]}
Case 24. 422 greater_than
CASE 25 · HTTP · :8901

POST /step lax coercion

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 28
>>
>> {"action": {"amount": "42"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 115
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{"steps":1},"total":42,"last_note":""},"reward":42.0,"done":true,"metadata":{"steps":1}}
Case 25. "42" accepted for an int field
CASE 26 · HTTP · :8901

task api: splits (501)

>> GET /CounterEnvironment/splits HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 53
<< content-type: application/json
<< connection: close
<<
<< {"detail":"unknown environment 'CounterEnvironment'"}
CASE 27 · HTTP · :8901

task api: splits case-insensitive

>> GET /counterenvironment/splits HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 53
<< content-type: application/json
<< connection: close
<<
<< {"detail":"unknown environment 'counterenvironment'"}
CASE 28 · HTTP · :8901

task api: unknown env (404)

>> GET /nope/splits HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 39
<< content-type: application/json
<< connection: close
<<
<< {"detail":"unknown environment 'nope'"}
CASE 29 · HTTP · :8901

task api: tasks (501)

>> POST /CounterEnvironment/tasks HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 18
>>
>> {"split": "train"}
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 53
<< content-type: application/json
<< connection: close
<<
<< {"detail":"unknown environment 'CounterEnvironment'"}
CASE 30 · HTTP · :8901

task api: missing split (422)

>> POST /CounterEnvironment/tasks HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 2
>>
>> {}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 88
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"missing","loc":["body","split"],"msg":"Field required","input":{}}]}
CASE 31 · HTTP · :8901

mcp: parse error (-32700)

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 7
>>
>> notjson
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 87
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":null,"error":{"code":-32700,"message":"Parse error","data":null}}
CASE 32 · HTTP · :8901

mcp: invalid request (-32600)

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 2
>>
>> {}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 436
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":null,"error":{"code":-32600,"message":"Invalid request: 2 validation errors for JsonRpcRequest\njsonrpc\n  Field required [type=missing, input_value={}, input_type=dict]\n    For further information visit https://errors.pydantic.dev/2.13/v/missing\nmethod\n  Field required [type=missing, input_value={}, input_type=dict]\n    For further information visit https://errors.pydantic.dev/2.13/v/missing","data":null}}
CASE 33 · HTTP · :8901

mcp: tools/list on non-MCP env (-32603)

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 51
>>
>> {"jsonrpc": "2.0", "method": "tools/list", "id": 1}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 105
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":1,"error":{"code":-32603,"message":"Environment does not support MCP","data":null}}
CASE 34 · HTTP · :8901

mcp: method not found (-32601)

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 48
>>
>> {"jsonrpc": "2.0", "method": "foo/bar", "id": 3}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 98
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":3,"error":{"code":-32601,"message":"Method not found: foo/bar","data":null}}
CASE 35 · HTTP · :8901

mcp: bad jsonrpc version (-32600, id null)

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 51
>>
>> {"jsonrpc": "1.0", "method": "tools/list", "id": 1}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 304
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":null,"error":{"code":-32600,"message":"Invalid request: 1 validation error for JsonRpcRequest\njsonrpc\n  Input should be '2.0' [type=literal_error, input_value='1.0', input_type=str]\n    For further information visit https://errors.pydantic.dev/2.13/v/literal_error","data":null}}
CASE 36 · HTTP · :8901

mcp: batch unsupported (-32700)

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 53
>>
>> [{"jsonrpc": "2.0", "method": "tools/list", "id": 1}]
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 87
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":null,"error":{"code":-32700,"message":"Parse error","data":null}}
CASE 37 · HTTP · :8901

mcp: notification still answered with id null

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 42
>>
>> {"jsonrpc": "2.0", "method": "tools/list"}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 108
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":null,"error":{"code":-32603,"message":"Environment does not support MCP","data":null}}
CASE 38 · HTTP · :8901

mcp: non-object params (-32600 not -32602)

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 66
>>
>> {"jsonrpc": "2.0", "method": "tools/list", "params": [1], "id": 1}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 307
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":null,"error":{"code":-32600,"message":"Invalid request: 1 validation error for JsonRpcRequest\nparams\n  Input should be a valid dictionary [type=dict_type, input_value=[1], input_type=list]\n    For further information visit https://errors.pydantic.dev/2.13/v/dict_type","data":null}}
CASE 39 · HTTP · :8901

mcp: GET -> 405

>> GET /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 405 Method Not Allowed
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< allow: POST
<< content-length: 31
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Method Not Allowed"}
CASE 40 · HTTP · :8902

mcp(echo): tools/list

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8902
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 51
>>
>> {"jsonrpc": "2.0", "method": "tools/list", "id": 1}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 909
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":1,"result":{"tools":[{"name":"echo_message","title":null,"description":"Echo back the provided message.","inputSchema":{"additionalProperties":false,"properties":{"message":{"type":"string","description":"The message to echo back"}},"required":["message"],"type":"object"},"outputSchema":{"properties":{"result":{"type":"string"}},"required":["result"],"type":"object","x-fastmcp-wrap-result":true},"icons":null,"annotations":null,"meta":{"fastmcp":{"tags":[]}},"execution":null},{"name":"echo_with_length","title":null,"description":"Echo back the message with its length.","inputSchema":{"additionalProperties":false,"properties":{"message":{"type":"string","description":"The message to echo back"}},"required":["message"],"type":"object"},"outputSchema":{"additionalProperties":true,"type":"object"},"icons":null,"annotations":null,"meta":{"fastmcp":{"tags":[]}},"execution":null}]}}
Case 40. camelCase inputSchema
CASE 41 · HTTP · :8902

mcp(echo): tools/call

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8902
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 123
>>
>> {"jsonrpc": "2.0", "method": "tools/call", "id": 2, "params": {"name": "echo_message", "arguments": {"message": "Hello!"}}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 224
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":2,"result":{"content":[{"type":"text","text":"Hello!","annotations":null,"meta":null}],"structured_content":{"result":"Hello!"},"meta":{"fastmcp":{"wrap_result":true}},"data":"Hello!","is_error":false}}
Case 41. snake_case structured_content / is_error
CASE 42 · HTTP · :8902

mcp(echo): session/create

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8902
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 63
>>
>> {"jsonrpc": "2.0", "method": "openenv/session/create", "id": 1}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 87
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":1,"result":{"session_id":"718358f1-7d14-4387-a306-6da10a6ab09f"}}
CASE 43 · HTTP · :8903

production: POST /reset -> 404

>> POST /reset HTTP/1.1
>> Host: 127.0.0.1:8903
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 2
>>
>> {}
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 22
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Not Found"}
CASE 44 · HTTP · :8903

production: POST /step -> 404

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8903
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 2
>>
>> {}
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 22
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Not Found"}
CASE 45 · HTTP · :8903

production: GET /state -> 404

>> GET /state HTTP/1.1
>> Host: 127.0.0.1:8903
>> Connection: close
>>
<< HTTP/1.1 404 Not Found
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 22
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Not Found"}
CASE 46 · HTTP · :8903

production: GET /health -> 200

>> GET /health HTTP/1.1
>> Host: 127.0.0.1:8903
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 20
<< content-type: application/json
<< connection: close
<<
<< {"status":"healthy"}
CASE 47 · HTTP · :8903

production: openapi (mode consistency)

>> GET /openapi.json HTTP/1.1
>> Host: 127.0.0.1:8903
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 9962
<< content-type: application/json
<< connection: close
<<
<< {"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"paths":{"/list_environments":{"get":{"tags":["Task API"],"summary":"List Environments","operationId":"list_environments_list_environments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response List Environments List Environments Get"}}}}}}},"/{env_name}/splits":{"get":{"tags":["Task API"],"summary":"List Splits","operationId":"list_splits__env_name__splits_get","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Splits  Env Name  Splits Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{env_name}/tasks":{"post":{"tags":["Task API"],"summary":"List Tasks","operationId":"list_tasks__env_name__tasks_post","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListTasksRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Tasks  Env Name  Tasks Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{env_name}/num_tasks":{"post":{"tags":["Task API"],"summary":"Num Tasks","operationId":"num_tasks__env_name__num_tasks_post","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumTasksRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Num Tasks  Env Name  Num Tasks Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{env_name}/task":{"post":{"tags":["Task API"],"summary":"Get Task","operationId":"get_task__env_name__task_post","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTaskRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Task  Env Name  Task Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{env_name}/task_range":{"post":{"tags":["Task API"],"summary":"Get Task Range","operationId":"get_task_range__env_name__task_range_post","parameters":[{"name":"env_name","in":"path","required":true,"schema":{"type":"string","title":"Env Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTaskRangeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Task Range  Env Name  Task Range Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/metadata":{"get":{"tags":["Environment Info"],"summary":"Get environment metadata","description":"Get metadata about this environment.\n\nReturns information about the environment including name, description,\nversion, author, and documentation links.","operationId":"endpoint_metadata_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvironmentMetadata"}}}}}}},"/health":{"get":{"tags":["Health"],"summary":"Health check","description":"Check if the environment server is running and healthy.","operationId":"endpoint_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/schema":{"get":{"tags":["Schema"],"summary":"Get all JSON schemas","description":"Get JSON schemas for actions, observations, and state in a single response.\n\nReturns a combined schema object containing:\n- **action**: JSON schema for actions accepted by this environment\n- **observation**: JSON schema for observations returned by this environment\n- **state**: JSON schema for environment state objects\n\nThis is more efficient than calling individual schema endpoints and provides\nall schema information needed to interact with the environment.","operationId":"get_schemas_schema_get","responses":{"200":{"description":"Combined schemas retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchemaResponse"},"example":{"action":{"type":"object","properties":{"message":{"type":"string"}}},"observation":{"type":"object","properties":{"response":{"type":"string"}}},"state":{"type":"object","properties":{"step_count":{"type":"integer"}}}}}}}}}},"/mcp":{"post":{"summary":"Mcp Endpoint","description":"MCP JSON-RPC endpoint for production mode.\n\nBypasses step() overhead and provides direct access to MCP tools.\nSupports tools/list and tools/call methods.","operationId":"mcp_endpoint_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mcp Endpoint Mcp Post"}}}}}}}},"components":{"schemas":{"EnvironmentMetadata":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the environment"},"description":{"type":"string","title":"Description","description":"Description of what the environment does"},"readme_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Readme Content","description":"Content of the README file for the environment"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","description":"Version of the environment"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"Author of the environment"},"documentation_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Documentation Url","description":"URL to the environment's documentation"}},"additionalProperties":false,"type":"object","required":["name","description"],"title":"EnvironmentMetadata","description":"Metadata about an environment for documentation and UI purposes."},"GetTaskRangeRequest":{"properties":{"split":{"type":"string","title":"Split","description":"Task split name"},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start","description":"Inclusive start index"},"stop":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stop","description":"Exclusive stop index"}},"additionalProperties":false,"type":"object","required":["split"],"title":"GetTaskRangeRequest","description":"Request model for ORS-compatible task range lookup."},"GetTaskRequest":{"properties":{"split":{"type":"string","title":"Split","description":"Task split name"},"index":{"type":"integer","title":"Index","description":"Task index within the split"}},"additionalProperties":false,"type":"object","required":["split","index"],"title":"GetTaskRequest","description":"Request model for ORS-compatible task lookup."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"$ref":"#/components/schemas/HealthStatus","description":"Health status of the environment server","default":"healthy"}},"additionalProperties":false,"type":"object","title":"HealthResponse","description":"Response model for health check endpoint."},"HealthStatus":{"type":"string","enum":["healthy","unhealthy","degraded"],"title":"HealthStatus","description":"Server health status values."},"ListTasksRequest":{"properties":{"split":{"type":"string","title":"Split","description":"Task split name"}},"additionalProperties":false,"type":"object","required":["split"],"title":"ListTasksRequest","description":"Request model for ORS-compatible task listing."},"NumTasksRequest":{"properties":{"split":{"type":"string","title":"Split","description":"Task split name"}},"additionalProperties":false,"type":"object","required":["split"],"title":"NumTasksRequest","description":"Request model for ORS-compatible task counts."},"SchemaResponse":{"properties":{"action":{"additionalProperties":true,"type":"object","title":"Action","description":"JSON schema for actions accepted by this environment"},"observation":{"additionalProperties":true,"type":"object","title":"Observation","description":"JSON schema for observations returned by this environment"},"state":{"additionalProperties":true,"type":"object","title":"State","description":"JSON schema for environment state objects"}},"additionalProperties":false,"type":"object","required":["action","observation","state"],"title":"SchemaResponse","description":"Response model for the combined schema endpoint."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
CASE 48 · HTTP · :8905

reward(null): HTTP coerces to float

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8905
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 28
>>
>> {"action": {"kind": "null"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 88
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"kind":"null"},"reward":null,"done":false,"metadata":null}
Case 48. compare with the ws case of the same name
CASE 49 · HTTP · :8905

reward(bool_true): HTTP coerces to float

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8905
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 33
>>
>> {"action": {"kind": "bool_true"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 92
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"kind":"bool_true"},"reward":1.0,"done":false,"metadata":null}
Case 49. compare with the ws case of the same name
CASE 50 · HTTP · :8905

reward(bool_false): HTTP coerces to float

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8905
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 34
>>
>> {"action": {"kind": "bool_false"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 93
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"kind":"bool_false"},"reward":0.0,"done":false,"metadata":null}
Case 50. compare with the ws case of the same name
CASE 51 · HTTP · :8905

reward(int): HTTP coerces to float

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8905
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 27
>>
>> {"action": {"kind": "int"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 86
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"kind":"int"},"reward":3.0,"done":false,"metadata":null}
Case 51. compare with the ws case of the same name
CASE 52 · HTTP · :8905

reward(int_zero): HTTP coerces to float

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8905
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 32
>>
>> {"action": {"kind": "int_zero"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 91
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"kind":"int_zero"},"reward":0.0,"done":false,"metadata":null}
Case 52. compare with the ws case of the same name
CASE 53 · HTTP · :8905

reward(float): HTTP coerces to float

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8905
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 29
>>
>> {"action": {"kind": "float"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 88
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"kind":"float"},"reward":1.5,"done":false,"metadata":null}
Case 53. compare with the ws case of the same name
CASE 54 · HTTP · :8905

reward(float_int): HTTP coerces to float

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8905
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 33
>>
>> {"action": {"kind": "float_int"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 92
<< content-type: application/json
<< connection: close
<<
<< {"observation":{"metadata":{},"kind":"float_int"},"reward":2.0,"done":false,"metadata":null}
Case 54. compare with the ws case of the same name
CASE 55 · WS · :8905 /ws

reward: WS passes bool/int/float through raw

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8905
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset", "data": {}}
<< {"type":"observation","data":{"observation":{"metadata":{},"kind":"reset"},"reward":null,"done":false}}
~ frame 2 · text
>> {"type": "step", "data": {"kind": "null"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"kind":"null"},"reward":null,"done":false}}
~ frame 3 · text
>> {"type": "step", "data": {"kind": "bool_true"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"kind":"bool_true"},"reward":true,"done":false}}
~ frame 4 · text
>> {"type": "step", "data": {"kind": "bool_false"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"kind":"bool_false"},"reward":false,"done":false}}
~ frame 5 · text
>> {"type": "step", "data": {"kind": "int"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"kind":"int"},"reward":3,"done":false}}
~ frame 6 · text
>> {"type": "step", "data": {"kind": "int_zero"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"kind":"int_zero"},"reward":0,"done":false}}
~ frame 7 · text
>> {"type": "step", "data": {"kind": "float"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"kind":"float"},"reward":1.5,"done":false}}
~ frame 8 · text
>> {"type": "step", "data": {"kind": "float_int"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"kind":"float_int"},"reward":2.0,"done":false}}
Case 55. true stays true, 3 stays 3 - HTTP would say 1.0 and 3.0
CASE 56 · WS · :8901 /ws

ws: happy path + close

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset", "data": {}}
<< {"type":"observation","data":{"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false}}
~ frame 2 · text
>> {"type": "step", "data": {"amount": 1, "note": "a"}}
<< {"type":"observation","data":{"observation":{"metadata":{"steps":1},"total":1,"last_note":"a"},"reward":1.0,"done":false,"metadata":{"steps":1}}}
~ frame 3 · text
>> {"type": "step", "data": {"amount": 5, "note": "b"}}
<< {"type":"observation","data":{"observation":{"metadata":{"steps":2},"total":6,"last_note":"b"},"reward":6.0,"done":true,"metadata":{"steps":2}}}
~ frame 4 · text
>> {"type": "state"}
<< {"type":"state","data":{"episode_id":"ep-fixed","step_count":2,"total":6}}
~ frame 5 · close
>> {"type": "close"}
<< �
Case 56. STATEFUL: total accumulates 1 then 6
CASE 57 · WS · :8901 /ws

ws: reset with params

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset", "data": {"seed": 7, "episode_id": "ep-1"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false}}
CASE 58 · WS · :8901 /ws

ws: reset with data omitted (legal)

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset"}
<< {"type":"observation","data":{"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false}}
CASE 59 · WS · :8901 /ws

ws: step before reset (LEGAL - no episode state machine)

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "step", "data": {"amount": 1}}
<< {"type":"observation","data":{"observation":{"metadata":{"steps":1},"total":1,"last_note":""},"reward":1.0,"done":false,"metadata":{"steps":1}}}
CASE 60 · WS · :8901 /ws

ws: reset seed=-1 (accepted! HTTP 422s the same value)

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset", "data": {"seed": -1}}
<< {"type":"observation","data":{"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false}}
CASE 61 · WS · :8901 /ws

ws: reset unvalidated params

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset", "data": {"seed": "abc"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false}}
CASE 62 · WS · :8901 /ws

ws err: INVALID_JSON

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {not json
<< {"type":"error","data":{"message":"Invalid JSON: Expecting property name enclosed in double quotes: line 1 column 2 (char 1)","code":"INVALID_JSON"}}
CASE 63 · WS · :8901 /ws

ws err: UNKNOWN_TYPE

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "bogus"}
<< {"type":"error","data":{"message":"Unknown message type: bogus","code":"UNKNOWN_TYPE"}}
CASE 64 · WS · :8901 /ws

ws err: missing type -> UNKNOWN_TYPE ''

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {}
<< {"type":"error","data":{"message":"Unknown message type: ","code":"UNKNOWN_TYPE"}}
CASE 65 · WS · :8901 /ws

ws err: step without data (loc=[data], HAS url)

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "step"}
<< {"type":"error","data":{"message":"Invalid message","code":"VALIDATION_ERROR","errors":[{"type":"missing","loc":["data"],"msg":"Field required","input":{"type":"step"},"url":"https://errors.pydantic.dev/2.13/v/missing"}]}}
CASE 66 · WS · :8901 /ws

ws err: VALIDATION_ERROR int_parsing

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "step", "data": {"amount": "nope"}}
<< {"type":"error","data":{"message":"Invalid message","code":"VALIDATION_ERROR","errors":[{"type":"int_parsing","loc":["amount"],"msg":"Input should be a valid integer, unable to parse string as an integer","input":"nope","url":"https://errors.pydantic.dev/2.13/v/int_parsing"}]}}
CASE 67 · WS · :8901 /ws

ws err: extra_forbidden

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "step", "data": {"nope": 1}}
<< {"type":"error","data":{"message":"Invalid message","code":"VALIDATION_ERROR","errors":[{"type":"extra_forbidden","loc":["nope"],"msg":"Extra inputs are not permitted","input":1,"url":"https://errors.pydantic.dev/2.13/v/extra_forbidden"}]}}
CASE 68 · WS · :8901 /ws

ws err: state with data is ILLEGAL

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "state", "data": {}}
<< {"type":"error","data":{"message":"Invalid message","code":"VALIDATION_ERROR","errors":[{"type":"extra_forbidden","loc":["data"],"msg":"Extra inputs are not permitted","input":{},"url":"https://errors.pydantic.dev/2.13/v/extra_forbidden"}]}}
CASE 69 · WS · :8901 /ws

ws err: close with data is ILLEGAL and does NOT close

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "close", "data": {}}
<< {"type":"error","data":{"message":"Invalid message","code":"VALIDATION_ERROR","errors":[{"type":"extra_forbidden","loc":["data"],"msg":"Extra inputs are not permitted","input":{},"url":"https://errors.pydantic.dev/2.13/v/extra_forbidden"}]}}
CASE 70 · WS · :8901 /ws

ws err: extra envelope key

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "step", "data": {"amount": 1}, "id": 7}
<< {"type":"error","data":{"message":"Invalid message","code":"VALIDATION_ERROR","errors":[{"type":"extra_forbidden","loc":["id"],"msg":"Extra inputs are not permitted","input":7,"url":"https://errors.pydantic.dev/2.13/v/extra_forbidden"}]}}
CASE 71 · WS · :8901 /ws

ws err: HTTP-style action wrapping is wrong on WS

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "step", "data": {"action": {"amount": 1}}}
<< {"type":"error","data":{"message":"Invalid message","code":"VALIDATION_ERROR","errors":[{"type":"extra_forbidden","loc":["action"],"msg":"Extra inputs are not permitted","input":{"amount":1},"url":"https://errors.pydantic.dev/2.13/v/extra_forbidden"}]}}
CASE 72 · WS · :8901 /ws

ws FATAL: non-object payload -> SESSION_ERROR + disconnect

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> 5
<< {"type":"error","data":{"message":"'int' object has no attribute 'get'","code":"SESSION_ERROR"}}
CASE 73 · WS · :8901 /ws

ws: raw UTF-8 on the wire (no \u escaping)

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset", "data": {}}
<< {"type":"observation","data":{"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false}}
~ frame 2 · text
>> {"type": "step", "data": {"amount": 0, "note": "h\u00e9llo\ud83c\udf89"}}
<< {"type":"observation","data":{"observation":{"metadata":{"steps":1},"total":0,"last_note":"héllo🎉"},"reward":0.0,"done":false,"metadata":{"steps":1}}}
CASE 74 · WS · :8902 /ws

ws(echo): MCP as ordinary actions

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8902
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset", "data": {}}
<< {"type":"observation","data":{"observation":{"metadata":{"status":"ready","message":"Echo environment ready!"}},"reward":0.0,"done":false,"metadata":{"status":"ready","message":"Echo environment ready!"}}}
~ frame 2 · text
>> {"type": "step", "data": {"type": "list_tools"}}
<< {"type":"observation","data":{"observation":{"metadata":{},"tools":[{"name":"echo_message","description":"Echo back the provided message.","input_schema":{"additionalProperties":false,"properties":{"message":{"type":"string","description":"The message to echo back"}},"required":["message"],"type":"object"}},{"name":"echo_with_length","description":"Echo back the message with its length.","input_schema":{"additionalProperties":false,"properties":{"message":{"type":"string","description":"The message to echo back"}},"required":["message"],"type":"object"}}]},"reward":null,"done":false}}
~ frame 3 · text
>> {"type": "step", "data": {"type": "call_tool", "tool_name": "echo_message", "arguments": {"message": "Hi!"}}}
<< {"type":"observation","data":{"observation":{"metadata":{},"tool_name":"echo_message","result":{"content":[{"type":"text","text":"Hi!","annotations":null,"meta":null}],"structured_content":{"result":"Hi!"},"meta":{"fastmcp":{"wrap_result":true}},"data":"Hi!","is_error":false},"error":null},"reward":null,"done":false}}
~ frame 4 · text
>> {"type": "step", "data": {"type": "call_tool", "tool_name": "nope", "arguments": {}}}
<< {"type":"observation","data":{"observation":{"metadata":{},"tool_name":"nope","result":null,"error":{"error_type":"tool_not_found","message":"Unknown tool: 'nope'"}},"reward":null,"done":false}}
Case 74. snake_case input_schema here
CASE 75 · WS · :8901 /ws

ws: mcp envelope on /ws

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "mcp", "data": {"jsonrpc": "2.0", "method": "tools/list", "id": 1}}
<< {"type":"mcp","data":{"jsonrpc":"2.0","id":1,"error":{"code":-32603,"message":"Environment does not support MCP","data":null}}}
CASE 76 · WS · :8901 /mcp

ws /mcp: bare JSON-RPC, NOTE spaces after : and ,

>> GET /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"jsonrpc": "2.0", "method": "tools/list", "id": 1}
<< {"jsonrpc": "2.0", "id": 1, "error": {"code": -32603, "message": "Environment does not support MCP", "data": null}}
CASE 77 · WS · :8901 /mcp

ws /mcp: parse error

>> GET /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> notjson
<< {"jsonrpc": "2.0", "id": null, "error": {"code": -32700, "message": "Parse error: Expecting value: line 1 column 1 (char 0)", "data": null}}
CASE 78 · WS · :8903 /ws

production: WS reset still works (HTTP /reset is 404)

>> GET /ws HTTP/1.1
>> Host: 127.0.0.1:8903
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"type": "reset", "data": {}}
<< {"type":"observation","data":{"observation":{"metadata":{},"total":0,"last_note":"reset"},"reward":null,"done":false}}
CASE 79 · WS · :8902 /mcp

ws /mcp(echo): tools/list - the first spaced NESTED document

>> GET /mcp HTTP/1.1
>> Host: 127.0.0.1:8902
>> Upgrade: websocket
>> Connection: Upgrade
>> Sec-WebSocket-Key: MDEyMzQ1Njc4OWFiY2RlZg==
>> Sec-WebSocket-Version: 13
>>
<< HTTP/1.1 101 Switching Protocols
<< Date: Tue, 28 Jul 2026 09:45:38 GMT
<< Upgrade: websocket
<< Connection: Upgrade
<< Sec-WebSocket-Accept: BACScCJPNqyz+UBoqMH89VmURoA=
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
~ frame 1 · text
>> {"jsonrpc": "2.0", "method": "tools/list", "id": 1}
<< {"jsonrpc": "2.0", "id": 1, "result": {"tools": [{"name": "echo_message", "title": null, "description": "Echo back the provided message.", "inputSchema": {"additionalProperties": false, "properties": {"message": {"type": "string", "description": "The message to echo back"}}, "required": ["message"], "type": "object"}, "outputSchema": {"properties": {"result": {"type": "string"}}, "required": ["result"], "type": "object", "x-fastmcp-wrap-result": true}, "icons": null, "annotations": null, "meta": {"fastmcp": {"tags": []}}, "execution": null}, {"name": "echo_with_length", "title": null, "description": "Echo back the message with its length.", "inputSchema": {"additionalProperties": false, "properties": {"message": {"type": "string", "description": "The message to echo back"}}, "required": ["message"], "type": "object"}, "outputSchema": {"additionalProperties": true, "type": "object"}, "icons": null, "annotations": null, "meta": {"fastmcp": {"tags": []}}, "execution": null}]}}
Case 79. spaces after ':' and ',' at EVERY depth, four levels down to a property's `"type": "string"`. Contrast the flat error object captured from the same door on 8901. THE SHAPE HERE IS NOT OURS - 8902 is branch 2, so this is the nine-key FastMCP dump again, exactly as case 40. What this case pins is the SPACING; case 80 pins the shape
CASE 80 · HTTP · :8906

mcp(srvonly): tools/list - branch 3, camelCase, THREE keys

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8906
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 51
>>
>> {"jsonrpc": "2.0", "method": "tools/list", "id": 1}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 303
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":1,"result":{"tools":[{"name":"bump","description":"Double the amount.","inputSchema":{"additionalProperties":false,"properties":{"amount":{"type":"integer","description":"How much","default":1,"title":"Amount"}},"type":"object"}},{"name":"cat","description":"","inputSchema":{}}]}}
Case 80. http_server.py:945-958. No FastMCP object in the process: inputSchema is tool.parameters verbatim, including the non-ASCII key order and the title key we wrote. 'cat' shows description->"" and inputSchema->{} (WART-28)
CASE 81 · HTTP · :8906

mcp(srvonly): tools/call - the BARE return value

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8906
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 108
>>
>> {"jsonrpc": "2.0", "method": "tools/call", "id": 2, "params": {"name": "bump", "arguments": {"amount": 21}}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 36
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":2,"result":42}
Case 81. http_server.py:1034-1039. `"result":42` is a whole JSON-RPC answer: no content array, no structuredContent, no isError. Compare case 41, where FastMCP's CallToolResult dataclass supplies five keys instead
CASE 82 · HTTP · :8906

mcp(srvonly): tools/call unknown tool -> -32602

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8906
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 96
>>
>> {"jsonrpc": "2.0", "method": "tools/call", "id": 3, "params": {"name": "nope", "arguments": {}}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 93
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":3,"error":{"code":-32602,"message":"Tool not found: nope","data":null}}
Case 82. http_server.py:1020-1025, `Tool not found: nope`, unquoted and -32602. Branch 2 answers -32603 `Unknown tool: 'nope'` for the same input - two branches of ONE dispatcher disagreeing on both the code and the message. We take this one, because we emit this branch's tool shape (MCP-STORY.md §2.5)
CASE 83 · HTTP · :8902

mcp(echo): tools/call with EMPTY params -> -32602

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8902
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 65
>>
>> {"jsonrpc": "2.0", "method": "tools/call", "id": 2, "params": {}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 97
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":2,"error":{"code":-32602,"message":"Missing 'name' in params","data":null}}
Case 83. `Missing 'name' in params`, decided by the dispatcher above the has-tools test. Identical on both ports - a tool table changes nothing here
CASE 84 · HTTP · :8901

mcp(counter): tools/call with EMPTY params -> -32602

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 65
>>
>> {"jsonrpc": "2.0", "method": "tools/call", "id": 2, "params": {}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 97
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":2,"error":{"code":-32602,"message":"Missing 'name' in params","data":null}}
Case 84. `Missing 'name' in params`, decided by the dispatcher above the has-tools test. Identical on both ports - a tool table changes nothing here
CASE 85 · HTTP · :8902

mcp(echo): tools/call unknown tool -> -32603 (branch 2)

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8902
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 76
>>
>> {"jsonrpc": "2.0", "method": "tools/call", "id": 3, "params": {"name": "x"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 90
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":3,"error":{"code":-32603,"message":"Unknown tool: 'x'","data":null}}
Case 85. `Unknown tool: 'x'` - FastMCP's f"...{name!r}", so the name is Python-repr quoted. Contrast the srvonly case above: same question, different branch, different code AND different message
CASE 86 · HTTP · :8901

mcp(counter): tools/call named tool, no tool surface -> -32603

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 76
>>
>> {"jsonrpc": "2.0", "method": "tools/call", "id": 3, "params": {"name": "x"}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 105
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":3,"error":{"code":-32603,"message":"Environment does not support MCP","data":null}}
Case 86. `Environment does not support MCP` - the canned answer, reached only once params.name is present. This is the ONE row the refusal cited, and it is the row that is right; the case above it is the row that was wrong
CASE 87 · HTTP · :8902

GET /schema (echo, branch 2) - the action model HAS the tool fields

>> GET /schema HTTP/1.1
>> Host: 127.0.0.1:8902
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 3061
<< content-type: application/json
<< connection: close
<<
<< {"action":{"additionalProperties":false,"description":"Call a specific tool via MCP.\n\nThis action triggers MCP's tools/call operation with the\nspecified tool name and arguments.","properties":{"metadata":{"additionalProperties":true,"description":"Additional metadata for the action","title":"Metadata","type":"object"},"type":{"const":"call_tool","default":"call_tool","description":"Action type discriminator","title":"Type","type":"string"},"tool_name":{"description":"Name of the tool to call","title":"Tool Name","type":"string"},"arguments":{"additionalProperties":true,"description":"Arguments to pass to the tool","title":"Arguments","type":"object"}},"required":["tool_name"],"title":"CallToolAction","type":"object"},"observation":{"$defs":{"ToolError":{"additionalProperties":false,"description":"Structured error for tool execution failures.\n\nThis is used for transport/framework errors, NOT for errors returned\nby the tool itself (those go in the result field).","properties":{"error_type":{"$ref":"#/$defs/ToolErrorType","description":"Category of the error"},"message":{"description":"Human-readable error message","title":"Message","type":"string"}},"required":["error_type","message"],"title":"ToolError","type":"object"},"ToolErrorType":{"description":"Types of errors that can occur during tool execution.","enum":["execution_error","invalid_args","transport_error","tool_not_found","timeout"],"title":"ToolErrorType","type":"string"}},"additionalProperties":false,"description":"Response from tool execution.\n\nContains the tool's result or an error if the call failed.\nTool-specific errors (from the tool itself) are included in the result.\nTransport/framework errors use the error field.","properties":{"done":{"default":false,"description":"Whether the episode has terminated","title":"Done","type":"boolean"},"reward":{"anyOf":[{"type":"boolean"},{"type":"integer"},{"type":"number"},{"type":"null"}],"default":null,"description":"Reward signal from the last action","title":"Reward"},"metadata":{"additionalProperties":true,"description":"Additional metadata for the observation","title":"Metadata","type":"object"},"tool_name":{"description":"Name of the tool that was called","title":"Tool Name","type":"string"},"result":{"default":null,"description":"Tool-specific result (may include tool errors)","title":"Result"},"error":{"anyOf":[{"$ref":"#/$defs/ToolError"},{"type":"null"}],"default":null,"description":"Transport/framework error if call failed"}},"required":["tool_name"],"title":"CallToolObservation","type":"object"},"state":{"additionalProperties":true,"description":"Base class for environment state.\n\nRepresents internal environment state, separate from observations.","properties":{"episode_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Unique identifier for the current episode","title":"Episode Id"},"step_count":{"default":0,"description":"Number of steps taken in the current episode","minimum":0,"title":"Step Count","type":"integer"}},"title":"State","type":"object"}}
Case 87. 3061 bytes; action.title is CallToolAction and its properties are metadata/type/tool_name/arguments. Ours reproduces this document byte for byte - envs/echo_tools.c hands over the captured CallToolAction/CallToolObservation (item 7) - so GET /schema REPLAYS. Divergence 8's behaviour half, the step door accepting an extra key this schema forbids, remains
CASE 88 · HTTP · :8906

GET /schema (srvonly, branch 3) - tools on /mcp, none on /step

>> GET /schema HTTP/1.1
>> Host: 127.0.0.1:8906
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 1352
<< content-type: application/json
<< connection: close
<<
<< {"action":{"additionalProperties":false,"properties":{"metadata":{"additionalProperties":true,"description":"Additional metadata for the action","title":"Metadata","type":"object"},"amount":{"default":1,"title":"Amount","type":"integer"}},"title":"SrvOnlyAction","type":"object"},"observation":{"additionalProperties":false,"properties":{"done":{"default":false,"description":"Whether the episode has terminated","title":"Done","type":"boolean"},"reward":{"anyOf":[{"type":"boolean"},{"type":"integer"},{"type":"number"},{"type":"null"}],"default":null,"description":"Reward signal from the last action","title":"Reward"},"metadata":{"additionalProperties":true,"description":"Additional metadata for the observation","title":"Metadata","type":"object"},"total":{"default":0,"title":"Total","type":"integer"}},"title":"SrvOnlyObservation","type":"object"},"state":{"additionalProperties":true,"description":"Base class for environment state.\n\nRepresents internal environment state, separate from observations.","properties":{"episode_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Unique identifier for the current episode","title":"Episode Id"},"step_count":{"default":0,"description":"Number of steps taken in the current episode","minimum":0,"title":"Step Count","type":"integer"}},"title":"State","type":"object"}}
Case 88. 1352 bytes; action.title is SrvOnlyAction, properties metadata/amount. This environment publishes two tools on /mcp and REFUSES {"type":"list_tools"} on /step with 422 extra_forbidden on `type`. Schema and behaviour agree here; on ours they do not
CASE 89 · HTTP · :8902

step(echo): list_tools with an EXTRA key -> 422

>> POST /step HTTP/1.1
>> Host: 127.0.0.1:8902
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 46
>>
>> {"action": {"type": "list_tools", "extra": 1}}
<< HTTP/1.1 422 Unprocessable Content
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 163
<< content-type: application/json
<< connection: close
<<
<< {"detail":[{"type":"extra_forbidden","loc":["extra"],"msg":"Extra inputs are not permitted","input":1,"url":"https://errors.pydantic.dev/2.13/v/extra_forbidden"}]}
Case 89. The other half of the case above. 8902 accepts {"type":"list_tools"} and refuses this, because its action model is a real pydantic class with extra='forbid'. We answer 200 and the full tool table, because our tool sniff runs ahead of the validator - divergence 8
CASE 90 · HTTP · :8906

mcp(srvonly): an argument the tool does not declare -> -32603

>> POST /mcp HTTP/1.1
>> Host: 127.0.0.1:8906
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 105
>>
>> {"jsonrpc": "2.0", "method": "tools/call", "id": 4, "params": {"name": "bump", "arguments": {"nope": 1}}}
<< HTTP/1.1 200 OK
<< date: Tue, 28 Jul 2026 09:45:37 GMT
<< server: uvicorn
<< content-length: 122
<< content-type: application/json
<< connection: close
<<
<< {"jsonrpc":"2.0","id":4,"error":{"code":-32603,"message":"_bump() got an unexpected keyword argument 'nope'","data":null}}
Case 90. `_bump() got an unexpected keyword argument 'nope'` - CPython's calling convention, not a validator, and not the schema. We answer {"result":2}: nothing here inspects `arguments` at all. GAP-21's evidence
CASE 91 · HTTP · :8901

task api: splits 501 (no provider)

>> GET /counter_env/splits HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>>
<< HTTP/1.1 501 Not Implemented
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 62
<< content-type: application/json
<< connection: close
<<
<< {"detail":"list_splits is not supported for this environment"}
Case 91. The 501 GAP-20 said was uncaptured. `list_splits` names the Environment method the getattr looked for; our chosen spelling matches this byte for byte.
CASE 92 · HTTP · :8901

task api: tasks 501 (no provider)

>> POST /counter_env/tasks HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 18
>>
>> {"split": "train"}
<< HTTP/1.1 501 Not Implemented
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 61
<< content-type: application/json
<< connection: close
<<
<< {"detail":"list_tasks is not supported for this environment"}
CASE 93 · HTTP · :8901

task api: num_tasks 501 (no provider)

>> POST /counter_env/num_tasks HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 18
>>
>> {"split": "train"}
<< HTTP/1.1 501 Not Implemented
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 60
<< content-type: application/json
<< connection: close
<<
<< {"detail":"num_tasks is not supported for this environment"}
CASE 94 · HTTP · :8901

task api: task 501 (no provider)

>> POST /counter_env/task HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 30
>>
>> {"split": "train", "index": 0}
<< HTTP/1.1 501 Not Implemented
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 59
<< content-type: application/json
<< connection: close
<<
<< {"detail":"get_task is not supported for this environment"}
CASE 95 · HTTP · :8901

task api: task_range 501 (no provider)

>> POST /counter_env/task_range HTTP/1.1
>> Host: 127.0.0.1:8901
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 18
>>
>> {"split": "train"}
<< HTTP/1.1 501 Not Implemented
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 65
<< content-type: application/json
<< connection: close
<<
<< {"detail":"get_task_range is not supported for this environment"}
CASE 96 · HTTP · :8907

task api(provider): list_environments

>> GET /list_environments HTTP/1.1
>> Host: 127.0.0.1:8907
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 12
<< content-type: application/json
<< connection: close
<<
<< ["task_env"]
Case 96. REPLAYS: list_environments needs no provider, so our env answers ["task_env"] identically. The one task route that is not a 501 without a provider.
CASE 97 · HTTP · :8907

task api(provider): splits - the _normalize_split wart

>> GET /task_env/splits HTTP/1.1
>> Host: 127.0.0.1:8907
>> Connection: close
>>
<< HTTP/1.1 200 OK
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 102
<< content-type: application/json
<< connection: close
<<
<< [{"name":"train","type":"train"},{"name":"test","type":"test"},{"name":"holdout","type":"validation"}]
Case 97. The SERVER wraps each bare split string as {name,type}; a name not in {train,validation,test} is silently typed validation, so `holdout` comes back type:validation. http_server.py:1070-1080.
CASE 98 · HTTP · :8907

task api(provider): tasks

>> POST /task_env/tasks HTTP/1.1
>> Host: 127.0.0.1:8907
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 18
>>
>> {"split": "train"}
<< HTTP/1.1 200 OK
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 150
<< content-type: application/json
<< connection: close
<<
<< {"tasks":[{"id":0,"prompt":"1 + 1","answer":"2"},{"id":1,"prompt":"2 + 2","answer":"4"},{"id":2,"prompt":"3 + 3","answer":"6"}],"env_name":"task_env"}
Case 98. {tasks:[...],env_name:...} — the only task route that echoes env_name back beside its payload.
CASE 99 · HTTP · :8907

task api(provider): num_tasks

>> POST /task_env/num_tasks HTTP/1.1
>> Host: 127.0.0.1:8907
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 18
>>
>> {"split": "train"}
<< HTTP/1.1 200 OK
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 15
<< content-type: application/json
<< connection: close
<<
<< {"num_tasks":3}
Case 99. {num_tasks:N}
CASE 100 · HTTP · :8907

task api(provider): task

>> POST /task_env/task HTTP/1.1
>> Host: 127.0.0.1:8907
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 30
>>
>> {"split": "train", "index": 1}
<< HTTP/1.1 200 OK
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 47
<< content-type: application/json
<< connection: close
<<
<< {"task":{"id":1,"prompt":"2 + 2","answer":"4"}}
Case 100. {task:{...}}
CASE 101 · HTTP · :8907

task api(provider): task_range

>> POST /task_env/task_range HTTP/1.1
>> Host: 127.0.0.1:8907
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 41
>>
>> {"split": "train", "start": 1, "stop": 3}
<< HTTP/1.1 200 OK
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 89
<< content-type: application/json
<< connection: close
<<
<< {"tasks":[{"id":1,"prompt":"2 + 2","answer":"4"},{"id":2,"prompt":"3 + 3","answer":"6"}]}
Case 101. {tasks:[...]} — Python slice semantics, no env_name.
CASE 102 · HTTP · :8907

task api(provider): task out-of-range -> 400

>> POST /task_env/task HTTP/1.1
>> Host: 127.0.0.1:8907
>> Connection: close
>> Content-Type: application/json
>> Content-Length: 31
>>
>> {"split": "train", "index": 99}
<< HTTP/1.1 400 Bad Request
<< date: Wed, 29 Jul 2026 14:39:37 GMT
<< server: uvicorn
<< content-length: 31
<< content-type: application/json
<< connection: close
<<
<< {"detail":"Invalid task index"}
Case 102. The undocumented 400. get_task raises IndexError, which _call_task_method turns into {"detail":"Invalid task index"}. Unreachable without a provider — the 501 wins first.