---
name: package
description: 'Facts about published software packages -- versions, release dates, licenses, and dependencies from PyPI, npm, crates.io, and Docker Hub. Tools: metadata. Use when a request needs any of these; each tool''s own trigger is in SKILL.md.'
compatibility: Requires fragletc and Docker. Network access required.
metadata:
  tags: engineering, internet
  tools: metadata.py
---

# Package

Facts about published software packages -- versions, release dates, licenses, and dependencies from PyPI, npm, crates.io, and Docker Hub.

Every tool below is one executable file beside this `SKILL.md`, in the directory the commands below call `<skill-dir>`. Run it directly. Two host requirements: [`fragletc`](https://github.com/ofthemachine/fraglet) (`curl -fsSL https://raw.githubusercontent.com/ofthemachine/fraglet/main/install.sh | sh && fragletc version`) and Docker; the image, parameters, outputs and network reach are declared in the file itself. Before running a tool, print its contract:

```sh
<skill-dir>/metadata.py --fraglet-help
```

Parameters are passed as `-p name=value` (a `file` parameter takes a host path); declared outputs are copied out with `--output <name>[=<host path>]`. A missing required parameter fails host-side with exit 2 before any container starts; otherwise the tool's own exit code is the run's. A declared output not named with `--output` is produced and discarded (a stderr note says what you could have copied). Add `--receipt run.json` (or set `FRAGLETC_RECEIPT_DIR`) to record the run: the receipt carries the tool's `procedure_hash`, image digest, parameters, and every input and output by content hash, and `receipt/attest.py` can verify it later without re-running anything.

## Tools

### `metadata.py`

Query package registries (pypi, npm, crates, dockerhub) for latest versions, release dates, licenses, and dependencies.

Use when the user wants to check package versions, verify dependency existence, check release dates, or inspect package metadata.

```sh
<skill-dir>/metadata.py -p registry="<registry>" -p package="<package>" [-p version=latest] [-p format=markdown]
```

Parameters:
- `registry` (string, required) — Registry ecosystem: pypi, npm, crates, dockerhub
- `package` (string, required) — Package or image name (e.g. 'requests', 'express', 'tokio', 'library/alpine')
- `version` (string, optional, default `latest`) — Specific version tag to query, or 'latest'
- `format` (string, optional, default `markdown`) — Output format: markdown or json

Outputs:
- stdout

Runs in `ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522`; network required — output depends on live external state; do not cache indefinitely.
