Repository navigation
OpenPlans v0.4.5
OpenPlans v0.4.5
This release gives a reason where provider and drug searches, and MCP coverage, network and quote
records, answered unknown or an empty list without one. MCP errors that the HTTP transport sends
after reading a request now carry the request's id.
It has no migrations and no backfill. See Upgrading. Answers change only where they
used to be unknown or empty without a reason. The MCP output schema changes for
search_providers.
Fixes
- Coverage and network answers keep their reason over MCP. When
check_drug_coverage,
check_provider_networkorquote_plansanswersunknown, the record'sgapsnow holds the
native reason, such assource_set_not_available. Before, only answers from the CMS fallback
carried it. - Empty provider searches say when no registry is loaded.
GET /v1/providersanswers an empty
identity search withstatus: "unknown"andreason: "provider_registry_not_loaded"when no
NPPES release covers the ZIP's state. The MCP toolsearch_providersadds the samereason
(null otherwise), and the compatibility provider search adds it tox-openplans-gaps. - Drug search says when terminology is missing.
GET /v1/drugsaddsterminology_status.
With no RxNorm release loaded it isunknown, withreason: "rxnorm_terminology_unavailable".
An empty list withavailablemeans no concept matched. - MCP transport errors carry the request id. The MCP HTTP transport's own errors always
carried"id": null, though JSON-RPC 2.0 asks for the request's id whenever the server can read
it. Once the body parses as a single request, these errors now carry its string or number id: a
missingMCP-Protocol-Versionheader, the personalized and estimate access errors,
AUTH_NOT_CONFIGURED, the concurrency limit and the deadline error. Errors sent before the body
is parsed keepnull: the Origin and Host checks, the method check, the rate limit, content
type, size limit and parse errors. So do batches, notifications and requests with a malformed
id.
Development
scripts/oracle/surface-sweep.mjsalso sweeps what loads beside the catalog: provider searches
for every ZIP, sampled NPPES identities, directory listings and formulary drugs against provider
detail, participation, drug search and coverage, and Medicare plan detail routes. Unknown records
inside an answer need their own reason. Seescripts/oracle/README.md.- The test toolchain moves to Vitest 5.0.5, with Vite 8.3.5 as a dev dependency.
Upgrading
- Pull the new image. There is no migration to run and no backfill.
- If you validate MCP output against its schema, take the new schema from
tools/list.
search_providersgains a nullablereason. Clients ofGET /v1/drugssee the new
terminology_statusfield, and clients ofGET /v1/providersmay getstatus: "unknown"with
provider_registry_not_loadedwhere they used to get an empty list. - The bundled plugins keep their v0.4.4 versions and package hashes, so an approved plugin list
needs no change.