---
type: Attested Computation
title: metadata
identifier: package/metadata
description: Query package registries (pypi, npm, crates, dockerhub) for latest versions, release dates, licenses, and dependencies.
pack: package
tags:
- engineering
- internet
runtime: fragletc
image: ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522
network: required
stdin: none
execution_class: environmental
procedure_hash: sha256:b9fbfd879e68fd814fd7302e317900026434607c181b3882f6359a8f8715d8a4
parameters:
- name: registry
  type: string
  required: true
  description: 'Registry ecosystem: pypi, npm, crates, dockerhub'
- name: package
  type: string
  required: true
  description: Package or image name (e.g. 'requests', 'express', 'tokio', 'library/alpine')
- name: version
  type: string
  required: false
  default: latest
  description: Specific version tag to query, or 'latest'
- name: format
  type: string
  required: false
  default: markdown
  description: 'Output format: markdown or json'
computation: https://tools.ofthemachine.com/package/metadata.py
executor:
  resource: https://github.com/ofthemachine/fraglet
  receipt:
  - schema
  - fragletc
  - procedure
  - procedure_hash
  - image
  - image_digest
  - network
  - stdin_mode
  - params
  - inputs
  - argv
  - env
  - memo_key
  - started
  - finished
  - exit_code
  - stdout
  - outputs
  format: fraglet-receipt/2 (fragletc --receipt <path>, or FRAGLETC_RECEIPT_DIR)
attester:
  resource: https://tools.ofthemachine.com/receipt/attest.py
  method: 'deterministic, no re-execution: procedure_hash equals sha256 of computation; memo_key recomputes from the receipt''s own fields; claimed params and any artifact hash match the receipt'
generated:
  by: process:tools/catalog/compile.py
  at: '2026-11-13T18:27:40Z'
---

# metadata

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.

# Schema

## 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 (the anonymous result)

# Execution

The computation is [`package/metadata.py`](https://tools.ofthemachine.com/package/metadata.py) (frontmatter `computation`; in `tools.tar.gz` the same file sits at `package/metadata.py` beside this bundle), run by `fragletc` in `ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522` with network `required`. Its identity is `procedure_hash` = sha256 of that file, shebang included — the same value every receipt records. Parameters are passed as `-p name=value`; `--receipt run.json` (or `FRAGLETC_RECEIPT_DIR`) writes the receipt, a `fraglet-receipt/2` JSON document with the fields listed under `executor.receipt`.

# Attestation

A run's receipt is attested with [`receipt/attest.py`](https://tools.ofthemachine.com/receipt/attest.py): the computation that ran is this script (`procedure_hash`), the receipt is internally consistent (`memo_key` recomputes from its own fields), the claimed parameters are the ones that ran, and an artifact claimed as an output hashes to what the receipt recorded. No re-execution: attestation is provenance fidelity, not reproduction.

Environmental: the tool reaches the network, so outputs depend on state outside its inputs; the receipt records exactly what ran and what came out and makes no reproduction claim.

Skill: [SKILL.md](https://tools.ofthemachine.com/package/SKILL.md)
