{"uid":"cap_hJfRcmrAVTW0NrIC7Ldde","slug":"forest-gas-station-npm-pypi-package-preflight-56fe2659","name":"Forest Gas Station – npm/PyPI Package Preflight","description":"Normalize npm or PyPI package reality: existence, requested-version existence, resolved/latest version, staleness, deprecation/yank state when available, license and runtime requirement. No dependency graph or vulnerability analysis. Public registries only; unsupported provider fields are null. Base mainnet USDC","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/package/preflight?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"package":{"type":"string","maxLength":214,"minLength":1,"description":"Public package name to inspect."},"version":{"type":"string","maxLength":128,"minLength":1,"description":"Package version whose public metadata should be checked."},"ecosystem":{"enum":["npm","pypi"],"description":"Public ecosystem value used to scope this lookup."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q9aebR7dBbbrDkuK2Sj-J","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and normalizes metadata for a specific npm or PyPI package (and optional version), returning existence, version resolution, staleness, deprecation/yank state, license, and runtime requirements.","exampleAgentPrompt":"Can you check whether the npm package 'lodash' at version '4.17.21' actually exists on the public registry, and tell me if it's deprecated, what license it uses, and whether there's a newer version available?","exampleUseCases":[{"title":"Dependency health check before install","prompt":"Before I add 'requests' version '2.28.0' from PyPI to my project, can you verify it exists, check if it's been yanked or deprecated, and tell me what Python runtime it requires?"},{"title":"Detect stale npm dependency in project","prompt":"I have 'express' version '4.17.1' listed as a dependency — can you check the npm registry to see if it's still current or if there's a much newer version out, and whether it's been deprecated?"},{"title":"License compliance check for open source audit","prompt":"We're auditing our dependencies — can you look up the license for the PyPI package 'flask' at its latest resolved version so I can confirm it's allowed under our internal policy?"}],"resultDescription":"Returns a normalized object indicating whether the package exists on the registry, whether the requested version exists and/or resolves to a specific version, the latest available version, whether the package or version is deprecated or yanked, its license identifier, and any runtime requirement (e.g. Python version or Node engine). Fields for unsupported registries or unavailable metadata are null. No dependency graph or vulnerability data is included.","failureModes":["Package not found on the specified registry — existence flag is false, other fields are null","Version not found — package exists but the specified version does not","Ecosystem not supported or field is missing — request rejected with validation error","Registry API timeout or upstream unavailability — may return an error or partial null fields","Malformed package name or version string exceeding length limits — validation error"],"whenToPreferThis":"Use this endpoint when you need a fast, normalized sanity check on a single npm or PyPI package — confirming it exists, whether a specific version is valid or yanked, its current license, and runtime requirements — without needing dependency graph traversal, vulnerability scanning, or private registry access. It is ideal for preflight checks before adding a dependency, auditing a lock file entry, or verifying freshness of a pinned version.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:48:47.745Z","isFirstParty":false,"canonicalSlug":"forest-gas-station-npm-pypi-package-preflight-56fe2659"}