Tool schema by surface
The tool schema is re-sent on every step of every turn. This is what each surface sends, assembled by the functions the surface itself calls (see chimera/prompts/tool_schemas.py), under default settings, with no credential, no MCP server and an empty workspace. tests/prompt_snapshots/schema.<surface>.txt keeps the exact text, so a change to a tool description or parameter shows up as a diff.
Tokens here are characters divided by four. That is an estimate, not a tokenizer. The characters are the compact JSON of the schema as sent.
What each surface sends
| Surface | Deferral applied | Tools (default) | Chars (default) | Tokens est. (default) | Tools (defer_tools=False) |
Chars (defer_tools=False) |
Tokens est. (defer_tools=False) |
|---|---|---|---|---|---|---|---|
| Code turn with a screen (desktop, with question and task cards) | yes | 17 | 12,508 | ~3,127 | 28 | 21,189 | ~5,297 |
| Code turn that offers the design tool | yes | 18 | 17,671 | ~4,418 | 29 | 26,352 | ~6,588 |
chimera run (chat, assist and solve share its deferral) |
yes | 15 | 9,826 | ~2,456 | 26 | 18,507 | ~4,627 |
| scheduled job | no | 26 | 18,507 | ~4,627 | 26 | 18,507 | ~4,627 |
| messaging bot (Discord, Telegram) | no | 27 | 19,071 | ~4,768 | 27 | 19,071 | ~4,768 |
What deferral takes out, by describe_saving
chimera.tools.defer.describe_saving run on each surface's registry with defer_tools=False: what deferral would move behind tool_list / tool_describe / tool_call, in schema characters (per-tool JSON, so a few characters under the table above). On the surfaces where deferral is not applied the figure is what it would save, not what is saved.
| Surface | Declared | Core, never deferred | Deferred | Chars before | Chars after (core + 3 proxies) | Saving |
|---|---|---|---|---|---|---|
| Code turn with a screen (desktop, with question and task cards) | 28 | 14 | 14 | 21,133 | 12,474 | 41.0% |
| Code turn that offers the design tool | 29 | 15 | 14 | 26,294 | 17,635 | 32.9% |
chimera run (chat, assist and solve share its deferral) |
26 | 12 | 14 | 18,455 | 9,796 | 46.9% |
| scheduled job | 26 | 12 | 14 | 18,455 | 9,796 | 46.9% |
| messaging bot (Discord, Telegram) | 27 | 12 | 15 | 19,017 | 9,796 | 48.5% |
Not measured
- server chat: built inside
_chat_session, a closure of theservecommand (chimera/cli/commands/serve.py), which also mounts MCP connectors, OpenAPI connectors and a live pool; there is no callable assembler to run hermetically.
Conditions
- Default
Settings, an empty temporary home and workspace, noCHIMERA_*variable and no credential in the environment. - Optional packages are pinned, not read from the machine:
playwrightpresent (a core dependency, so the browser is registered),diffusersandfaster_whisperabsent. - Tools gated by a key (search, e-mail, image, speech) are absent, because no key is set.
- The Code turn's posture removes the execution tools that the default reach does not grant, which is why its schema is smaller than the CLI's.