MyPrototypeWhat · MyPrototypeWhat · Jun 25, 2026 · Jun 25, 2026
diff --git a/.changeset/provider-search-controls.md b/.changeset/provider-search-controls.md
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @refkit/core
 
+## 0.4.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
 ## 0.3.0
 
 ### Minor Changes

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "refkit core — neutral reference-retrieval brain: Reference/RightsRecord contract, license normalization, strict-deny use-gate, RRF merge/dedup, ReferenceProvider interfaces. Zero-network, zero-provider, only zod.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/mcp/CHANGELOG.md b/packages/mcp/CHANGELOG.md
@@ -1,5 +1,28 @@
 # @refkit/mcp
 
+## 0.3.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+  - @refkit/provider-unsplash@0.2.0
+  - @refkit/provider-pexels@0.2.0
+  - @refkit/provider-pixabay@0.2.0
+  - @refkit/provider-flickr@0.2.0
+  - @refkit/provider-brave@0.2.0
+  - @refkit/provider-openverse@0.2.0
+  - @refkit/provider-gutendex@0.2.0
+  - @refkit/provider-poetrydb@0.2.0
+  - @refkit/provider-wikimedia-commons@0.2.0
+  - @refkit/provider-met@0.2.0
+  - @refkit/provider-artic@0.2.0
+  - @refkit/provider-smithsonian@0.2.0
+
 ## 0.2.0
 
 ### Minor Changes

diff --git a/packages/mcp/package.json b/packages/mcp/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for refkit — exposes license-normalized reference search as an agent tool.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-artic/CHANGELOG.md b/packages/provider-artic/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-artic
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-artic/package.json b/packages/provider-artic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-artic",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Art Institute of Chicago provider satellite for refkit.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-brave/CHANGELOG.md b/packages/provider-brave/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-brave
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-brave/package.json b/packages/provider-brave/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-brave",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Brave Search web-discovery provider satellite for refkit — open-web image breadth, license:unknown (use-gated to needs-review).",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-flickr/CHANGELOG.md b/packages/provider-flickr/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-flickr
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-flickr/package.json b/packages/provider-flickr/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-flickr",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Flickr provider satellite for refkit.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-gutendex/CHANGELOG.md b/packages/provider-gutendex/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-gutendex
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-gutendex/package.json b/packages/provider-gutendex/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-gutendex",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Gutendex (Project Gutenberg) provider satellite for refkit — public-domain book references, per-item copyright→license.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-met/CHANGELOG.md b/packages/provider-met/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-met
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-met/package.json b/packages/provider-met/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-met",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "The Metropolitan Museum of Art provider satellite for refkit.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-openverse/CHANGELOG.md b/packages/provider-openverse/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-openverse
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-openverse/package.json b/packages/provider-openverse/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-openverse",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Openverse provider satellite for refkit — CC/PD licensed image search, license-normalized.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-pexels/CHANGELOG.md b/packages/provider-pexels/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-pexels
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-pexels/package.json b/packages/provider-pexels/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-pexels",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Pexels provider satellite for refkit — image search, hotlink-required.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-pixabay/CHANGELOG.md b/packages/provider-pixabay/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-pixabay
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-pixabay/package.json b/packages/provider-pixabay/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-pixabay",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Pixabay provider satellite for refkit — image search, cache-allowed.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-poetrydb/CHANGELOG.md b/packages/provider-poetrydb/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-poetrydb
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-poetrydb/package.json b/packages/provider-poetrydb/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-poetrydb",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "PoetryDB provider satellite for refkit — classic public-domain poems.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-smithsonian/CHANGELOG.md b/packages/provider-smithsonian/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-smithsonian
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-smithsonian/package.json b/packages/provider-smithsonian/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-smithsonian",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Smithsonian Open Access provider satellite for refkit.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-unsplash/CHANGELOG.md b/packages/provider-unsplash/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-unsplash
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-unsplash/package.json b/packages/provider-unsplash/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-unsplash",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Unsplash provider satellite for refkit.",
   "type": "module",
   "license": "Apache-2.0",

diff --git a/packages/provider-wikimedia-commons/CHANGELOG.md b/packages/provider-wikimedia-commons/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @refkit/provider-wikimedia-commons
 
+## 0.2.0
+
+### Minor Changes
+
+- 8c221f8: Add unified search controls, provider capability metadata, MCP controls input, search metadata/explanations, practical provider-specific `providerOptions` whitelists, and a core duplicate hook for agent-facing searches.
+
+### Patch Changes
+
+- Updated dependencies [8c221f8]
+  - @refkit/core@0.4.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/provider-wikimedia-commons/package.json b/packages/provider-wikimedia-commons/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@refkit/provider-wikimedia-commons",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Wikimedia Commons provider satellite for refkit.",
   "type": "module",
   "license": "Apache-2.0",