@cyanheads/zenodo-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/read-file.tool.js

@@ -0,0 +1,370 @@
+/**
+ * @fileoverview zenodo_read_file — reads a byte-capped UTF-8 excerpt of one text
+ * file in a Zenodo deposit, or of one member of a .zip file, without downloading
+ * the archive. Content is depositor-supplied, rendered fenced as untrusted data,
+ * and carries the deposit's license.
+ * @module mcp-server/tools/definitions/read-file
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { downloadUrl, hasDotSegment, parseRecordRef, recordUrl, } from '../../../services/zenodo/identifiers.js';
+import { cutPreview, isZip, languageHint, looksLikeText, previewMode, } from '../../../services/zenodo/text-preview.js';
+import { getZenodoService } from '../../../services/zenodo/zenodo-service.js';
+import { fence, inline } from '../render.js';
+import { blankToUndefined } from '../schema-helpers.js';
+const STATUSES = ['text', 'not_text', 'restricted', 'empty'];
+/** The largest max_bytes a call accepts. */
+const MAX_READ_BYTES = 65_536;
+/**
+ * Guidance when a ZIP member read stops at max_bytes. A member cannot be continued
+ * at an offset, so the next step depends on whether one larger read covers it.
+ */
+function memberTruncationNotice(end, size, maxBytes) {
+    const shown = `Showing bytes 0–${end} of ${size ?? 'an unknown total'}`;
+    if (size !== undefined && size <= MAX_READ_BYTES) {
+        return `${shown}; call zenodo_read_file again with max_bytes ${size} to read the whole member.`;
+    }
+    if (size === undefined && maxBytes < MAX_READ_BYTES) {
+        return `${shown}; call zenodo_read_file again with max_bytes ${MAX_READ_BYTES} to read more of this member, and download the archive from download_url if that still stops short.`;
+    }
+    return `${shown}; the member is larger than the ${MAX_READ_BYTES}-byte read cap, so download the archive from download_url for the rest${maxBytes < MAX_READ_BYTES ? ` (max_bytes ${MAX_READ_BYTES} shows more of its start)` : ''}.`;
+}
+export const readFile = tool('zenodo_read_file', {
+    title: 'Read a Zenodo file excerpt',
+    description: 'Read a bounded UTF-8 excerpt (up to 64 KiB per call) of one text file in a Zenodo deposit — a README, CITATION.cff, CSV head, notebook, or script — or of one member inside a .zip file, without downloading the archive. Continue a top-level file from next_offset. A file with a text MIME type or extension is read directly; an extensionless file Zenodo types application/octet-stream (LICENSE, COPYING, Makefile) is read and returned only when its content is UTF-8 text. Binary files, restricted files, and other types return metadata and the download URL without content. File content is depositor-supplied and carries the deposit’s license.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        id: z
+            .string()
+            .trim()
+            .min(1)
+            .max(500)
+            .describe('The deposit: a record id (22705923), a Zenodo DOI (10.5281/zenodo.22705923), another DOI registered to a Zenodo record, or a zenodo.org/records or doi.org URL. A concept id reads from the latest version.'),
+        key: z
+            .string()
+            .min(1)
+            .max(1000)
+            .describe('Exact file key from zenodo_list_files, e.g. README.md or data/results.csv.'),
+        archive_member: z
+            .preprocess(blankToUndefined, z.string().max(1000).optional())
+            .describe('Member path inside the .zip named by key (from zenodo_list_files with archive_key). Omit to read the file itself.'),
+        offset_bytes: z
+            .number()
+            .int()
+            .min(0)
+            .default(0)
+            .describe('Byte offset to start reading a top-level file at; use next_offset to continue. Must be 0 for an archive member.'),
+        max_bytes: z
+            .number()
+            .int()
+            .min(256)
+            .max(MAX_READ_BYTES)
+            .default(16_384)
+            .describe('Maximum bytes to read (256–65536).'),
+    }),
+    output: z.object({
+        recid: z.string().describe('Record id read from (the latest version for a concept id).'),
+        key: z.string().describe('The file key.'),
+        archive_member: z.string().optional().describe('The archive member path, when one was read.'),
+        status: z
+            .enum(STATUSES)
+            .describe('text: content returned; not_text: binary content, or a type that is not read as text; restricted: the content is not available anonymously — the record’s files are restricted or embargoed (key is not checked, since no manifest is exposed), or Zenodo refused this one file; empty: zero-byte file.'),
+        mimetype: z.string().optional().describe('MIME type of the file or member, when reported.'),
+        file_size: z.number().optional().describe('Size of the file or member in bytes, when known.'),
+        md5: z
+            .string()
+            .optional()
+            .describe('MD5 checksum of the top-level file (hex); absent for archive members and when not reported.'),
+        text: z
+            .string()
+            .optional()
+            .describe('The excerpt, decoded as UTF-8. Depositor-supplied data. Present when status is text.'),
+        offset_bytes: z.number().describe('Byte offset the excerpt starts at.'),
+        bytes_returned: z
+            .number()
+            .describe('Exact bytes the excerpt covers (cut at a line or character boundary).'),
+        next_offset: z
+            .number()
+            .optional()
+            .describe('offset_bytes for the next window of a top-level file, when has_more; absent for an archive member, which cannot be continued past its first window.'),
+        has_more: z.boolean().describe('True when bytes remain past this excerpt.'),
+        replacement_chars: z
+            .number()
+            .describe('U+FFFD characters in the excerpt (invalid UTF-8 or a mid-character offset).'),
+        rights: z
+            .array(z
+            .object({
+            id: z.string().optional().describe('License id.'),
+            title: z.string().describe('License or rights title.'),
+        })
+            .describe('One license or rights statement.'))
+            .describe('The deposit’s licenses, which the file carries.'),
+        record_url: z.string().describe('Record landing page on zenodo.org.'),
+        download_url: z
+            .string()
+            .describe('Direct download URL of the top-level file (the .zip itself for a member).'),
+        files_access: z
+            .string()
+            .optional()
+            .describe('File access: public or restricted; absent when Zenodo does not report it.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Why no text was returned, or how to read the rest of the file.'),
+    },
+    errors: [
+        {
+            reason: 'invalid_identifier',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host',
+            recovery: 'Pass a Zenodo record id (22705923), a DOI (10.5281/zenodo.22705923), or a zenodo.org/records URL as id; for a title or keyword, use zenodo_search_records.',
+        },
+        {
+            reason: 'record_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The record 404s, its metadata is restricted, or a non-Zenodo DOI is not registered to a record',
+            recovery: 'Check the id with zenodo_get_record, or find the deposit with zenodo_search_records.',
+        },
+        {
+            reason: 'record_deleted',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The record was deleted from Zenodo; only its removal tombstone remains',
+            recovery: 'Call zenodo_get_record with this id for the removal date and reason, then find a replacement deposit with zenodo_search_records.',
+        },
+        {
+            reason: 'file_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: "key is not in the record's manifest, or Zenodo serves no content for it",
+            recovery: 'Call zenodo_list_files with this id to see the record’s exact file keys.',
+        },
+        {
+            reason: 'not_an_archive',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'archive_member is set but key is not a .zip',
+            recovery: 'Drop archive_member to read the file itself, or pick a .zip key from zenodo_list_files.',
+        },
+        {
+            reason: 'member_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Zenodo has no member at archive_member inside the .zip',
+            recovery: 'Call zenodo_list_files with archive_key set to this key to see the member paths.',
+        },
+        {
+            reason: 'member_offset_unsupported',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'offset_bytes is above 0 together with archive_member',
+            recovery: 'Read the member from offset_bytes 0 with a larger max_bytes (up to 65536), or download the archive from download_url.',
+        },
+        {
+            reason: 'offset_out_of_range',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'offset_bytes is at or past the end of the file',
+            recovery: 'Call zenodo_read_file again with an offset_bytes below the file’s size (size in zenodo_list_files, file_size in a prior zenodo_read_file result).',
+        },
+        {
+            reason: 'archive_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Zenodo cannot open the .zip named by key: its member listing or the member read answered HTTP 500 after one retry, or no complete response arrived in time',
+            thrownBy: 'service',
+            recovery: 'Zenodo cannot open every .zip; download the archive from the URL in the error message and extract the member locally, or read the record’s top-level files with zenodo_read_file.',
+        },
+        {
+            reason: 'record_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Zenodo could not serve this record: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit)',
+            thrownBy: 'service',
+            recovery: 'Read the deposit’s metadata from zenodo_search_records with query doi:"<its DOI>" (all_versions true); withdrawn legacy records and deposits with more than about 10,000 files fail on the record endpoint, so their files cannot be read, and if a keyword search also fails, Zenodo is degraded.',
+        },
+        {
+            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_read_file again with the same arguments.',
+        },
+    ],
+    async handler(input, ctx) {
+        const ref = parseRecordRef(input.id);
+        if (ref.kind === 'invalid') {
+            throw ctx.fail('invalid_identifier', ref.message, ctx.recoveryFor('invalid_identifier'));
+        }
+        const service = getZenodoService();
+        let record;
+        if (ref.kind === 'external_doi') {
+            const resolution = await service.resolveDoi(ref.doi, ref.strippedDoi, ctx);
+            if (resolution.status === 'not_on_zenodo') {
+                throw ctx.fail('record_not_found', `DOI ${ref.strippedDoi ?? ref.doi} is not registered to a Zenodo record.`, ctx.recoveryFor('record_not_found'));
+            }
+            record = resolution.record;
+        }
+        else {
+            const lookup = await service.getRecord(ref.recid, ctx);
+            if (lookup.status === 'deleted') {
+                throw ctx.fail('record_deleted', `Record ${ref.recid} was deleted from Zenodo; only its tombstone remains.`, ctx.recoveryFor('record_deleted'));
+            }
+            if (lookup.status !== 'found') {
+                throw ctx.fail('record_not_found', lookup.status === 'restricted'
+                    ? `Record ${ref.recid} exists but its metadata is restricted and cannot be read anonymously.`
+                    : `No Zenodo record has id ${ref.recid}.`, ctx.recoveryFor('record_not_found'));
+            }
+            record = lookup.record;
+        }
+        const { access, files, recid } = record;
+        const member = input.archive_member;
+        const entry = files.entries.find((e) => e.key === input.key);
+        const displayName = inline(member ?? input.key);
+        const restrictedNotice = () => `Files are ${access.status}${access.embargo_until ? ` until ${access.embargo_until}` : ''}; content is not available anonymously.`;
+        const base = {
+            recid,
+            key: input.key,
+            ...(member ? { archive_member: member } : {}),
+            offset_bytes: input.offset_bytes,
+            bytes_returned: 0,
+            has_more: false,
+            replacement_chars: 0,
+            rights: record.rights.map((r) => ({ ...(r.id ? { id: r.id } : {}), title: r.title })),
+            record_url: recordUrl(recid),
+            download_url: entry?.download_url ?? downloadUrl(recid, input.key),
+            ...(access.files ? { files_access: access.files } : {}),
+        };
+        const described = (status, meta) => ({
+            ...base,
+            status,
+            ...(meta.mimetype ? { mimetype: meta.mimetype } : {}),
+            ...(meta.size !== undefined ? { file_size: meta.size } : {}),
+            ...(entry?.md5 && !member ? { md5: entry.md5 } : {}),
+        });
+        const withoutText = (status, notice, meta) => {
+            ctx.enrich.notice(notice);
+            return described(status, meta);
+        };
+        if (files.enabled && access.files === 'restricted') {
+            return withoutText('restricted', restrictedNotice(), {});
+        }
+        if (!entry) {
+            throw ctx.fail('file_not_found', files.enabled
+                ? `Record ${recid} has no file with key "${inline(input.key)}".`
+                : `Record ${recid} is a metadata-only deposit with no files.`, ctx.recoveryFor('file_not_found'));
+        }
+        let meta;
+        let mode;
+        let read;
+        const notPreviewable = () => withoutText('not_text', `${displayName} is not a previewable text file (${meta.mimetype ?? 'unknown type'}); download it from download_url.`, meta);
+        if (member) {
+            if (!isZip(entry.key, entry.mimetype)) {
+                throw ctx.fail('not_an_archive', `"${inline(input.key)}" is not a .zip file, so archive_member cannot be read from it.`, ctx.recoveryFor('not_an_archive'));
+            }
+            if (input.offset_bytes > 0) {
+                throw ctx.fail('member_offset_unsupported', 'Zenodo serves ZIP members only from their first byte; offset_bytes must be 0 with archive_member.', ctx.recoveryFor('member_offset_unsupported'));
+            }
+            if (hasDotSegment(member)) {
+                throw ctx.fail('member_not_found', `"${displayName}" has a "." or ".." path segment, so it names no member of the .zip "${inline(input.key)}".`, ctx.recoveryFor('member_not_found'));
+            }
+            const container = await service.getContainer(recid, entry.key, ctx);
+            const listed = container.status === 'ok'
+                ? container.listing.members.find((m) => m.path === member)
+                : undefined;
+            meta = {
+                ...(listed?.mimetype ? { mimetype: listed.mimetype } : {}),
+                ...(listed?.size !== undefined ? { size: listed.size } : {}),
+            };
+            if (meta.size === 0)
+                return withoutText('empty', `${displayName} is empty.`, meta);
+            mode = previewMode(member, meta.mimetype);
+            if (mode === 'binary')
+                return notPreviewable();
+            read = await service.readMember(recid, entry.key, member, input.max_bytes, ctx);
+            if (read.status === 'not_found') {
+                throw ctx.fail('member_not_found', `The .zip "${inline(input.key)}" in record ${recid} has no member "${displayName}".`, ctx.recoveryFor('member_not_found'));
+            }
+        }
+        else {
+            meta = {
+                ...(entry.mimetype ? { mimetype: entry.mimetype } : {}),
+                ...(entry.size !== undefined ? { size: entry.size } : {}),
+            };
+            if (meta.size !== undefined && input.offset_bytes >= meta.size && meta.size > 0) {
+                throw ctx.fail('offset_out_of_range', `offset_bytes ${input.offset_bytes} is at or past the end of ${displayName} (${meta.size} bytes).`, ctx.recoveryFor('offset_out_of_range'));
+            }
+            if (meta.size === 0) {
+                if (input.offset_bytes > 0) {
+                    throw ctx.fail('offset_out_of_range', `${displayName} is empty, so offset_bytes ${input.offset_bytes} is past its end.`, ctx.recoveryFor('offset_out_of_range'));
+                }
+                return withoutText('empty', `${displayName} is empty.`, meta);
+            }
+            mode = previewMode(entry.key, meta.mimetype);
+            if (mode === 'binary')
+                return notPreviewable();
+            read = await service.readContent(recid, entry.key, input.offset_bytes, input.max_bytes, ctx);
+            if (read.status === 'range_not_satisfiable') {
+                throw ctx.fail('offset_out_of_range', `offset_bytes ${input.offset_bytes} is past the end of ${displayName}.`, ctx.recoveryFor('offset_out_of_range'));
+            }
+            if (read.status === 'not_found') {
+                throw ctx.fail('file_not_found', `Zenodo has no content for "${displayName}" in record ${recid}.`, ctx.recoveryFor('file_not_found'));
+            }
+            if (meta.size === undefined && read.fileSize !== undefined)
+                meta.size = read.fileSize;
+        }
+        if (read.status === 'forbidden') {
+            // The files-restricted case returned above, so this is a per-file refusal on a readable record.
+            return withoutText('restricted', `Zenodo refused anonymous access to ${displayName} (HTTP 403) although the record's files are ${access.files ?? access.status}; its content cannot be previewed here. zenodo_get_record shows the record's access details.`, meta);
+        }
+        if (read.bytes.length === 0) {
+            // No bytes past a positive offset means the offset is past the end, not an empty file.
+            if (input.offset_bytes > 0) {
+                throw ctx.fail('offset_out_of_range', `offset_bytes ${input.offset_bytes} is past the end of ${displayName}.`, ctx.recoveryFor('offset_out_of_range'));
+            }
+            return withoutText('empty', `${displayName} is empty.`, meta);
+        }
+        const cut = cutPreview(read.bytes, {
+            atStart: input.offset_bytes === 0,
+            moreRemains: read.moreRemains,
+        });
+        if (cut.binary) {
+            return withoutText('not_text', `${displayName} is not a previewable text file (${meta.mimetype ?? 'binary content'}); download it from download_url.`, meta);
+        }
+        if (mode === 'sniff' && !looksLikeText(read.bytes, input.offset_bytes === 0)) {
+            return withoutText('not_text', `${displayName} has no file extension and its content is not UTF-8 text (${meta.mimetype ?? 'no MIME type'}); download it from download_url.`, meta);
+        }
+        const hasMore = read.moreRemains;
+        const nextOffset = input.offset_bytes + cut.bytesKept;
+        if (hasMore) {
+            const end = nextOffset - 1;
+            ctx.enrich.notice(member
+                ? memberTruncationNotice(end, meta.size, input.max_bytes)
+                : `Showing bytes ${input.offset_bytes}–${end} of ${meta.size ?? 'an unknown total'}; call zenodo_read_file again with offset_bytes ${nextOffset}.`);
+        }
+        return {
+            ...described('text', meta),
+            text: cut.text,
+            bytes_returned: cut.bytesKept,
+            has_more: hasMore,
+            ...(hasMore && !member ? { next_offset: nextOffset } : {}),
+            replacement_chars: cut.replacementChars,
+        };
+    },
+    format: (result) => {
+        const name = result.archive_member
+            ? `${inline(result.archive_member)} (in ${inline(result.key)})`
+            : inline(result.key);
+        const lines = [
+            `## ${name} — record ${result.recid}`,
+            `**Status:** ${result.status} | **MIME type:** ${inline(result.mimetype ?? 'unknown')} | **File size:** ${result.file_size ?? 'unknown'} bytes${result.md5 ? ` | **MD5:** ${inline(result.md5)}` : ''}`,
+            `**Offset:** ${result.offset_bytes} | **Bytes returned:** ${result.bytes_returned} | **Has more:** ${result.has_more}${result.next_offset !== undefined ? ` | **Next offset:** ${result.next_offset}` : ''} | **Replacement chars:** ${result.replacement_chars}`,
+            `**License:** ${result.rights.length ? result.rights.map((r) => `${inline(r.title)}${r.id ? ` (${inline(r.id)})` : ''}`).join('; ') : 'not stated'} — record ${result.record_url}`,
+            `**Download:** ${result.download_url}${result.files_access ? ` | **Files access:** ${inline(result.files_access)}` : ''}`,
+        ];
+        if (result.text !== undefined) {
+            lines.push('', fence(result.text, {
+                key: result.archive_member ?? result.key,
+                lang: languageHint(result.archive_member ?? result.key),
+                recid: result.recid,
+            }));
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=read-file.tool.js.map

package/dist/mcp-server/tools/definitions/read-file.tool.js.map

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

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

@@ -0,0 +1,181 @@
+/**
+ * @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 { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchRecords: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    resource_type: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        [x: string]: string;
+    }>>>, unknown>;
+    community: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    funder: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    award: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    creator_orcid: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    file_type: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodString>>, unknown>;
+    license: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    access_status: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
+        embargoed: "embargoed";
+        "metadata-only": "metadata-only";
+        open: "open";
+        restricted: "restricted";
+    }>>, unknown>;
+    published_from: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    published_to: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    all_versions: z.ZodDefault<z.ZodBoolean>;
+    sort: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
+        bestmatch: "bestmatch";
+        mostdownloaded: "mostdownloaded";
+        mostviewed: "mostviewed";
+        newest: "newest";
+        oldest: "oldest";
+        "updated-asc": "updated-asc";
+        "updated-desc": "updated-desc";
+    }>>, unknown>;
+    page: z.ZodDefault<z.ZodNumber>;
+    size: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    reachable: z.ZodNumber;
+    page: z.ZodNumber;
+    size: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    next_page: z.ZodOptional<z.ZodNumber>;
+    hits: z.ZodArray<z.ZodObject<{
+        recid: z.ZodString;
+        doi: z.ZodOptional<z.ZodString>;
+        doi_provider: z.ZodOptional<z.ZodString>;
+        concept_recid: z.ZodOptional<z.ZodString>;
+        concept_doi: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        publication_date: z.ZodOptional<z.ZodString>;
+        resource_type: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        version: z.ZodOptional<z.ZodString>;
+        is_latest: z.ZodOptional<z.ZodBoolean>;
+        version_index: z.ZodOptional<z.ZodNumber>;
+        creators: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            orcid: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        creator_count: z.ZodNumber;
+        license_ids: z.ZodArray<z.ZodString>;
+        access: z.ZodObject<{
+            status: z.ZodString;
+            files: z.ZodOptional<z.ZodString>;
+            embargo_until: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        communities: z.ZodArray<z.ZodString>;
+        file_count: z.ZodOptional<z.ZodNumber>;
+        total_bytes: z.ZodOptional<z.ZodNumber>;
+        views: z.ZodOptional<z.ZodNumber>;
+        downloads: z.ZodOptional<z.ZodNumber>;
+        description_snippet: z.ZodOptional<z.ZodString>;
+        zenodo_url: z.ZodString;
+    }, z.core.$strip>>;
+    facets: z.ZodObject<{
+        resource_type: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            count: z.ZodNumber;
+            subtypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                count: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        access_status: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>;
+        file_type: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>;
+        subject: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>;
+        publication_year: z.ZodArray<z.ZodObject<{
+            year: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "query_is_identifier";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "The query is a single DOI, doi.org URL, or zenodo.org record URL";
+    readonly recovery: "Pass this identifier to zenodo_get_record as id instead of searching for it.";
+}, {
+    readonly reason: "query_syntax";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "The query has an unpaired unescaped / outside quotes";
+    readonly recovery: "Escape the slash as \\/ or wrap that term in double quotes, then call zenodo_search_records again.";
+}, {
+    readonly reason: "query_failed";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo answered HTTP 500 for a query that passed the local checks";
+    readonly retryable: false;
+    readonly thrownBy: "service";
+    readonly 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.";
+}, {
+    readonly reason: "upstream_timeout";
+    readonly code: JsonRpcErrorCode.Timeout;
+    readonly when: "The search attempt got no complete response within its time budget";
+    readonly retryable: false;
+    readonly thrownBy: "service";
+    readonly recovery: "Call zenodo_search_records again with a smaller size (5) or narrower filters so the page holds fewer large deposits.";
+}, {
+    readonly reason: "unknown_community";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "community resolves to no Zenodo community";
+    readonly recovery: "Find the community’s slug with zenodo_lookup_vocabulary (vocabulary: communities), then pass it as community.";
+}, {
+    readonly reason: "unknown_funder";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "funder is not a known ROR id and no funder carries that Crossref Funder DOI";
+    readonly recovery: "Resolve the funder with zenodo_lookup_vocabulary (vocabulary: funders) and pass the returned ROR id as funder.";
+}, {
+    readonly reason: "invalid_date_range";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "The expanded published_from is after published_to";
+    readonly recovery: "Set published_from to a date on or before published_to and call zenodo_search_records again.";
+}, {
+    readonly reason: "result_window_exceeded";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "page × size exceeds 10,000";
+    readonly 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.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: JsonRpcErrorCode.RateLimited;
+    readonly when: "Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+    readonly recovery: "Wait for the retryAfter seconds in the error data, then call zenodo_search_records again with the same arguments.";
+}], {
+    readonly truncated: z.ZodBoolean;
+    readonly shown: z.ZodNumber;
+    readonly cap: z.ZodNumber;
+    readonly totalCount: z.ZodNumber;
+    readonly effectiveQuery: z.ZodOptional<z.ZodString>;
+    readonly appliedSort: z.ZodEnum<{
+        bestmatch: "bestmatch";
+        mostdownloaded: "mostdownloaded";
+        mostviewed: "mostviewed";
+        newest: "newest";
+        oldest: "oldest";
+        "updated-asc": "updated-asc";
+        "updated-desc": "updated-desc";
+    }>;
+    readonly allVersions: z.ZodBoolean;
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=search-records.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-records.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-records.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA2LjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsexB,CAAC"}