explorer.md

 1# Explorer
 2
 3Threads Explorer is a single self-contained HTML file that gives an overview of
 4evaluation runs, while allowing for some interactivity.
 5
 6When you open a file, it gives you a _thread overview_, which looks like this:
 7
 8| Turn | Text                                 | Tool                                         | Result                                        |
 9| ---- | ------------------------------------ | -------------------------------------------- | --------------------------------------------- |
10| 1    | [User]:                              |                                              |                                               |
11|      | Fix the bug: kwargs not passed...    |                                              |                                               |
12| 2    | I'll help you fix that bug.          | **list_directory**(path="fastmcp")           | `fastmcp/src [...]`                           |
13|      |                                      |                                              |                                               |
14| 3    | Let's examine the code.              | **read_file**(path="fastmcp/main.py", [...]) | `def run_application(app, \*\*kwargs): [...]` |
15| 4    | I found the issue.                   | **edit_file**(path="fastmcp/core.py", [...]) | `Made edit to fastmcp/core.py`                |
16| 5    | Let's check if there are any errors. | **diagnostics**()                            | `No errors found`                             |
17
18### Implementation details
19
20`src/explorer.html` contains the template. You can open this template in a
21browser as is, and it will show some dummy values. But the main use is to set
22the `threadsData` variable with real data, which then will be used instead of
23the dummy values.
24
25`src/explorer.rs` takes one or more JSON files as generated by `cargo run -p
26eval`, and outputs an HTML file for rendering these threads. Refer dummy data
27in `explorer.html` for a sample format.