8000 Hand-drawn sandbox diagrams on the sandbox guide by haizhongzheng · Pull Request #83 · Infini-AI-Lab/hermit · GitHub
[go: up one dir, main page]

Skip to content

Hand-drawn sandbox diagrams on the sandbox guide - #83

Merged
haizhongzheng merged 1 commit into
mainfrom
docs-sandbox-diagrams
Nov 6, 2026
Merged

haizhongzheng merged 1 commit into
mainfrom
docs-sandbox-diagrams

Conversation

@haizhongzheng
Copy link
Copy Markdown
Member

Change

The three Mermaid charts on How the sandbox works are replaced by hand-drawn SVG figures, in the style of the agent-layers page: one colour per role (task, judge, evolver, host), every arrow labelled with what it carries, and red for what a sandbox keeps out.

Figure Shows
Roles and sandboxes Every handoff through the host process: material and the adapter to and from the evolver sandbox, the frozen adapter and the output to and from the task sandbox, collected paths and the score to and from the judge sandbox; where each judge.mode runs
How one sandbox is built The layers in the order they are applied (process, system, Python, programs, declared paths, variables, network, limits), what is never inside, what is covered or emptied, and the check before it starts
Network Process to relay over 127.0.0.1, the relay's forwarded ports over Unix sockets (model server or meter, tool endpoint, allowlist proxy), and the proxy's allowed and refused hosts
  • Figures in docs/_includes/sandbox-*.html, included with {raw} html; colours in docs/_static/css/sandbox-diagrams.css, light and dark through html.dark as agent-layers.css does.
  • Sized for the 640 px content column (viewBox 680 wide); below 600 px a figure scrolls inside its own box and the page does not scroll sideways.
  • The text of the page is unchanged.

Checks

  • bash docs/build-pages.sh (Sphinx with -W) and python docs/check-pages.py: build succeeded, 62 pages checked.
  • Screenshots in light and dark at 1280 px and 420 px: no overlapping labels, no page-level horizontal scroll.

🤖 Generated with Claude Code

The three Mermaid charts on "How the sandbox works" become SVG figures in the style of the agent-layers page:
one colour per role (task, judge, evolver, host), labelled handoffs, and red for what a sandbox keeps out.

- Roles and sandboxes: every handoff through the host, with where each judge mode runs.
- How one sandbox is built: the layers in the order they are applied, what is never inside, what is covered or
  emptied, and the check before it starts.
- Network: the relay, the forwarded ports over Unix sockets, and the allowlist proxy.

The figures live in docs/_includes/sandbox-*.html, their colours in docs/_static/css/sandbox-diagrams.css (light
and dark through html.dark), sized for the content column.
@haizhongzheng
haizhongzheng merged commit c20c840 into main Nov 6, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

0