library/archive

• wasi:filesystem Filesystem read/write

  ** (rw)

act:tools interface — expand a tool for its input schema.

• supported_formats List the archive formats and compression filters this build supports.

  List the archive formats and compression filters this build supports.

  No input parameters.

  Returns content.

• list_entries List every entry in an archive without extracting: path, size, kind, mode and mtime. Supports tar, zip, 7z, rar, cpio, ar, iso9660, cab, lha, xar and warc, through gzip/bzip2/xz/zstd/lz4 and other filters.

  List every entry in an archive without extracting: path, size, kind, mode and mtime. Supports tar, zip, 7z, rar, cpio, ar, iso9660, cab, lha, xar and warc, through gzip/bzip2/xz/zstd/lz4 and other filters.

  Parameter	Type	Description
  data	object | null	Inline archive bytes, as a CBOR byte string — or `{"$bytes": "<base64>"}` over JSON transports. Needs no filesystem grant.
  path	string | null	Path to an archive on the host. Needs a `wasi:filesystem` read grant.

  Returns content.

• read_entry Read a single entry out of an archive and return its bytes, without unpacking anything to disk. Needs no filesystem write grant.

  Read a single entry out of an archive and return its bytes, without unpacking anything to disk. Needs no filesystem write grant.

  Parameter	Type	Description
  data	object | null	Inline archive bytes, as a CBOR byte string — or `{"$bytes": "<base64>"}` over JSON transports. Needs no filesystem grant.
  path	string | null	Path to an archive on the host. Needs a `wasi:filesystem` read grant.
  entry*	string	Exact entry path as reported by `list_entries`.
  max_bytes	integer | null	Refuse entries larger than this many bytes. Defaults to 256 MiB.

  Returns content.

• extract Unpack an archive into a destination directory. Refuses path traversal, absolute paths, special files and control characters unconditionally; skips symlinks unless allow_links is set; enforces entry-count, size and compression-ratio limits while decoding. Returns what was written and what was refused.

  Unpack an archive into a destination directory. Refuses path traversal, absolute paths, special files and control characters unconditionally; skips symlinks unless allow_links is set; enforces entry-count, size and compression-ratio limits while decoding. Returns what was written and what was refused.

  Parameter	Type	Description
  data	object | null	Inline archive bytes, as a CBOR byte string — or `{"$bytes": "<base64>"}` over JSON transports. Needs no filesystem grant.
  dest*	string	Directory to unpack into. Created if absent. Requires a `wasi:filesystem` write grant covering it.
  path	string | null	Path to an archive on the host. Needs a `wasi:filesystem` read grant.
  limits	Limits	Tunable limits. Omitted fields take their conservative defaults.
  exclude	string[]	Never extract entries matching these globs. Applied before `include`.
  include	string[]	Only extract entries matching one of these globs. Empty means all.

  Returns content.