Package Changed
Detect whether normalized public npm or PyPI package registry state changed since a saved fingerprint. Returns a deterministic SHA-256 fingerprint for package/version existence, latest/resolved version, deprecation or yank state, license and runtime requirement. No dependency graph, vulnerability scan or registry mutation.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- did this npm or PyPI package registry state change since my saved fingerprint
- compare current package metadata with a previous SHA-256 state fingerprint
- detect package version deprecation yank license or runtime requirement changes
- watch public package registry metadata for meaningful state changes
What Forest guarantees
- the same bounded public npm or PyPI registry lookup contract as package.preflight
- deterministic SHA-256 fingerprint over declared normalized package decision fields
- no dependency graph resolution, vulnerability scan or registry mutation
Boundaries
- dependency or transitive compatibility changes
- vulnerability or supply-chain safety conclusions
- project URL or registry URL metadata changes, which are intentionally excluded from the fingerprint
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
Canonical paid endpoint
Related capabilities
- Package License — Normalize declared package license metadata toward SPDX; no legal compatibility conclusion.
- Package Preflight — Verify whether a specific npm or PyPI package version exists before installation, resolve the current/latest version, and report deprecation or yank state when available, plus license and runtime requirement. This is a public-registry package install preflight; it does not resolve dependency graphs or perform vulnerability analysis.
- Package Security — Known vulnerabilities for package+version; normalized evidence, not a safety verdict.