Version Packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@refkit/core@0.7.0

Minor Changes

• 3cce5e3: Architecture-review hardening:

  • Conservative cross-source rights merge — when two sources disagree about the license of the same canonical URL, the stricter license wins (incomparable claims collapse to unknown → needs-review); conflicts surface in meta.warnings and via the new merge.onRightsConflict observer. New export: stricterLicense, RightsConflict.
  • Unified pagination cursor — SearchInput.cursor + meta.nextCursor: opaque load-more cursor that first drains the current provider page's overfetched pool, then advances the provider-local page internally, deduping against previously returned results (seen-set capped so cursors stay small).
  • CJK-aware tokenize — CJK runs tokenize into character bigrams, so lexicalReranker scores Chinese/Japanese/Korean queries instead of dropping them.
  • Collision-proof cache keys — per-provider cache keys stay short and fixed-shape (safe for strict KV backends), while the cached value embeds the full normalized-query fingerprint and is verified on read: a key collision degrades to a cache miss, never to another query's results. Existing cache entries are invalidated by the format change (refkit:v2:).
  • New cacheRaw: false option strips raw provider payloads from cache entries.
  • New concurrency option bounds how many provider searches run at once per search call (default unlimited, matching previous behavior); a queued provider's timeout starts only when it actually runs.
  • Deprecations (single-track capability routing) — SearchFilters, SearchInput.filters, NormalizedQuery.filters, ReferenceProvider.queryFeatures (now optional), and QueryFeature are deprecated. Routing is driven solely by capabilities.controls; legacy filters are merged into controls and the deprecated NormalizedQuery.filters channel is derived from the routed controls, so both channels always agree. Providers that declared filter support only via queryFeatures must declare capabilities.controls to keep receiving those values.
  • runProviderSearch / providerCacheKey / stableStringify extracted and exported (provider-run), shrinking the search orchestrator.

@refkit/mcp@0.6.0

Minor Changes

• 3cce5e3: - search_references gains rerank: true (query-aware re-ranking via lexicalReranker, CJK-aware) and cursor (load-more pagination with cross-page dedup; the continuation token is returned as top-level nextCursor on every call, independent of explain).
  • BYOK provider packages are explicitly externalized from the tsup bundle so dynamic imports resolve from node_modules at runtime — --omit=optional actually omits them, and provider patch releases reach @refkit/mcp users without a republish.
  • BYOK provider packages moved from dependencies to optionalDependencies and are now loaded lazily, only when their key is present. Default installs (incl. npx -y @refkit/mcp) still get everything; installs with --omit=optional skip BYOK sources, and a key whose package is missing logs a stderr warning instead of crashing. defaultProviders() is now async.

Patch Changes

• Updated dependencies [3cce5e3]
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0
  • @refkit/provider-openverse@0.3.2
  • @refkit/provider-internet-archive@0.3.2
  • @refkit/provider-wikimedia-commons@0.3.2
  • @refkit/provider-artic@0.2.4
  • @refkit/provider-met@0.2.4
  • @refkit/provider-polyhaven@0.2.3
  • @refkit/provider-gutendex@0.2.4
  • @refkit/provider-poetrydb@0.2.4
  • @refkit/provider-rijksmuseum@0.2.3

@refkit/provider-artic@0.2.4

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-brave@0.2.4

Patch Changes

• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-europeana@0.3.2

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-flickr@0.3.2

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-freesound@0.3.2

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-gutendex@0.2.4

Patch Changes

• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-internet-archive@0.3.2

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-jamendo@0.3.2

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-met@0.2.4

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-openverse@0.3.2

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-pexels@0.2.4

Patch Changes

• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-pixabay@0.2.4

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-poetrydb@0.2.4

Patch Changes

• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-polyhaven@0.2.3

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-rijksmuseum@0.2.3

Patch Changes

• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-smithsonian@0.2.4

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-unsplash@0.2.4

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-wikimedia-commons@0.3.2

Patch Changes

• 3cce5e3: Declare and honor the page search control (capabilities.controls: ['page']), wiring controls.page to each source's native pagination — native page params where they exist, offset translation for offset-based APIs (Wikimedia gsroffset, Smithsonian/Europeana start, Jamendo/ambientCG offset), and a window over the full result list for Met/Poly Haven. Enables core's unified load-more cursor across these sources. (Brave, PoetryDB, and Rijksmuseum expose no usable offset pagination and keep page undeclared.)
• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0

@refkit/provider-testkit@0.0.3

Patch Changes

• Updated dependencies [3cce5e3]
  • @refkit/core@0.7.0