{"uid":"cap_ey9z5WRPupNBqcvdbPCFQ","slug":"paket-upgrade-path-calculator-8f90df1c","name":"Paket Upgrade Path Calculator","description":"Turns \"we are on 2.4.1 and want to be current\" into an ordered list of stops. The rule it enforces is that no major version is skipped: going from 2 to 5 means stopping at the last release of 3 and the last release of 4, because that is where the migration notes live and where the warnings about the next major are published.","url":"https://paket.halowerk.com/v1/upgrade-path","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","maxLength":300,"minLength":1},"system":{"enum":["npm","pypi","maven","go","cargo","nuget","rubygems"],"type":"string"},"to_version":{"type":"string","maxLength":60,"description":"Target version. Defaults to the newest stable release."},"from_version":{"type":"string","maxLength":60,"minLength":1,"description":"The version currently installed."},"include_prereleases":{"type":"boolean","default":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KUjI0B-zHEqEXx9W6jAJO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Given a current and target version of a package, returns the ordered list of intermediate major-version stops required to safely upgrade without skipping major versions.","exampleAgentPrompt":"We're on version 2.4.1 of react-router and want to upgrade to the latest — can you give me the ordered list of major-version stops we need to pass through so we don't skip any migration guides?","exampleUseCases":[{"title":"Multi-major npm package upgrade plan","prompt":"We're running lodash 3.2.0 in production and want to get to version 5 — can you calculate every intermediate major-version stop we need to hit so we don't miss any breaking-change notes?"},{"title":"Python library migration roadmap","prompt":"Our Django app is on 2.2.1 and we need to reach Django 4.2 — what are all the required major version stops we have to pass through, including the last patch release of each major?"},{"title":"Automated upgrade path check in CI","prompt":"Before we bump our dependency from version 1.5.0 to 6.0.0, tell me the exact ordered sequence of version stops we must land on, since no major version can be skipped."}],"resultDescription":"An ordered list of package version identifiers representing each mandatory stop on the upgrade path, anchored at the last release of each intermediate major version between the current and target versions. Each stop corresponds to where migration notes and deprecation warnings are published.","failureModes":["Package name not found in any supported ecosystem — returns 404 or package-not-found error","Current or target version does not exist for the package — returns version-not-found error","Current version is already at or ahead of target — returns empty path or no-upgrade-needed response","Malformed version string (non-semver) — returns validation error","Target version is not a published release — returns error indicating unrecognised target"],"whenToPreferThis":"Use this endpoint when an agent needs to plan a safe multi-major upgrade and must not skip major versions due to breaking changes or required migration steps. Prefer it over simple version comparison tools when the user is several major versions behind and needs an explicit ordered sequence of intermediate stops, not just the latest version number.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:11.504Z","isFirstParty":false}