Faro
Tools/archive
Archive

Archive

Active

Your agent can't zip or unzip files in its sandbox; this creates and extracts zip and 7z archives.

3 tools

Create and extract zip and 7z archives, or list their contents. 0.5 credits per MB.

Documentszipunziparchive7zcompress

Tools (3)

▶list

List the entries of a zip or 7z archive without extracting.

Usage-based · 0.5 credits per MB

Example prompts

  • “What files are inside this zip?”
  • “List the contents of this archive”

Parameters

input_urlstringrequired

Pre-signed GET URL of the zip or 7z archive.

expires_inintegeroptionaldefault: 3600

Unused by list; accepted for parity with unzip.

API Usage

curl -X POST "https://skill.askfaro.com/skills/archive/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What files are inside this zip?"
  }
}'

CLI Usage

askfaro describe archive/list

Install pip install askfaro-cli, then askfaro auth login.

▶zip

Pack multiple files into a single zip archive.

Usage-based · 0.5 credits per MB

Example prompts

  • “Zip these files into one archive”
  • “Bundle these documents into a zip called report-bundle.zip”

Parameters

filenamesarrayoptional

Optional per-file names, parallel to input_urls. Defaults to the URL basename.

expires_inintegeroptionaldefault: 3600

Download URL TTL in seconds.

input_urlsarrayrequired

Pre-signed GET URLs of the files to pack.

output_filenamestringoptional

Filename for the zip. Defaults to archive.zip.

API Usage

curl -X POST "https://skill.askfaro.com/skills/archive/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Zip these files into one archive"
  }
}'

CLI Usage

askfaro describe archive/zip

Install pip install askfaro-cli, then askfaro auth login.

▶unzip

Extract a zip or 7z archive; each file is returned as a download URL.

Usage-based · 0.5 credits per MB

Example prompts

  • “Unzip this archive and give me the files”
  • “Extract the contents of this 7z file”

Parameters

input_urlstringrequired

Pre-signed GET URL of the zip or 7z archive.

expires_inintegeroptionaldefault: 3600

Download URL TTL in seconds for the extracted files.

API Usage

curl -X POST "https://skill.askfaro.com/skills/archive/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Unzip this archive and give me the files"
  }
}'

CLI Usage

askfaro describe archive/unzip

Install pip install askfaro-cli, then askfaro auth login.

▶README

Archive

Pack files into a zip, extract a zip or 7z archive, or list its entries without extracting. Decompression bombs (archives that expand to far more than they appear) are rejected before any extraction happens.

Workflow

  1. POST /uploads/presign on faro-api for each input, PUT the file, pass the get_url(s).
  2. For zip, you get one archive download_url. For unzip, each extracted file is uploaded and returned with its own download_url.

Pricing

0.5 credits per MB (uncompressed for unzip/list, total input for zip).

Limits

Compressed input up to 200 MB; archives may expand to at most 500 MB across at most 2000 entries. Entries with path traversal or absurd compression ratios are rejected.