Files
engine/docs/OPENRESPONSES.md
Eric BuehlerandGitHub e9f5d3c943 feat(core): code execution, file outputs and /v1/files, strict tool calling, new docs and ui (#2130)
* Add code exec

* Fixes

* Fixes

* Fixes

* Fixes

* Tweak and fix

* Tweak and fix

* Tweak and fix

* Tweak and fix

* Nicer ux

* Nicer ux

* Nicer ux

* Docs

* Docs

* Docs

* nName

* ux in cli

* Server rework

* Fixes

* Fixes

* Fixes

* Fixes

* Fixes

* Fixes

* Fixes

* Fixes

* Fixes

* Session id

* Session id

* Fixes

* Fixes

* Fixes

* Add agentic session

* Add agentic session

* Clarify if supports vision

* Add video support

* Add ui support

* Salt cache

* Salt cache

* Download

* Finish reason

* Video rendering

* Tweak

* Tweak

* Order

* Agentic session serde

* Agentic session ui

* Cleanup

* Cleanup

* Docs

* Docs

* Docs

* Tweaks to lang

* Rpogress

* Cleaner

* Docs

* Env var

* Nit

* Nit

* Better python docs

* Nit

* Nit

* Nit

* Support python

* Improve?

* STart here page

* Docs

* Files: typed outputs from code execution

Code execution now produces first-class File objects (text, image, video,
binary) with stable ids and OpenAI-compatible Files endpoints. The model
declares outputs in the execute_python tool args; the runtime reads them,
applies inline/preview/fetch policy by size, and surfaces them to the app
without inflating the transcript.

The model gets read_file / list_files tools for working with large or
prior-turn files. Request-level `files: [...]` is a contract — required
files surface even if the model forgets to declare them.

This separates the model's context budget from the app's output channel,
which previously shared one bloated path through assistant text.

* Add support for files/typeed outputs

* Fix concurrency

* Fix

* Refactor

* Codequa;

* Codequal

* Fix

* Fixes

* Cleaner design for injection

* Cleaner design for injection

* Add copy and line count

* Add copy and line count

* Update ui

* Update ui

* Coppy button

* Coppy button

* Coppy button

* Allow forking sessions

* Allow forking sessions

* Prep website

* Prep website

* Fix

* Fix

* Fix

* Fix

* Fix

* Fix

* Fix

* Fix

* Fix

* Fix

* Fix

* Fix

* Fix

* Tweak

* Tweak

* Tweak

* Fix

* Improvements

* Improvements

* Improvements

* Fix downloading

* Readme

* Readme

* Format

* Fix

* CUDA pin to 13.0 in CI

* Fix docs
2026-05-15 21:34:33 -04:00

1.1 KiB

OpenResponses API

Hanzo Engine supports the OpenResponses API specification.

Endpoints

  • POST /v1/responses - Create a response
  • GET /v1/responses/{id} - Retrieve a response
  • DELETE /v1/responses/{id} - Delete a response
  • POST /v1/responses/{id}/cancel - Cancel a background response

Unsupported Parameters

The following parameters are accepted for API compatibility but will return errors if set to non-default values:

Parameter Behavior
parallel_tool_calls Only true or omitted is supported; false returns an error
max_tool_calls Not supported; setting any value returns an error

Hanzo Engine Extensions

These additional parameters are available beyond the spec:

  • stop - Stop sequences
  • repetition_penalty - Token repetition penalty
  • top_k - Top-k sampling
  • grammar - Constrained generation grammar
  • min_p - Min-p sampling
  • dry_multiplier, dry_base, dry_allowed_length, dry_sequence_breakers - DRY sampling
  • web_search_options - Web search integration

See HTTP.md for usage examples.