Arquivos compactados (@archive)

​

Subcomandos

<tool_call name="@archive" args='{"cmd":"list","args":{"file":"bundle.tar.gz"}}' />
<tool_call name="@archive" args='{"cmd":"read","args":{"file":"bundle.zip","entry":"README.md"}}' />
<tool_call name="@archive" args='{"cmd":"extract","args":{"file":"bundle.zip","to":"./vendor-src"}}' />
<tool_call name="@archive" args='{"cmd":"create","args":{"file":"release.tar.gz","paths":["dist","README.md"]}}' />

​

Segurança

• Zip-slip: nomes absolutos, letras de unidade e escapes .. são recusados; todo destino é resolvido após symlinks e precisa ficar sob to, inclusive quando um ancestral já materializado é um symlink que leva para fora.
• Links: entradas symlink e hard link cujo alvo resolve para fora de to são recusadas.
• Limites valem sobre os bytes realmente lidos, não sobre o tamanho declarado; uma entrada recusada não deixa nada para trás e o relatório diz até onde a extração chegou.
• Arquivos são criados com 0600/0700 e O_EXCL, então uma corrida não transforma uma recusa em sobrescrita.
• list/read são somente leitura; extract/create são mutações e passam pelo gate de segurança do coder.