@cyanheads/zenodo-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/search-records.tool.js

@@ -0,0 +1,531 @@
+/**
+ * @fileoverview zenodo_search_records — keyword search over Zenodo deposits with
+ * verified filters (resource type, community, funder, award, creator ORCID, file
+ * type, license, access status, publication date), returning manifest-free
+ * summaries plus facet counts over the full match set, every filter applied.
+ * @module mcp-server/tools/definitions/search-records
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { isValidOrcid, isWholeIdentifier, normalizeOrcid, ORCID_PATTERN, parseAwardRef, parseCommunityRef, parseFunderRef, } from '../../../services/zenodo/identifiers.js';
+import { ACCESS_STATUSES, expandPartialDate, hasUnpairedSlash, isValidPartialDate, SEARCH_SORTS, } from '../../../services/zenodo/query-builder.js';
+import { RESOURCE_TYPE_IDS, resolveResourceTypeId } from '../../../services/zenodo/resource-types.js';
+import { getZenodoService } from '../../../services/zenodo/zenodo-service.js';
+import { inline } from '../render.js';
+import { blankToUndefined, enumPreprocess, toOptionalArray } from '../schema-helpers.js';
+const RESULT_WINDOW = 10_000;
+const PARTIAL_DATE_PATTERN = /^\d{4}(-(0[1-9]|1[0-2])(-(0[1-9]|[12]\d|3[01]))?)?$/;
+/**
+ * Resource type preprocess: a lone string or array, each value resolved to its id
+ * (any case; `publication::publication-article` → `publication-article`). A value
+ * that names no resource type raises its own issue here rather than reaching the
+ * enum: the enum's issue would point at an array index a lone-string input never
+ * had, and read as a missing field.
+ */
+const resourceTypeInput = z.preprocess((v, ctx) => {
+    const arr = toOptionalArray(v);
+    if (!Array.isArray(arr))
+        return arr;
+    const unknown = arr.filter((x) => typeof x === 'string' && !resolveResourceTypeId(x));
+    if (unknown.length) {
+        ctx.addIssue({
+            code: 'custom',
+            input: v,
+            message: `${unknown.map((x) => JSON.stringify(x.slice(0, 100))).join(', ')} ${unknown.length > 1 ? 'are not Zenodo resource type ids' : 'is not a Zenodo resource type id'}. Expected one of: ${RESOURCE_TYPE_IDS.join(', ')} (a subtype may also be written <type>::<id>, e.g. publication::publication-article). Look types up with zenodo_lookup_vocabulary (vocabulary: resource_types).`,
+        });
+        return z.NEVER;
+    }
+    return arr.map((x) => (typeof x === 'string' ? (resolveResourceTypeId(x) ?? x) : x));
+}, z.array(z.enum(RESOURCE_TYPE_IDS)).max(10).optional());
+/** A lone string or array of strings, blanks dropped, each value lowercased with a leading `.` stripped (`.CSV` → `csv`). */
+const toFileTypes = (v) => {
+    const arr = toOptionalArray(v);
+    return Array.isArray(arr)
+        ? arr.map((x) => (typeof x === 'string' ? x.toLowerCase().replace(/^\./, '') : x))
+        : arr;
+};
+const lowerBlank = (v) => {
+    const b = blankToUndefined(v);
+    return typeof b === 'string' ? b.toLowerCase() : b;
+};
+const orcidBlank = (v) => {
+    const b = blankToUndefined(v);
+    return typeof b === 'string' ? normalizeOrcid(b) : b;
+};
+const dateField = (description) => z
+    .preprocess(blankToUndefined, z
+    .string()
+    .regex(PARTIAL_DATE_PATTERN, 'Expected YYYY, YYYY-MM, or YYYY-MM-DD.')
+    .refine(isValidPartialDate, 'Not a real calendar date.')
+    .optional())
+    .describe(description);
+const FacetSchema = z
+    .object({
+    id: z.string().describe('Facet value id; feeds the matching zenodo_search_records filter.'),
+    label: z.string().describe('Display label.'),
+    count: z.number().describe('Matching records with this value.'),
+})
+    .describe('One facet bucket.');
+const HitSchema = z
+    .object({
+    recid: z.string().describe('Record id of this version — pass to zenodo_get_record as id.'),
+    doi: z.string().optional().describe('DOI of this version; absent on some old records.'),
+    doi_provider: z
+        .string()
+        .optional()
+        .describe('datacite (minted by Zenodo) or external (publisher-minted).'),
+    concept_recid: z
+        .string()
+        .optional()
+        .describe('Concept record id naming the whole version series; absent if Zenodo omits it.'),
+    concept_doi: z
+        .string()
+        .optional()
+        .describe('Concept DOI of the version series; absent for external DOIs.'),
+    title: z.string().describe('Title as deposited.'),
+    publication_date: z
+        .string()
+        .optional()
+        .describe('Publication date (EDTF as given: 2026-09-11, 2020, 2020-05); absent when not recorded.'),
+    resource_type: z
+        .object({
+        id: z.string().describe('Resource type id, e.g. dataset or publication-article.'),
+        title: z.string().optional().describe('Resource type label, when Zenodo supplies one.'),
+    })
+        .optional()
+        .describe('Resource type; absent when not recorded.'),
+    version: z
+        .string()
+        .optional()
+        .describe('Version label as deposited; absent when the depositor set none.'),
+    is_latest: z
+        .boolean()
+        .optional()
+        .describe('True when this is the newest version; absent if Zenodo omits version data.'),
+    version_index: z
+        .number()
+        .optional()
+        .describe('Position of this version in its series (1 = first); absent if Zenodo omits version data.'),
+    creators: z
+        .array(z
+        .object({
+        name: z.string().describe('Creator name as deposited.'),
+        orcid: z.string().optional().describe('Creator ORCID iD, when supplied.'),
+    })
+        .describe('One creator.'))
+        .describe('First 5 creators.'),
+    creator_count: z.number().describe('Total creators.'),
+    license_ids: z
+        .array(z.string())
+        .describe('License ids (custom rights without an id are omitted; see zenodo_get_record).'),
+    access: z
+        .object({
+        status: z
+            .string()
+            .describe('open, restricted, embargoed, or metadata-only (unknown if Zenodo omits it).'),
+        files: z
+            .string()
+            .optional()
+            .describe('File access: public or restricted; absent when not reported.'),
+        embargo_until: z.string().optional().describe('Embargo end date, when active.'),
+    })
+        .describe('Access status.'),
+    communities: z.array(z.string()).describe('First 5 community slugs holding this record.'),
+    file_count: z
+        .number()
+        .optional()
+        .describe('Number of files; absent when files are restricted or embargoed.'),
+    total_bytes: z
+        .number()
+        .optional()
+        .describe('Total file size in bytes; absent when files are restricted or embargoed.'),
+    views: z
+        .number()
+        .optional()
+        .describe('Unique views across all versions; absent when Zenodo reports no usage counts.'),
+    downloads: z
+        .number()
+        .optional()
+        .describe('Unique downloads across all versions; absent when Zenodo reports no usage counts.'),
+    description_snippet: z
+        .string()
+        .optional()
+        .describe('First ~280 characters of the plain-text description; absent when the record has none.'),
+    zenodo_url: z.string().describe('Record landing page on zenodo.org.'),
+})
+    .describe('One matching deposit.');
+export const searchRecords = tool('zenodo_search_records', {
+    title: 'Search Zenodo records',
+    description: 'Search Zenodo\'s open research repository — datasets, software releases, publications, and other deposits — by keyword query plus filters for resource type, community, funder, grant, creator ORCID, file type, license, access status, and publication date. Returns one summary per deposit (ids, DOIs, title, type, version, creators, license, access, file totals, usage counts) plus facet counts over the full match set, every filter applied. Query terms are OR-ed unless joined with AND, quoted phrases match exactly, and field syntax works on record fields (metadata.title:"…", metadata.subjects.subject:"…"). Only the latest version of each deposit is searched unless all_versions is true, and only the first 10,000 matches are reachable by paging. Resolve community, funder, and grant names to ids with zenodo_lookup_vocabulary first; open one deposit in full with zenodo_get_record.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        query: z
+            .preprocess(blankToUndefined, z.string().max(1000).optional())
+            .describe('Keyword query. Terms are OR-ed unless joined with AND; "quoted phrases" match exactly; field syntax such as metadata.title:"…" or doi:"10.5281/zenodo.N" works. Escape a literal / as \\/. A bare DOI or record URL is rejected; open it with zenodo_get_record instead. Omit to browse with filters only.'),
+        resource_type: resourceTypeInput.describe('Resource type ids, OR-ed (a single string is accepted): dataset, software, publication, publication-article, image-photo, … Any case; a subtype may also be written in the <type>::<id> form zenodo_lookup_vocabulary shows as its search value (publication::publication-article). A top-level type includes its subtypes. Look ids up with zenodo_lookup_vocabulary (vocabulary: resource_types).'),
+        community: z
+            .preprocess(blankToUndefined, z.string().max(200).optional())
+            .describe('One community: its slug, UUID, or zenodo.org/communities/<slug> URL. Find slugs with zenodo_lookup_vocabulary (vocabulary: communities).'),
+        funder: z
+            .preprocess(blankToUndefined, z.string().max(200).optional())
+            .describe('One funder: a ROR id (01cwqze88), a ROR URL, or a Crossref Funder DOI (10.13039/100000002). Resolve a funder name with zenodo_lookup_vocabulary (vocabulary: funders).'),
+        award: z
+            .preprocess(blankToUndefined, z.string().max(200).optional())
+            .describe('One grant: an award id <funder-ror>::<number> (00k4n6c32::101135562), a bare grant number, or a CORDIS award DOI (10.3030/101135562). Find ids with zenodo_lookup_vocabulary (vocabulary: awards).'),
+        creator_orcid: z
+            .preprocess(orcidBlank, z
+            .string()
+            .regex(ORCID_PATTERN, 'Expected an ORCID iD such as 0000-0002-1825-0097.')
+            .refine(isValidOrcid, 'ORCID iD check digit does not match.')
+            .optional())
+            .describe('Creator ORCID iD, e.g. 0000-0002-1825-0097; an https://orcid.org/ prefix is stripped and a trailing x uppercased.'),
+        file_type: z
+            .preprocess(toFileTypes, z
+            .array(z
+            .string()
+            .regex(/^[a-z0-9]{1,16}$/, 'Expected a file extension such as csv or zip.')
+            .describe('A file extension, e.g. csv.'))
+            .max(10)
+            .optional())
+            .describe('File extensions, OR-ed (a single string is accepted): csv, zip, pdf, … Lowercased with any leading dot stripped.'),
+        license: z
+            .preprocess(lowerBlank, z
+            .string()
+            .regex(/^[a-z0-9][a-z0-9.+-]{0,63}$/, 'Expected a license id such as cc-by-4.0 or mit.')
+            .optional())
+            .describe('License id, e.g. cc-by-4.0, cc0-1.0, mit (lowercased). Find ids with zenodo_lookup_vocabulary (vocabulary: licenses).'),
+        access_status: z
+            .preprocess(enumPreprocess(ACCESS_STATUSES), z.enum(ACCESS_STATUSES).optional())
+            .describe('Access status: open, restricted, embargoed, or metadata-only. Case, spaces, hyphens, and underscores are ignored when matching (Metadata Only reads as metadata-only).'),
+        published_from: dateField('Earliest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date starts at its first day.'),
+        published_to: dateField('Latest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date ends at its last day.'),
+        all_versions: z
+            .boolean()
+            .default(false)
+            .describe('Include superseded versions; by default only the latest version is searched.'),
+        sort: z
+            .preprocess(enumPreprocess(SEARCH_SORTS), z.enum(SEARCH_SORTS).optional())
+            .describe('Sort order: bestmatch, newest, oldest, mostviewed, mostdownloaded, updated-desc, updated-asc. Case, spaces, hyphens, and underscores are ignored when matching (MostViewed reads as mostviewed). Defaults to bestmatch with a query, newest without.'),
+        page: z
+            .number()
+            .int()
+            .min(1)
+            .default(1)
+            .describe('Result page, starting at 1. page × size may not exceed 10,000.'),
+        size: z.number().int().min(1).max(25).default(10).describe('Results per page (1–25).'),
+    }),
+    output: z.object({
+        total: z.number().describe('Exact number of matching records.'),
+        reachable: z.number().describe('Matches reachable by paging: min(total, 10,000).'),
+        page: z.number().describe('Page returned.'),
+        size: z.number().describe('Page size applied.'),
+        has_more: z.boolean().describe('True when another reachable page follows.'),
+        next_page: z.number().optional().describe('The next page number, when has_more.'),
+        hits: z.array(HitSchema).describe('Matching deposits on this page.'),
+        facets: z
+            .object({
+            resource_type: z
+                .array(FacetSchema.extend({
+                subtypes: z
+                    .array(FacetSchema)
+                    .optional()
+                    .describe('Top 5 subtypes of this resource type.'),
+            }).describe('One resource type bucket.'))
+                .describe('Top 10 resource types; ids feed resource_type.'),
+            access_status: z.array(FacetSchema).describe('Access status buckets.'),
+            file_type: z.array(FacetSchema).describe('Top 10 file types; ids feed file_type.'),
+            subject: z
+                .array(z
+                .object({
+                label: z.string().describe('Subject keyword.'),
+                count: z.number().describe('Matching records with this subject.'),
+            })
+                .describe('One subject bucket.'))
+                .describe('Top 10 subjects; query them as metadata.subjects.subject:"<label>".'),
+            publication_year: z
+                .array(z
+                .object({
+                year: z.string().describe('Publication year.'),
+                count: z.number().describe('Matching records published that year.'),
+            })
+                .describe('One year bucket.'))
+                .describe('The 10 most recent publication years present.'),
+        })
+            .describe('Facet counts over the full match set (every filter applied, so they agree with total), not just this page.'),
+    }),
+    enrichment: {
+        truncated: z.boolean().describe('True when more reachable matches follow this page.'),
+        shown: z.number().describe('Hits returned on this page.'),
+        cap: z.number().describe('Page size applied.'),
+        totalCount: z.number().describe('Exact number of matching records.'),
+        effectiveQuery: z.string().optional().describe('The exact q sent to Zenodo.'),
+        appliedSort: z.enum(SEARCH_SORTS).describe('The sort order applied.'),
+        allVersions: z.boolean().describe('Whether superseded versions were searched.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance on empty results, the 10,000-result window, or further pages.'),
+    },
+    errors: [
+        {
+            reason: 'query_is_identifier',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'The query is a single DOI, doi.org URL, or zenodo.org record URL',
+            recovery: 'Pass this identifier to zenodo_get_record as id instead of searching for it.',
+        },
+        {
+            reason: 'query_syntax',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'The query has an unpaired unescaped / outside quotes',
+            recovery: 'Escape the slash as \\/ or wrap that term in double quotes, then call zenodo_search_records again.',
+        },
+        {
+            reason: 'query_failed',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Zenodo answered HTTP 500 for a query that passed the local checks',
+            retryable: false,
+            thrownBy: 'service',
+            recovery: 'Simplify the query (quote phrases, escape : and / with a backslash, or move identifiers into the dedicated filters) and call zenodo_search_records again; if a plain keyword query also fails, Zenodo is degraded, so retry in a few minutes.',
+        },
+        {
+            reason: 'upstream_timeout',
+            code: JsonRpcErrorCode.Timeout,
+            when: 'The search attempt got no complete response within its time budget',
+            retryable: false,
+            thrownBy: 'service',
+            recovery: 'Call zenodo_search_records again with a smaller size (5) or narrower filters so the page holds fewer large deposits.',
+        },
+        {
+            reason: 'unknown_community',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'community resolves to no Zenodo community',
+            recovery: 'Find the community’s slug with zenodo_lookup_vocabulary (vocabulary: communities), then pass it as community.',
+        },
+        {
+            reason: 'unknown_funder',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'funder is not a known ROR id and no funder carries that Crossref Funder DOI',
+            recovery: 'Resolve the funder with zenodo_lookup_vocabulary (vocabulary: funders) and pass the returned ROR id as funder.',
+        },
+        {
+            reason: 'invalid_date_range',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'The expanded published_from is after published_to',
+            recovery: 'Set published_from to a date on or before published_to and call zenodo_search_records again.',
+        },
+        {
+            reason: 'result_window_exceeded',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'page × size exceeds 10,000',
+            recovery: 'Zenodo serves only the first 10,000 matches; add filters or a published_from/published_to range to zenodo_search_records instead of paging deeper.',
+        },
+        {
+            reason: 'rate_limited',
+            code: JsonRpcErrorCode.RateLimited,
+            when: "Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window",
+            retryable: true,
+            thrownBy: 'service',
+            recovery: 'Wait for the retryAfter seconds in the error data, then call zenodo_search_records again with the same arguments.',
+        },
+    ],
+    async handler(input, ctx) {
+        const sort = input.sort ?? (input.query ? 'bestmatch' : 'newest');
+        ctx.enrich({
+            truncated: false,
+            shown: 0,
+            cap: input.size,
+            totalCount: 0,
+            appliedSort: sort,
+            allVersions: input.all_versions,
+        });
+        if (input.page * input.size > RESULT_WINDOW) {
+            throw ctx.fail('result_window_exceeded', `page ${input.page} × size ${input.size} is past the first ${RESULT_WINDOW.toLocaleString('en-US')} matches.`, ctx.recoveryFor('result_window_exceeded'));
+        }
+        if (input.query && isWholeIdentifier(input.query)) {
+            throw ctx.fail('query_is_identifier', `The query "${inline(input.query)}" is a record identifier, not search terms.`, ctx.recoveryFor('query_is_identifier'));
+        }
+        if (input.query && hasUnpairedSlash(input.query)) {
+            throw ctx.fail('query_syntax', 'The query has an unpaired / outside quotes, which Zenodo parses as an unterminated regular expression.', ctx.recoveryFor('query_syntax'));
+        }
+        const publishedFrom = input.published_from
+            ? expandPartialDate(input.published_from, 'from')
+            : undefined;
+        const publishedTo = input.published_to
+            ? expandPartialDate(input.published_to, 'to')
+            : undefined;
+        if (publishedFrom && publishedTo && publishedFrom > publishedTo) {
+            throw ctx.fail('invalid_date_range', `published_from ${publishedFrom} is after published_to ${publishedTo}.`, ctx.recoveryFor('invalid_date_range'));
+        }
+        const service = getZenodoService();
+        let communityId;
+        if (input.community) {
+            const ref = parseCommunityRef(input.community);
+            const community = ref ? await service.getCommunity(ref, ctx) : undefined;
+            if (!community) {
+                throw ctx.fail('unknown_community', `No Zenodo community matches "${inline(input.community)}" as a slug, UUID, or community URL.`, ctx.recoveryFor('unknown_community'));
+            }
+            communityId = community.uuid;
+        }
+        let funderRor;
+        if (input.funder) {
+            const ref = parseFunderRef(input.funder);
+            const funder = ref ? await service.resolveFunder(ref, ctx) : undefined;
+            if (!funder) {
+                throw ctx.fail('unknown_funder', `"${inline(input.funder)}" is not a known ROR id and no funder carries that Crossref Funder DOI.`, ctx.recoveryFor('unknown_funder'));
+            }
+            funderRor = funder.ror_id;
+        }
+        const filters = {
+            allVersions: input.all_versions,
+            page: input.page,
+            size: input.size,
+            sort,
+            ...(input.query ? { query: input.query } : {}),
+            ...(input.resource_type ? { resourceTypes: input.resource_type } : {}),
+            ...(input.file_type ? { fileTypes: input.file_type } : {}),
+            ...(input.access_status ? { accessStatus: input.access_status } : {}),
+            ...(communityId ? { communityId } : {}),
+            ...(funderRor ? { funderRor } : {}),
+            ...(input.award ? { award: parseAwardRef(input.award) } : {}),
+            ...(input.creator_orcid ? { creatorOrcid: input.creator_orcid } : {}),
+            ...(input.license ? { license: input.license } : {}),
+            ...(publishedFrom ? { publishedFrom } : {}),
+            ...(publishedTo ? { publishedTo } : {}),
+        };
+        const result = await service.searchRecords(filters, ctx);
+        const total = result.total;
+        const reachable = Math.min(total, RESULT_WINDOW);
+        const hasMore = input.page * input.size < reachable;
+        ctx.enrich({ shown: result.hits.length });
+        ctx.enrich.total(total);
+        if (result.q)
+            ctx.enrich.echo(result.q);
+        const notice = [];
+        if (total === 0) {
+            notice.push('No records matched.');
+            const narrowing = [
+                ['resource_type', input.resource_type],
+                ['file_type', input.file_type],
+                ['access_status', input.access_status],
+                ['license', input.license],
+            ]
+                .filter(([, v]) => v !== undefined)
+                .map(([name]) => name);
+            if (narrowing.length) {
+                notice.push(narrowing.length === 1
+                    ? `The ${narrowing[0]} filter narrows the set; drop it and call zenodo_search_records again.`
+                    : `The ${narrowing.join(', ')} filters narrow the set; drop one and call zenodo_search_records again.`);
+            }
+            const ids = [
+                ['community', input.community],
+                ['funder', input.funder],
+                ['award', input.award],
+            ]
+                .filter(([, v]) => v !== undefined)
+                .map(([name]) => name);
+            if (ids.length) {
+                notice.push(`Check the ${ids.join(', ')} id${ids.length > 1 ? 's' : ''} with zenodo_lookup_vocabulary.`);
+            }
+            if (!input.all_versions) {
+                notice.push('Only the latest version of each deposit is searched; set all_versions to true to include superseded versions.');
+            }
+            if (input.query && /\bAND\b|"/.test(input.query)) {
+                notice.push('Terms joined by AND must all match and quoted phrases must match exactly; loosen the query.');
+            }
+            if (input.published_from || input.published_to) {
+                notice.push('Widen or drop published_from/published_to.');
+            }
+        }
+        else if (result.hits.length === 0) {
+            const last = Math.max(1, Math.ceil(reachable / input.size));
+            notice.push(`Page ${input.page} is past the last page (${last}); call again with page ${last} or lower.`);
+        }
+        if (total > RESULT_WINDOW) {
+            notice.push(`Only the first 10,000 of ${total.toLocaleString('en-US')} matches are reachable; add filters or a date range, or change sort.`);
+        }
+        if (hasMore) {
+            notice.push(`Showing ${result.hits.length} of ${reachable.toLocaleString('en-US')}; call again with page ${input.page + 1}.`);
+            ctx.enrich.truncated({
+                shown: result.hits.length,
+                cap: input.size,
+                guidance: notice.join(' '),
+            });
+        }
+        else if (notice.length) {
+            ctx.enrich.notice(notice.join(' '));
+        }
+        return {
+            total,
+            reachable,
+            page: input.page,
+            size: input.size,
+            has_more: hasMore,
+            ...(hasMore ? { next_page: input.page + 1 } : {}),
+            hits: result.hits,
+            facets: result.facets,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Zenodo search: ${result.total} matches (${result.reachable} reachable)`,
+            `**Page:** ${result.page} | **Size:** ${result.size} | **Has more:** ${result.has_more}${result.next_page !== undefined ? ` | **Next page:** ${result.next_page}` : ''}`,
+        ];
+        for (const h of result.hits) {
+            lines.push('', `### ${inline(h.title)}`);
+            lines.push(`**Record:** ${h.recid}${h.concept_recid ? ` | **Concept record:** ${h.concept_recid}` : ''} | **URL:** ${h.zenodo_url}`);
+            const ids = [
+                h.doi
+                    ? `**DOI:** ${inline(h.doi)}${h.doi_provider ? ` (${inline(h.doi_provider)})` : ''}`
+                    : undefined,
+                h.concept_doi ? `**Concept DOI:** ${inline(h.concept_doi)}` : undefined,
+            ].filter(Boolean);
+            if (ids.length)
+                lines.push(ids.join(' | '));
+            const facts = [
+                h.resource_type
+                    ? `**Type:** ${h.resource_type.title ? `${inline(h.resource_type.title)} ` : ''}(${inline(h.resource_type.id)})`
+                    : undefined,
+                h.publication_date ? `**Published:** ${inline(h.publication_date)}` : undefined,
+                h.version ? `**Version:** ${inline(h.version)}` : undefined,
+                h.version_index !== undefined ? `**Version index:** ${h.version_index}` : undefined,
+                h.is_latest !== undefined ? `**Latest:** ${h.is_latest}` : undefined,
+            ].filter(Boolean);
+            if (facts.length)
+                lines.push(facts.join(' | '));
+            const creators = h.creators
+                .map((c) => `${inline(c.name)}${c.orcid ? ` (ORCID ${inline(c.orcid)})` : ''}`)
+                .join('; ');
+            lines.push(`**Creators (${h.creator_count}):** ${creators || 'none listed'}${h.creator_count > h.creators.length ? '; …' : ''}`);
+            lines.push(`**Access:** ${inline(h.access.status)}${h.access.files ? `, files ${inline(h.access.files)}` : ''}${h.access.embargo_until ? `, embargoed until ${inline(h.access.embargo_until)}` : ''} | **Licenses:** ${h.license_ids.length ? h.license_ids.map(inline).join(', ') : 'none with an id'}`);
+            lines.push(`**Files:** ${h.file_count ?? 'not disclosed'} (${h.total_bytes ?? 'not disclosed'} bytes) | **Views:** ${h.views ?? 'not available'} | **Downloads:** ${h.downloads ?? 'not available'}`);
+            if (h.communities.length)
+                lines.push(`**Communities:** ${h.communities.map(inline).join(', ')}`);
+            if (h.description_snippet)
+                lines.push(`**Snippet:** ${inline(h.description_snippet)}`);
+        }
+        const f = result.facets;
+        const bucketList = (buckets) => buckets.map((b) => `${inline(b.label)} \`${inline(b.id)}\` (${b.count})`).join('; ');
+        const facetsHeading = '### Facets (full match set, every filter applied)';
+        lines.push('', facetsHeading);
+        if (f.resource_type.length) {
+            lines.push('**Resource types:**');
+            for (const b of f.resource_type) {
+                lines.push(`- ${inline(b.label)} \`${inline(b.id)}\` (${b.count})${b.subtypes?.length ? ` — ${bucketList(b.subtypes)}` : ''}`);
+            }
+        }
+        if (f.access_status.length)
+            lines.push(`**Access status:** ${bucketList(f.access_status)}`);
+        if (f.file_type.length)
+            lines.push(`**File types:** ${bucketList(f.file_type)}`);
+        if (f.subject.length) {
+            lines.push(`**Subjects:** ${f.subject.map((s) => `${inline(s.label)} (${s.count})`).join('; ')}`);
+        }
+        if (f.publication_year.length) {
+            lines.push(`**Publication years:** ${f.publication_year.map((y) => `${inline(y.year)} (${y.count})`).join('; ')}`);
+        }
+        if (lines.at(-1) === facetsHeading)
+            lines.push('No facet counts (nothing matched).');
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-records.tool.js.map

package/dist/mcp-server/tools/definitions/search-records.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-records.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-records.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/record-miss.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview The `found: false` outcome zenodo_get_record and zenodo_list_versions
+ * share: the removal-tombstone schema and the `miss_kind` + guidance for each way an
+ * id can fail to resolve, so both tools describe a miss identically.
+ * @module mcp-server/tools/record-miss
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import type { RecordLookup } from '../../services/zenodo/types.js';
+/** Output schema of a deleted record's removal tombstone. */
+export declare const TombstoneSchema: z.ZodObject<{
+    removal_date: z.ZodOptional<z.ZodString>;
+    removal_reason: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    citation_text: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** `miss_kind`, guidance, and (for a deleted record) the tombstone of a record GET that found nothing. */
+export declare function recordMiss(recid: string, lookup: Exclude<RecordLookup, {
+    status: 'found';
+}>): {
+    miss_kind: 'not_found';
+    guidance: string;
+    tombstone?: never;
+} | {
+    miss_kind: 'deleted';
+    guidance: string;
+    tombstone: import("../../services/zenodo/types.js").Tombstone;
+} | {
+    tombstone?: never;
+    miss_kind: 'restricted';
+    guidance: string;
+};
+/** `miss_kind` and guidance for a non-Zenodo DOI that no Zenodo record carries. */
+export declare function notOnZenodoMiss(doi: string): {
+    miss_kind: 'not_on_zenodo';
+    guidance: string;
+};
+//# sourceMappingURL=record-miss.d.ts.map

package/dist/mcp-server/tools/record-miss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-miss.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/record-miss.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,6DAA6D;AAC7D,eAAO,MAAM,eAAe;;;;;iBAYyB,CAAC;AAEtD,0GAA0G;AAC1G,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;eAIzE,WAAW;;;;eAOX,SAAS;;;;;eAOT,YAAY;;EAI9B;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM;IAEvC,SAAS,EAAE,eAAe;IAC1B,QAAQ;EAEX"}