Commit 95a07ec
docs(runtime-bwrap): list poppler-utils as a required host package
The claude-agent-sdk engine's Read tool shells out to pdftoppm (from
poppler-utils) for every PDF read — without it, "pdftoppm is not
installed" fails the agent. Because we already bind /usr read-only
into every sandbox, one apt install on the host makes pdftoppm visible
in every current and future bwrap session.
Surfaced live: a 3.7MB arxiv PDF uploaded via the attachments field
arrived in the workdir byte-perfect but the agent couldn't render it
until poppler-utils was installed on the EC2 host. After the install
no code/restart was needed — the existing /usr read-only bind picks
up the new binary automatically.
Also expanded the host setup to document the same pattern for any
other host CLI tools agents may need (unzip, jq, ffmpeg, sqlite3, ...)
— install on host, available to all sandboxes for free.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>1 parent 5d3b2d0 commit 95a07ec
1 file changed
Lines changed: 25 additions & 4 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
51 | 51 | | |
52 | 52 | | |
53 | 53 | | |
54 | | - | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
55 | 59 | | |
56 | 60 | | |
57 | 61 | | |
| |||
63 | 67 | | |
64 | 68 | | |
65 | 69 | | |
66 | | - | |
67 | | - | |
68 | | - | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
69 | 73 | | |
| 74 | + | |
70 | 75 | | |
71 | 76 | | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
72 | 93 | | |
73 | 94 | | |
74 | 95 | | |
| |||
0 commit comments