@refkit/mcp 0.5.0 → 0.6.0

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

@@ -3,7 +3,7 @@ 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";
+import { LICENSE_IDS, INTENTS, evaluateUse, buildAttribution, ccVersionFor, lexicalReranker } from "@refkit/core";
 var MODALITIES = ["image", "video", "audio", "text"];
 var ORIENTATIONS = ["landscape", "portrait", "square"];
 var SEARCH_CONTROL_KEYS = [
@@ -132,6 +132,7 @@ var searchMetaSchema = z.object({
     after: z.number(),
     dropped: z.number()
   }).optional(),
+  nextCursor: z.string().optional().describe("opaque load-more cursor; pass back as `cursor` to fetch the next page with cross-page dedup"),
   warnings: z.array(z.string())
 });
 function createRefkitMcpServer(refkit) {
@@ -147,14 +148,20 @@ function createRefkitMcpServer(refkit) {
         filters: filtersSchema.optional().describe("compatibility alias for controls.orientation, controls.color, and controls.language"),
         controls: searchControlsSchema.optional().describe("provider-neutral search controls; providers translate supported controls and report ignored controls in explain metadata"),
         providerOptions: providerOptionsSchema.optional().describe("provider-specific search controls keyed by provider id; each provider whitelists supported keys"),
-        explain: z.boolean().optional().describe("include provider status, applied and ignored controls, warnings, and gate/drop metadata"),
+        explain: z.boolean().optional().describe("include provider status, applied and ignored controls, warnings, gate/drop metadata, and the load-more cursor"),
         limit: z.number().int().positive().optional(),
+        cursor: z.string().optional().describe("opaque cursor from a previous result's nextCursor \u2014 fetches the next batch, deduped against earlier batches"),
+        rerank: z.boolean().optional().describe("re-rank results by query relevance (term coverage incl. CJK, resolution, source diversity) instead of raw cross-source rank fusion"),
         intent: z.enum(INTENTS).optional().describe("annotate each result with a use-verdict for this intended use (no filtering)"),
         gateFor: z.enum(INTENTS).optional().describe("only return results whose license allows this intended use")
       },
-      outputSchema: { references: z.array(agentRefSchema), meta: searchMetaSchema.optional() }
+      outputSchema: {
+        references: z.array(agentRefSchema),
+        nextCursor: z.string().optional().describe("pass back as `cursor` for the next batch; absent = exhausted"),
+        meta: searchMetaSchema.optional()
+      }
     },
-    async ({ query, modalities, filters, controls, providerOptions, explain, limit, intent, gateFor }) => {
+    async ({ query, modalities, filters, controls, providerOptions, explain, limit, cursor, rerank, intent, gateFor }) => {
       const searchInput = {
         query,
         modalities: modalities ?? ["image"],
@@ -162,9 +169,11 @@ function createRefkitMcpServer(refkit) {
         controls,
         providerOptions,
         limit,
+        cursor,
+        ...rerank ? { rerank: lexicalReranker() } : {},
         gateFor
       };
-      const result = explain ? await refkit.searchWithMeta(searchInput) : { references: await refkit.search(searchInput), meta: void 0 };
+      const result = await refkit.searchWithMeta(searchInput);
       const refs = result.references;
       const assessIntent = intent ?? gateFor;
       const references = refs.map(
@@ -172,7 +181,11 @@ function createRefkitMcpServer(refkit) {
       );
       return {
         content: [{ type: "text", text: `${references.length} reference(s) for "${query}".` }],
-        structuredContent: { references, ...result.meta ? { meta: result.meta } : {} }
+        structuredContent: {
+          references,
+          ...result.meta.nextCursor ? { nextCursor: result.meta.nextCursor } : {},
+          ...explain ? { meta: result.meta } : {}
+        }
       };
     }
   );
@@ -261,4 +274,4 @@ export {
   createRefkitMcpServer,
   serveStdio
 };
-//# sourceMappingURL=chunk-6JDNSEQM.js.map
+//# sourceMappingURL=chunk-DQHNPSDF.js.map

package/dist/chunk-DQHNPSDF.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, lexicalReranker } 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  nextCursor: z.string().optional().describe('opaque load-more cursor; pass back as `cursor` to fetch the next page with cross-page dedup'),\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, gate/drop metadata, and the load-more cursor'),\n        limit: z.number().int().positive().optional(),\n        cursor: z.string().optional().describe('opaque cursor from a previous result\\'s nextCursor — fetches the next batch, deduped against earlier batches'),\n        rerank: z.boolean().optional().describe('re-rank results by query relevance (term coverage incl. CJK, resolution, source diversity) instead of raw cross-source rank fusion'),\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: {\n        references: z.array(agentRefSchema),\n        nextCursor: z.string().optional().describe('pass back as `cursor` for the next batch; absent = exhausted'),\n        meta: searchMetaSchema.optional(),\n      },\n    },\n    async ({ query, modalities, filters, controls, providerOptions, explain, limit, cursor, rerank, 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        cursor,\n        ...(rerank ? { rerank: lexicalReranker() } : {}),\n        gateFor,\n      }\n      // Always searchWithMeta: the continuation token (meta.nextCursor) must not\n      // depend on the explain diagnostics flag — only the meta DUMP is gated.\n      const result = await refkit.searchWithMeta(searchInput)\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: {\n          references,\n          ...(result.meta.nextCursor ? { nextCursor: result.meta.nextCursor } : {}),\n          ...(explain ? { meta: result.meta } : {}),\n        },\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

@@ -1,12 +1,20 @@
 #!/usr/bin/env node
 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.
- *
- *  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[];
+/** One BYOK source: its unified + legacy env var names, and a lazy loader for its
+ *  (optional) provider package. Loaded only when a key is present, so installs
+ *  that omitted optionalDependencies still boot — the missing source is skipped
+ *  with a stderr warning instead of crashing the server. */
+interface ByokSource {
+    pkg: string;
+    key: (env: NodeJS.ProcessEnv) => string | undefined;
+    load: (key: string) => Promise<ReferenceProvider[]>;
+}
+declare const BYOK_SOURCES: ByokSource[];
+/** Providers a zero-config server boots with: all keyless sources (hard deps,
+ *  statically imported), plus any BYOK source whose key is present in `env`
+ *  (optionalDependencies, dynamically imported on demand). Exported so the
+ *  wiring is unit-testable. */
+declare function defaultProviders(env?: NodeJS.ProcessEnv): Promise<ReferenceProvider[]>;
 
-export { defaultProviders };
+export { BYOK_SOURCES, defaultProviders };

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   serveStdio
-} from "./chunk-6JDNSEQM.js";
+} from "./chunk-DQHNPSDF.js";
 
 // src/cli.ts
 import { realpathSync } from "fs";
@@ -13,19 +13,63 @@ import { met } from "@refkit/provider-met";
 import { artic } from "@refkit/provider-artic";
 import { gutendex } from "@refkit/provider-gutendex";
 import { poetrydb } from "@refkit/provider-poetrydb";
-import { unsplash } from "@refkit/provider-unsplash";
-import { pexels, pexelsVideo } from "@refkit/provider-pexels";
-import { pixabay, pixabayVideo } from "@refkit/provider-pixabay";
-import { flickr } from "@refkit/provider-flickr";
-import { smithsonian } from "@refkit/provider-smithsonian";
-import { brave } from "@refkit/provider-brave";
 import { rijksmuseum } from "@refkit/provider-rijksmuseum";
 import { polyhaven, ambientcg } from "@refkit/provider-polyhaven";
-import { freesound } from "@refkit/provider-freesound";
-import { jamendo } from "@refkit/provider-jamendo";
-import { europeana } from "@refkit/provider-europeana";
 import { internetArchive } from "@refkit/provider-internet-archive";
-function defaultProviders(env = process.env) {
+var BYOK_SOURCES = [
+  {
+    pkg: "@refkit/provider-unsplash",
+    key: (env) => env.REFKIT_UNSPLASH_KEY ?? env.UNSPLASH_KEY,
+    load: async (accessKey) => [(await import("@refkit/provider-unsplash")).unsplash({ accessKey })]
+  },
+  {
+    pkg: "@refkit/provider-pexels",
+    key: (env) => env.REFKIT_PEXELS_KEY ?? env.PEXELS_KEY,
+    load: async (apiKey) => {
+      const m = await import("@refkit/provider-pexels");
+      return [m.pexels({ apiKey }), m.pexelsVideo({ apiKey })];
+    }
+  },
+  {
+    pkg: "@refkit/provider-pixabay",
+    key: (env) => env.REFKIT_PIXABAY_KEY ?? env.PIXABAY_KEY,
+    load: async (key) => {
+      const m = await import("@refkit/provider-pixabay");
+      return [m.pixabay({ key }), m.pixabayVideo({ key })];
+    }
+  },
+  {
+    pkg: "@refkit/provider-flickr",
+    key: (env) => env.REFKIT_FLICKR_KEY ?? env.FLICKR_KEY,
+    load: async (apiKey) => [(await import("@refkit/provider-flickr")).flickr({ apiKey })]
+  },
+  {
+    pkg: "@refkit/provider-smithsonian",
+    key: (env) => env.REFKIT_SMITHSONIAN_KEY ?? env.SI_KEY,
+    load: async (apiKey) => [(await import("@refkit/provider-smithsonian")).smithsonian({ apiKey })]
+  },
+  {
+    pkg: "@refkit/provider-brave",
+    key: (env) => env.REFKIT_BRAVE_KEY ?? env.BRAVE_TOKEN,
+    load: async (token) => [(await import("@refkit/provider-brave")).brave({ token })]
+  },
+  {
+    pkg: "@refkit/provider-freesound",
+    key: (env) => env.REFKIT_FREESOUND_KEY ?? env.FREESOUND_TOKEN,
+    load: async (apiKey) => [(await import("@refkit/provider-freesound")).freesound({ apiKey })]
+  },
+  {
+    pkg: "@refkit/provider-jamendo",
+    key: (env) => env.REFKIT_JAMENDO_CLIENT_ID ?? env.JAMENDO_CLIENT_ID,
+    load: async (clientId) => [(await import("@refkit/provider-jamendo")).jamendo({ clientId })]
+  },
+  {
+    pkg: "@refkit/provider-europeana",
+    key: (env) => env.REFKIT_EUROPEANA_KEY ?? env.EUROPEANA_KEY,
+    load: async (apiKey) => [(await import("@refkit/provider-europeana")).europeana({ apiKey })]
+  }
+];
+async function defaultProviders(env = process.env) {
   const providers = [
     openverse(),
     openverseAudio(),
@@ -39,24 +83,22 @@ function defaultProviders(env = process.env) {
     ambientcg(),
     internetArchive()
   ];
-  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 }));
+  const loaded = await Promise.all(BYOK_SOURCES.map(async (source) => {
+    const key = source.key(env);
+    if (!key) return [];
+    try {
+      return await source.load(key);
+    } catch (err) {
+      const code = err?.code;
+      if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
+        console.error(`[refkit-mcp] key for ${source.pkg} is set but the package is not installed \u2014 skipping this source. Reinstall @refkit/mcp with optional dependencies (or add ${source.pkg}) to enable it.`);
+      } else {
+        console.error(`[refkit-mcp] failed to initialize ${source.pkg} \u2014 skipping this source.`, err);
+      }
+      return [];
+    }
+  }));
+  for (const group of loaded) providers.push(...group);
   return providers;
 }
 var isEntry = (() => {
@@ -68,9 +110,10 @@ var isEntry = (() => {
   }
 })();
 if (isEntry) {
-  await serveStdio(createRefkit({ providers: defaultProviders() }));
+  await serveStdio(createRefkit({ providers: await defaultProviders() }));
 }
 export {
+  BYOK_SOURCES,
   defaultProviders
 };
 //# sourceMappingURL=cli.js.map

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.\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":[]}
+{"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 { rijksmuseum } from '@refkit/provider-rijksmuseum'\nimport { polyhaven, ambientcg } from '@refkit/provider-polyhaven'\nimport { internetArchive } from '@refkit/provider-internet-archive'\nimport { serveStdio } from './index'\n\n/** One BYOK source: its unified + legacy env var names, and a lazy loader for its\n *  (optional) provider package. Loaded only when a key is present, so installs\n *  that omitted optionalDependencies still boot — the missing source is skipped\n *  with a stderr warning instead of crashing the server. */\ninterface ByokSource {\n  pkg: string\n  key: (env: NodeJS.ProcessEnv) => string | undefined\n  load: (key: string) => Promise<ReferenceProvider[]>\n}\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.\n// Exported so tests can assert this table stays in sync with the package's\n// optionalDependencies — an entry in one but not the other ships a source that\n// either can never load or never installs.\nexport const BYOK_SOURCES: ByokSource[] = [\n  {\n    pkg: '@refkit/provider-unsplash',\n    key: (env) => env.REFKIT_UNSPLASH_KEY ?? env.UNSPLASH_KEY,\n    load: async (accessKey) => [(await import('@refkit/provider-unsplash')).unsplash({ accessKey })],\n  },\n  {\n    pkg: '@refkit/provider-pexels',\n    key: (env) => env.REFKIT_PEXELS_KEY ?? env.PEXELS_KEY,\n    load: async (apiKey) => {\n      const m = await import('@refkit/provider-pexels')\n      return [m.pexels({ apiKey }), m.pexelsVideo({ apiKey })]\n    },\n  },\n  {\n    pkg: '@refkit/provider-pixabay',\n    key: (env) => env.REFKIT_PIXABAY_KEY ?? env.PIXABAY_KEY,\n    load: async (key) => {\n      const m = await import('@refkit/provider-pixabay')\n      return [m.pixabay({ key }), m.pixabayVideo({ key })]\n    },\n  },\n  {\n    pkg: '@refkit/provider-flickr',\n    key: (env) => env.REFKIT_FLICKR_KEY ?? env.FLICKR_KEY,\n    load: async (apiKey) => [(await import('@refkit/provider-flickr')).flickr({ apiKey })],\n  },\n  {\n    pkg: '@refkit/provider-smithsonian',\n    key: (env) => env.REFKIT_SMITHSONIAN_KEY ?? env.SI_KEY,\n    load: async (apiKey) => [(await import('@refkit/provider-smithsonian')).smithsonian({ apiKey })],\n  },\n  {\n    pkg: '@refkit/provider-brave',\n    key: (env) => env.REFKIT_BRAVE_KEY ?? env.BRAVE_TOKEN,\n    load: async (token) => [(await import('@refkit/provider-brave')).brave({ token })],\n  },\n  {\n    pkg: '@refkit/provider-freesound',\n    key: (env) => env.REFKIT_FREESOUND_KEY ?? env.FREESOUND_TOKEN,\n    load: async (apiKey) => [(await import('@refkit/provider-freesound')).freesound({ apiKey })],\n  },\n  {\n    pkg: '@refkit/provider-jamendo',\n    key: (env) => env.REFKIT_JAMENDO_CLIENT_ID ?? env.JAMENDO_CLIENT_ID,\n    load: async (clientId) => [(await import('@refkit/provider-jamendo')).jamendo({ clientId })],\n  },\n  {\n    pkg: '@refkit/provider-europeana',\n    key: (env) => env.REFKIT_EUROPEANA_KEY ?? env.EUROPEANA_KEY,\n    load: async (apiKey) => [(await import('@refkit/provider-europeana')).europeana({ apiKey })],\n  },\n]\n\n/** Providers a zero-config server boots with: all keyless sources (hard deps,\n *  statically imported), plus any BYOK source whose key is present in `env`\n *  (optionalDependencies, dynamically imported on demand). Exported so the\n *  wiring is unit-testable. */\nexport async function defaultProviders(env: NodeJS.ProcessEnv = process.env): Promise<ReferenceProvider[]> {\n  const providers: ReferenceProvider[] = [\n    openverse(), openverseAudio(), wikimediaCommons(), met(), artic(), gutendex(), poetrydb(),\n    rijksmuseum(), polyhaven(), ambientcg(), internetArchive(),\n  ]\n  // Independent module loads — run them concurrently (startup cost = max, not sum)\n  // and keep BYOK_SOURCES order in the provider list.\n  const loaded = await Promise.all(BYOK_SOURCES.map(async (source) => {\n    const key = source.key(env)\n    if (!key) return []\n    try {\n      return await source.load(key)\n    } catch (err) {\n      // stderr only — stdout is the MCP transport. Only a genuinely missing\n      // module gets the \"not installed\" hint; anything else (factory throw,\n      // broken transitive import) surfaces the REAL error so the operator\n      // doesn't chase the wrong remediation.\n      const code = (err as { code?: string } | null)?.code\n      if (code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND') {\n        console.error(`[refkit-mcp] key for ${source.pkg} is set but the package is not installed — skipping this source. Reinstall @refkit/mcp with optional dependencies (or add ${source.pkg}) to enable it.`)\n      } else {\n        console.error(`[refkit-mcp] failed to initialize ${source.pkg} — skipping this source.`, err)\n      }\n      return []\n    }\n  }))\n  for (const group of loaded) providers.push(...group)\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: await defaultProviders() }))\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

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

package/package.json

@@ -1,9 +1,16 @@
 {
   "name": "@refkit/mcp",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "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,30 +34,32 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6",
-    "@refkit/core": "0.6.0",
-    "@refkit/provider-artic": "0.2.2",
-    "@refkit/provider-brave": "0.2.2",
-    "@refkit/provider-europeana": "0.3.0",
-    "@refkit/provider-flickr": "0.3.0",
-    "@refkit/provider-freesound": "0.3.0",
-    "@refkit/provider-gutendex": "0.2.2",
-    "@refkit/provider-internet-archive": "0.3.0",
-    "@refkit/provider-jamendo": "0.3.0",
-    "@refkit/provider-met": "0.2.2",
-    "@refkit/provider-openverse": "0.3.0",
-    "@refkit/provider-pexels": "0.2.2",
-    "@refkit/provider-pixabay": "0.2.2",
-    "@refkit/provider-poetrydb": "0.2.2",
-    "@refkit/provider-polyhaven": "0.2.1",
-    "@refkit/provider-rijksmuseum": "0.2.1",
-    "@refkit/provider-smithsonian": "0.2.2",
-    "@refkit/provider-unsplash": "0.2.2",
-    "@refkit/provider-wikimedia-commons": "0.3.0"
+    "@refkit/core": "0.7.0",
+    "@refkit/provider-artic": "0.2.4",
+    "@refkit/provider-gutendex": "0.2.4",
+    "@refkit/provider-internet-archive": "0.3.2",
+    "@refkit/provider-met": "0.2.4",
+    "@refkit/provider-openverse": "0.3.2",
+    "@refkit/provider-poetrydb": "0.2.4",
+    "@refkit/provider-polyhaven": "0.2.3",
+    "@refkit/provider-rijksmuseum": "0.2.3",
+    "@refkit/provider-wikimedia-commons": "0.3.2"
   },
   "files": [
     "dist",
     "LICENSE"
   ],
+  "optionalDependencies": {
+    "@refkit/provider-brave": "0.2.4",
+    "@refkit/provider-europeana": "0.3.2",
+    "@refkit/provider-flickr": "0.3.2",
+    "@refkit/provider-freesound": "0.3.2",
+    "@refkit/provider-jamendo": "0.3.2",
+    "@refkit/provider-pexels": "0.2.4",
+    "@refkit/provider-pixabay": "0.2.4",
+    "@refkit/provider-smithsonian": "0.2.4",
+    "@refkit/provider-unsplash": "0.2.4"
+  },
   "scripts": {
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/dist/chunk-6JDNSEQM.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 { 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":[]}