@refkit/mcp 0.4.0 → 0.5.1

package/README.md

@@ -1,6 +1,6 @@
 # @refkit/mcp
 
-An MCP server that exposes refkit's **license-normalized reference search** as an agent tool (`search_references`).
+An MCP server that exposes refkit's **license-normalized reference search** (`search_references`) plus two stateless verdict tools (`evaluate_use`, `build_attribution`) as agent tools.
 
 ## Zero-config (`npx`)
 
@@ -10,9 +10,12 @@ Point any MCP client at:
 npx -y @refkit/mcp
 ```
 
-It boots with the keyless sources (Met, Art Institute of Chicago, Wikimedia Commons, Openverse + audio, Project Gutenberg, PoetryDB) and auto-adds any BYOK source whose key is in the environment:
+It boots with the keyless sources (Met, Art Institute of Chicago, Wikimedia Commons, Openverse + audio, Project Gutenberg, PoetryDB) and auto-adds any BYOK source whose key is in the environment. Each key is read as a unified `REFKIT_<PROVIDER>_KEY` name first, falling back to the provider's legacy name (both are honored indefinitely):
 
 ```bash
+REFKIT_UNSPLASH_KEY=… REFKIT_PEXELS_KEY=… REFKIT_PIXABAY_KEY=… REFKIT_FLICKR_KEY=… REFKIT_SMITHSONIAN_KEY=… REFKIT_BRAVE_KEY=… npx -y @refkit/mcp
+
+# legacy names still work:
 UNSPLASH_KEY=… PEXELS_KEY=… PIXABAY_KEY=… FLICKR_KEY=… SI_KEY=… BRAVE_TOKEN=… npx -y @refkit/mcp
 ```
 
@@ -66,6 +69,20 @@ Output: `{ references: [{ id, title?, modality, provider, canonicalUrl, license,
 
 > Results are references with a license id + source link — **not rights clearance, not legal advice**. `unknown` / `needs-review` results require the caller to verify the source's terms.
 
+## The `evaluate_use` tool
+
+Stateless: no search round-trip, no session cache — the caller supplies the rights fields directly.
+
+Input: `{ license, licenseVersion?, author?, title?, canonicalUrl, intent, editorialOnly?, jurisdiction?, userJurisdiction? }`.
+
+Output: `{ decision, reasons, confidence, disclaimer, attribution? }`. `attribution.text`/`.html` are included when `decision` is `allowed-with-attribution` (built from the same input fields via `buildAttribution`).
+
+> Same conservative heuristic as `search_references`' use-gate — **not legal advice**. Every verdict carries a `disclaimer` and a `confidence`.
+
+## The `build_attribution` tool
+
+Input: `{ license, licenseVersion?, author?, title?, canonicalUrl }` → output `{ required, text?, html? }`. `required` is `false` (and `text`/`html` omitted) for licenses that need no attribution (e.g. `CC0-1.0`, `PD`).
+
 ## Discovery (web) source
 
 refkit's clean providers give license-normalized results. For open-web **breadth** (e.g. "cyberpunk alley"), add the Brave discovery provider — its results carry `license: 'unknown'`, so refkit's use-gate returns `needs-review` for every one (never auto-allowed):

package/dist/{chunk-B5SVJVI4.js → chunk-6JDNSEQM.js}

@@ -3,8 +3,8 @@ import { readFileSync } from "fs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { LICENSE_IDS, INTENTS, evaluateUse, buildAttribution, ccVersionFor } from "@refkit/core";
 var MODALITIES = ["image", "video", "audio", "text"];
-var INTENTS = ["internal-moodboard", "commercial-product", "ai-generation-input", "redistribution"];
 var ORIENTATIONS = ["landscape", "portrait", "square"];
 var SEARCH_CONTROL_KEYS = [
   "orientation",
@@ -122,7 +122,9 @@ var searchMetaSchema = z.object({
     accepted: z.number().optional(),
     rejected: z.number().optional(),
     reason: z.enum(["unsupported-modality"]).optional(),
-    error: z.string().optional()
+    error: z.string().optional(),
+    latencyMs: z.number().optional(),
+    cached: z.boolean().optional()
   })),
   gate: z.object({
     intent: z.enum(INTENTS),
@@ -174,6 +176,80 @@ function createRefkitMcpServer(refkit) {
       };
     }
   );
+  const attributionOutputSchema = { required: z.boolean(), text: z.string().optional(), html: z.string().optional() };
+  server.registerTool(
+    "evaluate_use",
+    {
+      title: "Evaluate a license for an intended use",
+      description: "Stateless license/use-gate check: given a license id + intended use, returns a conservative-heuristic verdict (allowed / allowed-with-attribution / denied / needs-review) with reasons and confidence. Not legal advice \u2014 a strict-deny heuristic over source-declared license facts.",
+      inputSchema: {
+        license: z.enum(LICENSE_IDS).describe("the reference's license id"),
+        licenseVersion: z.string().optional().describe('precise CC version, e.g. "4.0" \u2014 attribution only'),
+        author: z.string().optional(),
+        title: z.string().optional(),
+        canonicalUrl: z.string().describe("canonical source link, for attribution and audit"),
+        intent: z.enum(INTENTS).describe("the intended use to evaluate this license against"),
+        editorialOnly: z.boolean().optional().describe("source marked editorial-only"),
+        jurisdiction: z.string().optional().describe("source-declared jurisdiction of the PD/copyright status"),
+        userJurisdiction: z.string().optional().describe("caller's jurisdiction; mismatched jurisdictions default to needs-review")
+      },
+      outputSchema: {
+        decision: z.enum(["allowed", "allowed-with-attribution", "denied", "needs-review"]),
+        reasons: z.array(z.string()),
+        confidence: z.enum(["high", "low"]),
+        disclaimer: z.string(),
+        attribution: z.object(attributionOutputSchema).optional()
+      }
+    },
+    async ({ license, licenseVersion, author, title, canonicalUrl, intent, editorialOnly, jurisdiction, userJurisdiction }) => {
+      const version = ccVersionFor(license, licenseVersion);
+      const rights = {
+        license,
+        licenseVersion: version,
+        author,
+        rehostPolicy: "cache-allowed",
+        jurisdiction,
+        editorialOnly,
+        raw: { sourceTerms: "", sourceUrl: canonicalUrl }
+      };
+      const verdict = evaluateUse(rights, intent, { userJurisdiction });
+      const attribution = verdict.decision === "allowed-with-attribution" ? buildAttribution({ license, licenseVersion: version, author, title, canonicalUrl }) : void 0;
+      const summary = `${verdict.decision}: ${verdict.reasons.join("; ") || "license facts allow this use"}`;
+      return {
+        content: [{ type: "text", text: summary }],
+        structuredContent: {
+          decision: verdict.decision,
+          reasons: verdict.reasons,
+          confidence: verdict.confidence,
+          disclaimer: verdict.disclaimer,
+          ...attribution ? { attribution } : {}
+        }
+      };
+    }
+  );
+  server.registerTool(
+    "build_attribution",
+    {
+      title: "Build an attribution credit line",
+      description: "Mechanically derive an attribution credit line (plain text + HTML) from a license id + author + title + canonicalUrl. `required` is false when the license needs no attribution (e.g. CC0, PD).",
+      inputSchema: {
+        license: z.enum(LICENSE_IDS),
+        licenseVersion: z.string().optional().describe('precise CC version, e.g. "4.0" \u2014 appended to the license name'),
+        author: z.string().optional(),
+        title: z.string().optional(),
+        canonicalUrl: z.string()
+      },
+      outputSchema: attributionOutputSchema
+    },
+    async ({ license, licenseVersion, author, title, canonicalUrl }) => {
+      const version = ccVersionFor(license, licenseVersion);
+      const attribution = buildAttribution({ license, licenseVersion: version, author, title, canonicalUrl });
+      return {
+        content: [{ type: "text", text: attribution.required ? attribution.text ?? "" : "No attribution required for this license." }],
+        structuredContent: { required: attribution.required, text: attribution.text, html: attribution.html }
+      };
+    }
+  );
   return server;
 }
 async function serveStdio(refkit) {
@@ -185,4 +261,4 @@ export {
   createRefkitMcpServer,
   serveStdio
 };
-//# sourceMappingURL=chunk-B5SVJVI4.js.map
+//# sourceMappingURL=chunk-6JDNSEQM.js.map

package/dist/chunk-6JDNSEQM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { z } from 'zod'\nimport { LICENSE_IDS, INTENTS, evaluateUse, buildAttribution, ccVersionFor } from '@refkit/core'\nimport type { RefkitClient, Reference, Verdict, Attribution, SearchFilters, SearchControls, SearchControlKey, ProviderOptionsById, SearchMeta, RightsRecord } from '@refkit/core'\n\nconst MODALITIES = ['image', 'video', 'audio', 'text'] as const\nconst ORIENTATIONS = ['landscape', 'portrait', 'square'] as const\nconst SEARCH_CONTROL_KEYS = [\n  'orientation',\n  'color',\n  'language',\n  'sort',\n  'safety',\n  'license.commercial',\n  'license.modification',\n  'license.allowUnknown',\n  'media.kind',\n  'media.size',\n  'media.minWidth',\n  'media.minHeight',\n  'media.duration',\n  'creator.id',\n  'creator.name',\n  'text.copyright',\n  'page',\n] as const satisfies readonly SearchControlKey[]\n\nconst filtersSchema = z.object({\n  color: z.string().optional(),\n  orientation: z.enum(ORIENTATIONS).optional(),\n  language: z.string().optional(),\n})\nconst searchControlKeySchema = z.enum(SEARCH_CONTROL_KEYS)\n\nconst searchControlsSchema = z.object({\n  orientation: z.enum(ORIENTATIONS).optional(),\n  color: z.string().optional(),\n  language: z.string().optional(),\n  sort: z.enum(['relevance', 'latest', 'popular', 'interesting']).optional(),\n  safety: z.enum(['strict', 'moderate', 'off']).optional(),\n  license: z.object({\n    commercial: z.boolean().optional(),\n    modification: z.boolean().optional(),\n    allowUnknown: z.boolean().optional(),\n  }).optional(),\n  media: z.object({\n    kind: z.enum(['photo', 'illustration', 'vector', 'film', 'animation']).optional(),\n    size: z.enum(['small', 'medium', 'large']).optional(),\n    minWidth: z.number().int().nonnegative().optional(),\n    minHeight: z.number().int().nonnegative().optional(),\n    duration: z.enum(['short', 'medium', 'long']).optional(),\n  }).optional(),\n  creator: z.object({\n    id: z.string().optional(),\n    name: z.string().optional(),\n  }).optional(),\n  text: z.object({\n    copyright: z.enum(['public-domain', 'copyrighted', 'any']).optional(),\n  }).optional(),\n  page: z.number().int().positive().optional(),\n})\n\nconst providerOptionValueSchema = z.union([z.string(), z.number(), z.boolean(), z.array(z.string())])\nconst providerOptionsSchema = z.record(z.string(), z.record(z.string(), providerOptionValueSchema))\n\n// Reported in the MCP initialize handshake. Read the real version (the dist sits\n// next to package.json, which npm always ships) instead of a hardcoded placeholder.\nconst VERSION: string = (() => {\n  try {\n    return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version\n  } catch {\n    return '0.0.0'\n  }\n})()\n\n// Concise, agent-facing projection of a Reference (no raw provider dump). When an\n// intent is supplied the use-gate verdict + attribution ride along, so the agent\n// sees *whether it may use* each result — not just a bare license id it ignores.\nfunction toAgentRef(r: Reference, assessment?: { verdict: Verdict; attribution: Attribution }) {\n  const base = {\n    id: r.id,\n    title: r.title,\n    modality: r.modality,\n    provider: r.source.providerId,\n    canonicalUrl: r.canonicalUrl,\n    license: r.rights.license,\n    thumbnail: r.thumbnail?.url,\n    excerpt: r.text?.excerpt,\n  }\n  if (!assessment) return base\n  const { verdict, attribution } = assessment\n  const reason = verdict.reasons.join('; ')\n  const useExplanation = `${verdict.decision}: ${reason || 'license facts allow this use'}${attribution.required && attribution.text ? ` Attribution required: ${attribution.text}` : ''}`\n  return {\n    ...base,\n    useVerdict: { decision: verdict.decision, reason: verdict.reasons.join('; '), confidence: verdict.confidence },\n    useExplanation,\n    ...(attribution.required && attribution.text ? { attribution: attribution.text } : {}),\n  }\n}\n\nconst agentRefSchema = z.object({\n  id: z.string(),\n  title: z.string().optional(),\n  modality: z.string(),\n  provider: z.string(),\n  canonicalUrl: z.string(),\n  license: z.string(),\n  thumbnail: z.string().optional(),\n  excerpt: z.string().optional(),\n  useVerdict: z\n    .object({ decision: z.string(), reason: z.string(), confidence: z.string() })\n    .optional()\n    .describe('present when `intent` (or `gateFor`) is set: may this be used for that intent, and how confident'),\n  useExplanation: z.string().optional().describe('plain-language use verdict summary for agents'),\n  attribution: z.string().optional().describe('ready-to-use credit line; present when the license requires attribution'),\n})\n\nconst searchMetaSchema: z.ZodType<SearchMeta> = z.object({\n  query: z.string(),\n  modalities: z.array(z.enum(MODALITIES)),\n  limit: z.number(),\n  poolFactor: z.number(),\n  fetchLimit: z.number(),\n  appliedFilters: filtersSchema.optional(),\n  controls: z.object({\n    requested: z.array(searchControlKeySchema),\n    appliedByProvider: z.record(z.string(), z.array(searchControlKeySchema)),\n    ignoredByProvider: z.record(z.string(), z.array(searchControlKeySchema)),\n  }).optional(),\n  providerOptions: z.array(z.string()).optional(),\n  providers: z.array(z.object({\n    providerId: z.string(),\n    status: z.enum(['fulfilled', 'failed', 'skipped']),\n    returned: z.number().optional(),\n    accepted: z.number().optional(),\n    rejected: z.number().optional(),\n    reason: z.enum(['unsupported-modality']).optional(),\n    error: z.string().optional(),\n    latencyMs: z.number().optional(),\n    cached: z.boolean().optional(),\n  })),\n  gate: z.object({\n    intent: z.enum(INTENTS),\n    before: z.number(),\n    after: z.number(),\n    dropped: z.number(),\n  }).optional(),\n  warnings: z.array(z.string()),\n})\n\n/** Wrap a configured RefkitClient as an MCP server exposing `search_references`. */\nexport function createRefkitMcpServer(refkit: RefkitClient): McpServer {\n  const server = new McpServer({ name: 'refkit', version: VERSION })\n\n  server.registerTool(\n    'search_references',\n    {\n      title: 'Search creative references',\n      description:\n        'Search license-normalized reference material (image / video / audio / text) across the configured sources. ' +\n        'Every result carries a license id + canonical source link. Pass `intent` to annotate each result with a ' +\n        'use-verdict (may I use this, is attribution required) WITHOUT filtering; pass `gateFor` to instead return ' +\n        'only results whose license allows that intent. Results are references, not rights clearance — not legal advice.',\n      inputSchema: {\n        query: z.string().describe('what to search for, e.g. \"cyberpunk alley at night\"'),\n        modalities: z.array(z.enum(MODALITIES)).optional().describe('default [\"image\"]'),\n        filters: filtersSchema.optional().describe('compatibility alias for controls.orientation, controls.color, and controls.language'),\n        controls: searchControlsSchema.optional().describe('provider-neutral search controls; providers translate supported controls and report ignored controls in explain metadata'),\n        providerOptions: providerOptionsSchema.optional().describe('provider-specific search controls keyed by provider id; each provider whitelists supported keys'),\n        explain: z.boolean().optional().describe('include provider status, applied and ignored controls, warnings, and gate/drop metadata'),\n        limit: z.number().int().positive().optional(),\n        intent: z.enum(INTENTS).optional().describe('annotate each result with a use-verdict for this intended use (no filtering)'),\n        gateFor: z.enum(INTENTS).optional().describe('only return results whose license allows this intended use'),\n      },\n      outputSchema: { references: z.array(agentRefSchema), meta: searchMetaSchema.optional() },\n    },\n    async ({ query, modalities, filters, controls, providerOptions, explain, limit, intent, gateFor }) => {\n      const searchInput = {\n        query,\n        modalities: modalities ?? ['image'],\n        filters: filters as SearchFilters | undefined,\n        controls: controls as SearchControls | undefined,\n        providerOptions: providerOptions as ProviderOptionsById | undefined,\n        limit,\n        gateFor,\n      }\n      const result = explain ? await refkit.searchWithMeta(searchInput) : { references: await refkit.search(searchInput), meta: undefined }\n      const refs = result.references\n      const assessIntent = intent ?? gateFor\n      const references = refs.map(r =>\n        assessIntent\n          ? toAgentRef(r, { verdict: refkit.evaluateUse(r, assessIntent), attribution: refkit.buildAttribution(r) })\n          : toAgentRef(r),\n      )\n      return {\n        content: [{ type: 'text', text: `${references.length} reference(s) for \"${query}\".` }],\n        structuredContent: { references, ...(result.meta ? { meta: result.meta } : {}) },\n      }\n    },\n  )\n\n  const attributionOutputSchema = { required: z.boolean(), text: z.string().optional(), html: z.string().optional() }\n\n  server.registerTool(\n    'evaluate_use',\n    {\n      title: 'Evaluate a license for an intended use',\n      description:\n        'Stateless license/use-gate check: given a license id + intended use, returns a conservative-heuristic verdict ' +\n        '(allowed / allowed-with-attribution / denied / needs-review) with reasons and confidence. ' +\n        'Not legal advice — a strict-deny heuristic over source-declared license facts.',\n      inputSchema: {\n        license: z.enum(LICENSE_IDS).describe('the reference\\'s license id'),\n        licenseVersion: z.string().optional().describe('precise CC version, e.g. \"4.0\" — attribution only'),\n        author: z.string().optional(),\n        title: z.string().optional(),\n        canonicalUrl: z.string().describe('canonical source link, for attribution and audit'),\n        intent: z.enum(INTENTS).describe('the intended use to evaluate this license against'),\n        editorialOnly: z.boolean().optional().describe('source marked editorial-only'),\n        jurisdiction: z.string().optional().describe('source-declared jurisdiction of the PD/copyright status'),\n        userJurisdiction: z.string().optional().describe('caller\\'s jurisdiction; mismatched jurisdictions default to needs-review'),\n      },\n      outputSchema: {\n        decision: z.enum(['allowed', 'allowed-with-attribution', 'denied', 'needs-review']),\n        reasons: z.array(z.string()),\n        confidence: z.enum(['high', 'low']),\n        disclaimer: z.string(),\n        attribution: z.object(attributionOutputSchema).optional(),\n      },\n    },\n    async ({ license, licenseVersion, author, title, canonicalUrl, intent, editorialOnly, jurisdiction, userJurisdiction }) => {\n      const version = ccVersionFor(license, licenseVersion)\n      const rights: RightsRecord = {\n        license,\n        licenseVersion: version,\n        author,\n        rehostPolicy: 'cache-allowed',\n        jurisdiction,\n        editorialOnly,\n        raw: { sourceTerms: '', sourceUrl: canonicalUrl },\n      }\n      const verdict: Verdict = evaluateUse(rights, intent, { userJurisdiction })\n      const attribution =\n        verdict.decision === 'allowed-with-attribution'\n          ? buildAttribution({ license, licenseVersion: version, author, title, canonicalUrl })\n          : undefined\n      const summary = `${verdict.decision}: ${verdict.reasons.join('; ') || 'license facts allow this use'}`\n      return {\n        content: [{ type: 'text', text: summary }],\n        structuredContent: {\n          decision: verdict.decision,\n          reasons: verdict.reasons,\n          confidence: verdict.confidence,\n          disclaimer: verdict.disclaimer,\n          ...(attribution ? { attribution } : {}),\n        },\n      }\n    },\n  )\n\n  server.registerTool(\n    'build_attribution',\n    {\n      title: 'Build an attribution credit line',\n      description:\n        'Mechanically derive an attribution credit line (plain text + HTML) from a license id + author + title + ' +\n        'canonicalUrl. `required` is false when the license needs no attribution (e.g. CC0, PD).',\n      inputSchema: {\n        license: z.enum(LICENSE_IDS),\n        licenseVersion: z.string().optional().describe('precise CC version, e.g. \"4.0\" — appended to the license name'),\n        author: z.string().optional(),\n        title: z.string().optional(),\n        canonicalUrl: z.string(),\n      },\n      outputSchema: attributionOutputSchema,\n    },\n    async ({ license, licenseVersion, author, title, canonicalUrl }) => {\n      const version = ccVersionFor(license, licenseVersion)\n      const attribution: Attribution = buildAttribution({ license, licenseVersion: version, author, title, canonicalUrl })\n      return {\n        content: [{ type: 'text', text: attribution.required ? (attribution.text ?? '') : 'No attribution required for this license.' }],\n        structuredContent: { required: attribution.required, text: attribution.text, html: attribution.html },\n      }\n    },\n  )\n\n  return server\n}\n\n/** Run the refkit MCP server over stdio (host wires the RefkitClient + its providers/keys). */\nexport async function serveStdio(refkit: RefkitClient): Promise<void> {\n  const server = createRefkitMcpServer(refkit)\n  await server.connect(new StdioServerTransport())\n}\n"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -2,7 +2,11 @@
 import { ReferenceProvider } from '@refkit/core';
 
 /** Providers a zero-config server boots with: all keyless sources, plus any BYOK
- *  source whose key is present in `env`. Exported so the wiring is unit-testable. */
+ *  source whose key is present in `env`. Exported so the wiring is unit-testable.
+ *
+ *  Env var convention: each BYOK key is read as `REFKIT_<PROVIDER>_KEY` first (the
+ *  unified name), falling back to the provider's legacy env var name — both are
+ *  honored indefinitely, the unified name is just preferred going forward. */
 declare function defaultProviders(env?: NodeJS.ProcessEnv): ReferenceProvider[];
 
 export { defaultProviders };

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   serveStdio
-} from "./chunk-B5SVJVI4.js";
+} from "./chunk-6JDNSEQM.js";
 
 // src/cli.ts
 import { realpathSync } from "fs";
@@ -39,15 +39,24 @@ function defaultProviders(env = process.env) {
     ambientcg(),
     internetArchive()
   ];
-  if (env.UNSPLASH_KEY) providers.push(unsplash({ accessKey: env.UNSPLASH_KEY }));
-  if (env.PEXELS_KEY) providers.push(pexels({ apiKey: env.PEXELS_KEY }), pexelsVideo({ apiKey: env.PEXELS_KEY }));
-  if (env.PIXABAY_KEY) providers.push(pixabay({ key: env.PIXABAY_KEY }), pixabayVideo({ key: env.PIXABAY_KEY }));
-  if (env.FLICKR_KEY) providers.push(flickr({ apiKey: env.FLICKR_KEY }));
-  if (env.SI_KEY) providers.push(smithsonian({ apiKey: env.SI_KEY }));
-  if (env.BRAVE_TOKEN) providers.push(brave({ token: env.BRAVE_TOKEN }));
-  if (env.FREESOUND_TOKEN) providers.push(freesound({ apiKey: env.FREESOUND_TOKEN }));
-  if (env.JAMENDO_CLIENT_ID) providers.push(jamendo({ clientId: env.JAMENDO_CLIENT_ID }));
-  if (env.EUROPEANA_KEY) providers.push(europeana({ apiKey: env.EUROPEANA_KEY }));
+  const unsplashKey = env.REFKIT_UNSPLASH_KEY ?? env.UNSPLASH_KEY;
+  const pexelsKey = env.REFKIT_PEXELS_KEY ?? env.PEXELS_KEY;
+  const pixabayKey = env.REFKIT_PIXABAY_KEY ?? env.PIXABAY_KEY;
+  const flickrKey = env.REFKIT_FLICKR_KEY ?? env.FLICKR_KEY;
+  const smithsonianKey = env.REFKIT_SMITHSONIAN_KEY ?? env.SI_KEY;
+  const braveKey = env.REFKIT_BRAVE_KEY ?? env.BRAVE_TOKEN;
+  const freesoundKey = env.REFKIT_FREESOUND_KEY ?? env.FREESOUND_TOKEN;
+  const jamendoClientId = env.REFKIT_JAMENDO_CLIENT_ID ?? env.JAMENDO_CLIENT_ID;
+  const europeanaKey = env.REFKIT_EUROPEANA_KEY ?? env.EUROPEANA_KEY;
+  if (unsplashKey) providers.push(unsplash({ accessKey: unsplashKey }));
+  if (pexelsKey) providers.push(pexels({ apiKey: pexelsKey }), pexelsVideo({ apiKey: pexelsKey }));
+  if (pixabayKey) providers.push(pixabay({ key: pixabayKey }), pixabayVideo({ key: pixabayKey }));
+  if (flickrKey) providers.push(flickr({ apiKey: flickrKey }));
+  if (smithsonianKey) providers.push(smithsonian({ apiKey: smithsonianKey }));
+  if (braveKey) providers.push(brave({ token: braveKey }));
+  if (freesoundKey) providers.push(freesound({ apiKey: freesoundKey }));
+  if (jamendoClientId) providers.push(jamendo({ clientId: jamendoClientId }));
+  if (europeanaKey) providers.push(europeana({ apiKey: europeanaKey }));
   return providers;
 }
 var isEntry = (() => {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n// Zero-config entry: `npx @refkit/mcp` boots a working MCP server with the keyless\n// providers, plus any BYOK provider whose key is in the environment. No host code.\nimport { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\nimport { createRefkit, type ReferenceProvider } from '@refkit/core'\nimport { openverse, openverseAudio } from '@refkit/provider-openverse'\nimport { wikimediaCommons } from '@refkit/provider-wikimedia-commons'\nimport { met } from '@refkit/provider-met'\nimport { artic } from '@refkit/provider-artic'\nimport { gutendex } from '@refkit/provider-gutendex'\nimport { poetrydb } from '@refkit/provider-poetrydb'\nimport { unsplash } from '@refkit/provider-unsplash'\nimport { pexels, pexelsVideo } from '@refkit/provider-pexels'\nimport { pixabay, pixabayVideo } from '@refkit/provider-pixabay'\nimport { flickr } from '@refkit/provider-flickr'\nimport { smithsonian } from '@refkit/provider-smithsonian'\nimport { brave } from '@refkit/provider-brave'\nimport { rijksmuseum } from '@refkit/provider-rijksmuseum'\nimport { polyhaven, ambientcg } from '@refkit/provider-polyhaven'\nimport { freesound } from '@refkit/provider-freesound'\nimport { jamendo } from '@refkit/provider-jamendo'\nimport { europeana } from '@refkit/provider-europeana'\nimport { internetArchive } from '@refkit/provider-internet-archive'\nimport { serveStdio } from './index'\n\n/** Providers a zero-config server boots with: all keyless sources, plus any BYOK\n *  source whose key is present in `env`. Exported so the wiring is unit-testable. */\nexport function defaultProviders(env: NodeJS.ProcessEnv = process.env): ReferenceProvider[] {\n  const providers: ReferenceProvider[] = [\n    openverse(), openverseAudio(), wikimediaCommons(), met(), artic(), gutendex(), poetrydb(),\n    rijksmuseum(), polyhaven(), ambientcg(), internetArchive(),\n  ]\n  if (env.UNSPLASH_KEY) providers.push(unsplash({ accessKey: env.UNSPLASH_KEY }))\n  if (env.PEXELS_KEY) providers.push(pexels({ apiKey: env.PEXELS_KEY }), pexelsVideo({ apiKey: env.PEXELS_KEY }))\n  if (env.PIXABAY_KEY) providers.push(pixabay({ key: env.PIXABAY_KEY }), pixabayVideo({ key: env.PIXABAY_KEY }))\n  if (env.FLICKR_KEY) providers.push(flickr({ apiKey: env.FLICKR_KEY }))\n  if (env.SI_KEY) providers.push(smithsonian({ apiKey: env.SI_KEY }))\n  if (env.BRAVE_TOKEN) providers.push(brave({ token: env.BRAVE_TOKEN }))\n  if (env.FREESOUND_TOKEN) providers.push(freesound({ apiKey: env.FREESOUND_TOKEN }))\n  if (env.JAMENDO_CLIENT_ID) providers.push(jamendo({ clientId: env.JAMENDO_CLIENT_ID }))\n  if (env.EUROPEANA_KEY) providers.push(europeana({ apiKey: env.EUROPEANA_KEY }))\n  return providers\n}\n\n// Boot only when run as the CLI entry — not when imported (e.g. by tests). realpath\n// so an npm bin symlink resolves to this file.\nconst isEntry = (() => {\n  if (!process.argv[1]) return false\n  try {\n    return realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)\n  } catch {\n    return false\n  }\n})()\n\nif (isEntry) {\n  await serveStdio(createRefkit({ providers: defaultProviders() }))\n}\n"],"mappings":";;;;;;AAGA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,oBAA4C;AACrD,SAAS,WAAW,sBAAsB;AAC1C,SAAS,wBAAwB;AACjC,SAAS,WAAW;AACpB,SAAS,aAAa;AACtB,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,QAAQ,mBAAmB;AACpC,SAAS,SAAS,oBAAoB;AACtC,SAAS,cAAc;AACvB,SAAS,mBAAmB;AAC5B,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,SAAS,WAAW,iBAAiB;AACrC,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,uBAAuB;AAKzB,SAAS,iBAAiB,MAAyB,QAAQ,KAA0B;AAC1F,QAAM,YAAiC;AAAA,IACrC,UAAU;AAAA,IAAG,eAAe;AAAA,IAAG,iBAAiB;AAAA,IAAG,IAAI;AAAA,IAAG,MAAM;AAAA,IAAG,SAAS;AAAA,IAAG,SAAS;AAAA,IACxF,YAAY;AAAA,IAAG,UAAU;AAAA,IAAG,UAAU;AAAA,IAAG,gBAAgB;AAAA,EAC3D;AACA,MAAI,IAAI,aAAc,WAAU,KAAK,SAAS,EAAE,WAAW,IAAI,aAAa,CAAC,CAAC;AAC9E,MAAI,IAAI,WAAY,WAAU,KAAK,OAAO,EAAE,QAAQ,IAAI,WAAW,CAAC,GAAG,YAAY,EAAE,QAAQ,IAAI,WAAW,CAAC,CAAC;AAC9G,MAAI,IAAI,YAAa,WAAU,KAAK,QAAQ,EAAE,KAAK,IAAI,YAAY,CAAC,GAAG,aAAa,EAAE,KAAK,IAAI,YAAY,CAAC,CAAC;AAC7G,MAAI,IAAI,WAAY,WAAU,KAAK,OAAO,EAAE,QAAQ,IAAI,WAAW,CAAC,CAAC;AACrE,MAAI,IAAI,OAAQ,WAAU,KAAK,YAAY,EAAE,QAAQ,IAAI,OAAO,CAAC,CAAC;AAClE,MAAI,IAAI,YAAa,WAAU,KAAK,MAAM,EAAE,OAAO,IAAI,YAAY,CAAC,CAAC;AACrE,MAAI,IAAI,gBAAiB,WAAU,KAAK,UAAU,EAAE,QAAQ,IAAI,gBAAgB,CAAC,CAAC;AAClF,MAAI,IAAI,kBAAmB,WAAU,KAAK,QAAQ,EAAE,UAAU,IAAI,kBAAkB,CAAC,CAAC;AACtF,MAAI,IAAI,cAAe,WAAU,KAAK,UAAU,EAAE,QAAQ,IAAI,cAAc,CAAC,CAAC;AAC9E,SAAO;AACT;AAIA,IAAM,WAAW,MAAM;AACrB,MAAI,CAAC,QAAQ,KAAK,CAAC,EAAG,QAAO;AAC7B,MAAI;AACF,WAAO,aAAa,QAAQ,KAAK,CAAC,CAAC,MAAM,cAAc,YAAY,GAAG;AAAA,EACxE,QAAQ;AACN,WAAO;AAAA,EACT;AACF,GAAG;AAEH,IAAI,SAAS;AACX,QAAM,WAAW,aAAa,EAAE,WAAW,iBAAiB,EAAE,CAAC,CAAC;AAClE;","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n// Zero-config entry: `npx @refkit/mcp` boots a working MCP server with the keyless\n// providers, plus any BYOK provider whose key is in the environment. No host code.\nimport { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\nimport { createRefkit, type ReferenceProvider } from '@refkit/core'\nimport { openverse, openverseAudio } from '@refkit/provider-openverse'\nimport { wikimediaCommons } from '@refkit/provider-wikimedia-commons'\nimport { met } from '@refkit/provider-met'\nimport { artic } from '@refkit/provider-artic'\nimport { gutendex } from '@refkit/provider-gutendex'\nimport { poetrydb } from '@refkit/provider-poetrydb'\nimport { unsplash } from '@refkit/provider-unsplash'\nimport { pexels, pexelsVideo } from '@refkit/provider-pexels'\nimport { pixabay, pixabayVideo } from '@refkit/provider-pixabay'\nimport { flickr } from '@refkit/provider-flickr'\nimport { smithsonian } from '@refkit/provider-smithsonian'\nimport { brave } from '@refkit/provider-brave'\nimport { rijksmuseum } from '@refkit/provider-rijksmuseum'\nimport { polyhaven, ambientcg } from '@refkit/provider-polyhaven'\nimport { freesound } from '@refkit/provider-freesound'\nimport { jamendo } from '@refkit/provider-jamendo'\nimport { europeana } from '@refkit/provider-europeana'\nimport { internetArchive } from '@refkit/provider-internet-archive'\nimport { serveStdio } from './index'\n\n/** Providers a zero-config server boots with: all keyless sources, plus any BYOK\n *  source whose key is present in `env`. Exported so the wiring is unit-testable.\n *\n *  Env var convention: each BYOK key is read as `REFKIT_<PROVIDER>_KEY` first (the\n *  unified name), falling back to the provider's legacy env var name — both are\n *  honored indefinitely, the unified name is just preferred going forward. */\nexport function defaultProviders(env: NodeJS.ProcessEnv = process.env): ReferenceProvider[] {\n  const providers: ReferenceProvider[] = [\n    openverse(), openverseAudio(), wikimediaCommons(), met(), artic(), gutendex(), poetrydb(),\n    rijksmuseum(), polyhaven(), ambientcg(), internetArchive(),\n  ]\n  const unsplashKey = env.REFKIT_UNSPLASH_KEY ?? env.UNSPLASH_KEY\n  const pexelsKey = env.REFKIT_PEXELS_KEY ?? env.PEXELS_KEY\n  const pixabayKey = env.REFKIT_PIXABAY_KEY ?? env.PIXABAY_KEY\n  const flickrKey = env.REFKIT_FLICKR_KEY ?? env.FLICKR_KEY\n  const smithsonianKey = env.REFKIT_SMITHSONIAN_KEY ?? env.SI_KEY\n  const braveKey = env.REFKIT_BRAVE_KEY ?? env.BRAVE_TOKEN\n  const freesoundKey = env.REFKIT_FREESOUND_KEY ?? env.FREESOUND_TOKEN\n  const jamendoClientId = env.REFKIT_JAMENDO_CLIENT_ID ?? env.JAMENDO_CLIENT_ID\n  const europeanaKey = env.REFKIT_EUROPEANA_KEY ?? env.EUROPEANA_KEY\n  if (unsplashKey) providers.push(unsplash({ accessKey: unsplashKey }))\n  if (pexelsKey) providers.push(pexels({ apiKey: pexelsKey }), pexelsVideo({ apiKey: pexelsKey }))\n  if (pixabayKey) providers.push(pixabay({ key: pixabayKey }), pixabayVideo({ key: pixabayKey }))\n  if (flickrKey) providers.push(flickr({ apiKey: flickrKey }))\n  if (smithsonianKey) providers.push(smithsonian({ apiKey: smithsonianKey }))\n  if (braveKey) providers.push(brave({ token: braveKey }))\n  if (freesoundKey) providers.push(freesound({ apiKey: freesoundKey }))\n  if (jamendoClientId) providers.push(jamendo({ clientId: jamendoClientId }))\n  if (europeanaKey) providers.push(europeana({ apiKey: europeanaKey }))\n  return providers\n}\n\n// Boot only when run as the CLI entry — not when imported (e.g. by tests). realpath\n// so an npm bin symlink resolves to this file.\nconst isEntry = (() => {\n  if (!process.argv[1]) return false\n  try {\n    return realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)\n  } catch {\n    return false\n  }\n})()\n\nif (isEntry) {\n  await serveStdio(createRefkit({ providers: defaultProviders() }))\n}\n"],"mappings":";;;;;;AAGA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,oBAA4C;AACrD,SAAS,WAAW,sBAAsB;AAC1C,SAAS,wBAAwB;AACjC,SAAS,WAAW;AACpB,SAAS,aAAa;AACtB,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,QAAQ,mBAAmB;AACpC,SAAS,SAAS,oBAAoB;AACtC,SAAS,cAAc;AACvB,SAAS,mBAAmB;AAC5B,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,SAAS,WAAW,iBAAiB;AACrC,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,uBAAuB;AASzB,SAAS,iBAAiB,MAAyB,QAAQ,KAA0B;AAC1F,QAAM,YAAiC;AAAA,IACrC,UAAU;AAAA,IAAG,eAAe;AAAA,IAAG,iBAAiB;AAAA,IAAG,IAAI;AAAA,IAAG,MAAM;AAAA,IAAG,SAAS;AAAA,IAAG,SAAS;AAAA,IACxF,YAAY;AAAA,IAAG,UAAU;AAAA,IAAG,UAAU;AAAA,IAAG,gBAAgB;AAAA,EAC3D;AACA,QAAM,cAAc,IAAI,uBAAuB,IAAI;AACnD,QAAM,YAAY,IAAI,qBAAqB,IAAI;AAC/C,QAAM,aAAa,IAAI,sBAAsB,IAAI;AACjD,QAAM,YAAY,IAAI,qBAAqB,IAAI;AAC/C,QAAM,iBAAiB,IAAI,0BAA0B,IAAI;AACzD,QAAM,WAAW,IAAI,oBAAoB,IAAI;AAC7C,QAAM,eAAe,IAAI,wBAAwB,IAAI;AACrD,QAAM,kBAAkB,IAAI,4BAA4B,IAAI;AAC5D,QAAM,eAAe,IAAI,wBAAwB,IAAI;AACrD,MAAI,YAAa,WAAU,KAAK,SAAS,EAAE,WAAW,YAAY,CAAC,CAAC;AACpE,MAAI,UAAW,WAAU,KAAK,OAAO,EAAE,QAAQ,UAAU,CAAC,GAAG,YAAY,EAAE,QAAQ,UAAU,CAAC,CAAC;AAC/F,MAAI,WAAY,WAAU,KAAK,QAAQ,EAAE,KAAK,WAAW,CAAC,GAAG,aAAa,EAAE,KAAK,WAAW,CAAC,CAAC;AAC9F,MAAI,UAAW,WAAU,KAAK,OAAO,EAAE,QAAQ,UAAU,CAAC,CAAC;AAC3D,MAAI,eAAgB,WAAU,KAAK,YAAY,EAAE,QAAQ,eAAe,CAAC,CAAC;AAC1E,MAAI,SAAU,WAAU,KAAK,MAAM,EAAE,OAAO,SAAS,CAAC,CAAC;AACvD,MAAI,aAAc,WAAU,KAAK,UAAU,EAAE,QAAQ,aAAa,CAAC,CAAC;AACpE,MAAI,gBAAiB,WAAU,KAAK,QAAQ,EAAE,UAAU,gBAAgB,CAAC,CAAC;AAC1E,MAAI,aAAc,WAAU,KAAK,UAAU,EAAE,QAAQ,aAAa,CAAC,CAAC;AACpE,SAAO;AACT;AAIA,IAAM,WAAW,MAAM;AACrB,MAAI,CAAC,QAAQ,KAAK,CAAC,EAAG,QAAO;AAC7B,MAAI;AACF,WAAO,aAAa,QAAQ,KAAK,CAAC,CAAC,MAAM,cAAc,YAAY,GAAG;AAAA,EACxE,QAAQ;AACN,WAAO;AAAA,EACT;AACF,GAAG;AAEH,IAAI,SAAS;AACX,QAAM,WAAW,aAAa,EAAE,WAAW,iBAAiB,EAAE,CAAC,CAAC;AAClE;","names":[]}

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createRefkitMcpServer,
   serveStdio
-} from "./chunk-B5SVJVI4.js";
+} from "./chunk-6JDNSEQM.js";
 export {
   createRefkitMcpServer,
   serveStdio

package/package.json

@@ -1,9 +1,16 @@
 {
   "name": "@refkit/mcp",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "MCP server for refkit — exposes license-normalized reference search as an agent tool.",
   "type": "module",
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/refkitjs/refkit.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/refkitjs/refkit/tree/main/packages/mcp#readme",
+  "bugs": "https://github.com/refkitjs/refkit/issues",
   "keywords": [
     "refkit",
     "mcp",
@@ -27,25 +34,25 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6",
-    "@refkit/core": "0.5.0",
-    "@refkit/provider-artic": "0.2.1",
-    "@refkit/provider-brave": "0.2.1",
-    "@refkit/provider-flickr": "0.2.1",
-    "@refkit/provider-europeana": "0.2.0",
-    "@refkit/provider-gutendex": "0.2.1",
-    "@refkit/provider-freesound": "0.2.0",
-    "@refkit/provider-internet-archive": "0.2.0",
-    "@refkit/provider-jamendo": "0.2.0",
-    "@refkit/provider-met": "0.2.1",
-    "@refkit/provider-pexels": "0.2.1",
-    "@refkit/provider-openverse": "0.2.1",
-    "@refkit/provider-pixabay": "0.2.1",
-    "@refkit/provider-polyhaven": "0.2.0",
-    "@refkit/provider-poetrydb": "0.2.1",
-    "@refkit/provider-rijksmuseum": "0.2.0",
-    "@refkit/provider-smithsonian": "0.2.1",
-    "@refkit/provider-unsplash": "0.2.1",
-    "@refkit/provider-wikimedia-commons": "0.2.1"
+    "@refkit/core": "0.6.1",
+    "@refkit/provider-artic": "0.2.3",
+    "@refkit/provider-brave": "0.2.3",
+    "@refkit/provider-europeana": "0.3.1",
+    "@refkit/provider-flickr": "0.3.1",
+    "@refkit/provider-freesound": "0.3.1",
+    "@refkit/provider-gutendex": "0.2.3",
+    "@refkit/provider-internet-archive": "0.3.1",
+    "@refkit/provider-jamendo": "0.3.1",
+    "@refkit/provider-met": "0.2.3",
+    "@refkit/provider-openverse": "0.3.1",
+    "@refkit/provider-pexels": "0.2.3",
+    "@refkit/provider-pixabay": "0.2.3",
+    "@refkit/provider-poetrydb": "0.2.3",
+    "@refkit/provider-polyhaven": "0.2.2",
+    "@refkit/provider-rijksmuseum": "0.2.2",
+    "@refkit/provider-smithsonian": "0.2.3",
+    "@refkit/provider-unsplash": "0.2.3",
+    "@refkit/provider-wikimedia-commons": "0.3.1"
   },
   "files": [
     "dist",

package/dist/chunk-B5SVJVI4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { z } from 'zod'\nimport type { RefkitClient, Reference, Verdict, Attribution, SearchFilters, SearchControls, SearchControlKey, ProviderOptionsById, SearchMeta } from '@refkit/core'\n\nconst MODALITIES = ['image', 'video', 'audio', 'text'] as const\nconst INTENTS = ['internal-moodboard', 'commercial-product', 'ai-generation-input', 'redistribution'] as const\nconst ORIENTATIONS = ['landscape', 'portrait', 'square'] as const\nconst SEARCH_CONTROL_KEYS = [\n  'orientation',\n  'color',\n  'language',\n  'sort',\n  'safety',\n  'license.commercial',\n  'license.modification',\n  'license.allowUnknown',\n  'media.kind',\n  'media.size',\n  'media.minWidth',\n  'media.minHeight',\n  'media.duration',\n  'creator.id',\n  'creator.name',\n  'text.copyright',\n  'page',\n] as const satisfies readonly SearchControlKey[]\n\nconst filtersSchema = z.object({\n  color: z.string().optional(),\n  orientation: z.enum(ORIENTATIONS).optional(),\n  language: z.string().optional(),\n})\nconst searchControlKeySchema = z.enum(SEARCH_CONTROL_KEYS)\n\nconst searchControlsSchema = z.object({\n  orientation: z.enum(ORIENTATIONS).optional(),\n  color: z.string().optional(),\n  language: z.string().optional(),\n  sort: z.enum(['relevance', 'latest', 'popular', 'interesting']).optional(),\n  safety: z.enum(['strict', 'moderate', 'off']).optional(),\n  license: z.object({\n    commercial: z.boolean().optional(),\n    modification: z.boolean().optional(),\n    allowUnknown: z.boolean().optional(),\n  }).optional(),\n  media: z.object({\n    kind: z.enum(['photo', 'illustration', 'vector', 'film', 'animation']).optional(),\n    size: z.enum(['small', 'medium', 'large']).optional(),\n    minWidth: z.number().int().nonnegative().optional(),\n    minHeight: z.number().int().nonnegative().optional(),\n    duration: z.enum(['short', 'medium', 'long']).optional(),\n  }).optional(),\n  creator: z.object({\n    id: z.string().optional(),\n    name: z.string().optional(),\n  }).optional(),\n  text: z.object({\n    copyright: z.enum(['public-domain', 'copyrighted', 'any']).optional(),\n  }).optional(),\n  page: z.number().int().positive().optional(),\n})\n\nconst providerOptionValueSchema = z.union([z.string(), z.number(), z.boolean(), z.array(z.string())])\nconst providerOptionsSchema = z.record(z.string(), z.record(z.string(), providerOptionValueSchema))\n\n// Reported in the MCP initialize handshake. Read the real version (the dist sits\n// next to package.json, which npm always ships) instead of a hardcoded placeholder.\nconst VERSION: string = (() => {\n  try {\n    return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version\n  } catch {\n    return '0.0.0'\n  }\n})()\n\n// Concise, agent-facing projection of a Reference (no raw provider dump). When an\n// intent is supplied the use-gate verdict + attribution ride along, so the agent\n// sees *whether it may use* each result — not just a bare license id it ignores.\nfunction toAgentRef(r: Reference, assessment?: { verdict: Verdict; attribution: Attribution }) {\n  const base = {\n    id: r.id,\n    title: r.title,\n    modality: r.modality,\n    provider: r.source.providerId,\n    canonicalUrl: r.canonicalUrl,\n    license: r.rights.license,\n    thumbnail: r.thumbnail?.url,\n    excerpt: r.text?.excerpt,\n  }\n  if (!assessment) return base\n  const { verdict, attribution } = assessment\n  const reason = verdict.reasons.join('; ')\n  const useExplanation = `${verdict.decision}: ${reason || 'license facts allow this use'}${attribution.required && attribution.text ? ` Attribution required: ${attribution.text}` : ''}`\n  return {\n    ...base,\n    useVerdict: { decision: verdict.decision, reason: verdict.reasons.join('; '), confidence: verdict.confidence },\n    useExplanation,\n    ...(attribution.required && attribution.text ? { attribution: attribution.text } : {}),\n  }\n}\n\nconst agentRefSchema = z.object({\n  id: z.string(),\n  title: z.string().optional(),\n  modality: z.string(),\n  provider: z.string(),\n  canonicalUrl: z.string(),\n  license: z.string(),\n  thumbnail: z.string().optional(),\n  excerpt: z.string().optional(),\n  useVerdict: z\n    .object({ decision: z.string(), reason: z.string(), confidence: z.string() })\n    .optional()\n    .describe('present when `intent` (or `gateFor`) is set: may this be used for that intent, and how confident'),\n  useExplanation: z.string().optional().describe('plain-language use verdict summary for agents'),\n  attribution: z.string().optional().describe('ready-to-use credit line; present when the license requires attribution'),\n})\n\nconst searchMetaSchema: z.ZodType<SearchMeta> = z.object({\n  query: z.string(),\n  modalities: z.array(z.enum(MODALITIES)),\n  limit: z.number(),\n  poolFactor: z.number(),\n  fetchLimit: z.number(),\n  appliedFilters: filtersSchema.optional(),\n  controls: z.object({\n    requested: z.array(searchControlKeySchema),\n    appliedByProvider: z.record(z.string(), z.array(searchControlKeySchema)),\n    ignoredByProvider: z.record(z.string(), z.array(searchControlKeySchema)),\n  }).optional(),\n  providerOptions: z.array(z.string()).optional(),\n  providers: z.array(z.object({\n    providerId: z.string(),\n    status: z.enum(['fulfilled', 'failed', 'skipped']),\n    returned: z.number().optional(),\n    accepted: z.number().optional(),\n    rejected: z.number().optional(),\n    reason: z.enum(['unsupported-modality']).optional(),\n    error: z.string().optional(),\n  })),\n  gate: z.object({\n    intent: z.enum(INTENTS),\n    before: z.number(),\n    after: z.number(),\n    dropped: z.number(),\n  }).optional(),\n  warnings: z.array(z.string()),\n})\n\n/** Wrap a configured RefkitClient as an MCP server exposing `search_references`. */\nexport function createRefkitMcpServer(refkit: RefkitClient): McpServer {\n  const server = new McpServer({ name: 'refkit', version: VERSION })\n\n  server.registerTool(\n    'search_references',\n    {\n      title: 'Search creative references',\n      description:\n        'Search license-normalized reference material (image / video / audio / text) across the configured sources. ' +\n        'Every result carries a license id + canonical source link. Pass `intent` to annotate each result with a ' +\n        'use-verdict (may I use this, is attribution required) WITHOUT filtering; pass `gateFor` to instead return ' +\n        'only results whose license allows that intent. Results are references, not rights clearance — not legal advice.',\n      inputSchema: {\n        query: z.string().describe('what to search for, e.g. \"cyberpunk alley at night\"'),\n        modalities: z.array(z.enum(MODALITIES)).optional().describe('default [\"image\"]'),\n        filters: filtersSchema.optional().describe('compatibility alias for controls.orientation, controls.color, and controls.language'),\n        controls: searchControlsSchema.optional().describe('provider-neutral search controls; providers translate supported controls and report ignored controls in explain metadata'),\n        providerOptions: providerOptionsSchema.optional().describe('provider-specific search controls keyed by provider id; each provider whitelists supported keys'),\n        explain: z.boolean().optional().describe('include provider status, applied and ignored controls, warnings, and gate/drop metadata'),\n        limit: z.number().int().positive().optional(),\n        intent: z.enum(INTENTS).optional().describe('annotate each result with a use-verdict for this intended use (no filtering)'),\n        gateFor: z.enum(INTENTS).optional().describe('only return results whose license allows this intended use'),\n      },\n      outputSchema: { references: z.array(agentRefSchema), meta: searchMetaSchema.optional() },\n    },\n    async ({ query, modalities, filters, controls, providerOptions, explain, limit, intent, gateFor }) => {\n      const searchInput = {\n        query,\n        modalities: modalities ?? ['image'],\n        filters: filters as SearchFilters | undefined,\n        controls: controls as SearchControls | undefined,\n        providerOptions: providerOptions as ProviderOptionsById | undefined,\n        limit,\n        gateFor,\n      }\n      const result = explain ? await refkit.searchWithMeta(searchInput) : { references: await refkit.search(searchInput), meta: undefined }\n      const refs = result.references\n      const assessIntent = intent ?? gateFor\n      const references = refs.map(r =>\n        assessIntent\n          ? toAgentRef(r, { verdict: refkit.evaluateUse(r, assessIntent), attribution: refkit.buildAttribution(r) })\n          : toAgentRef(r),\n      )\n      return {\n        content: [{ type: 'text', text: `${references.length} reference(s) for \"${query}\".` }],\n        structuredContent: { references, ...(result.meta ? { meta: result.meta } : {}) },\n      }\n    },\n  )\n\n  return server\n}\n\n/** Run the refkit MCP server over stdio (host wires the RefkitClient + its providers/keys). */\nexport async function serveStdio(refkit: RefkitClient): Promise<void> {\n  const server = createRefkitMcpServer(refkit)\n  await server.connect(new StdioServerTransport())\n}\n"],"mappings":"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","names":[]}