@cyanheads/zenodo-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAEzF,mDAAmD;AACnD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAO9B,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Barrel of every tool definition this server registers.
+ * @module mcp-server/tools/definitions
+ */
+import { getRecord } from './get-record.tool.js';
+import { listFiles } from './list-files.tool.js';
+import { listVersions } from './list-versions.tool.js';
+import { lookupVocabulary } from './lookup-vocabulary.tool.js';
+import { readFile } from './read-file.tool.js';
+import { searchRecords } from './search-records.tool.js';
+export { getRecord, listFiles, listVersions, lookupVocabulary, readFile, searchRecords };
+/** All tool definitions, in registration order. */
+export const allToolDefinitions = [
+    searchRecords,
+    getRecord,
+    listVersions,
+    listFiles,
+    readFile,
+    lookupVocabulary,
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAEzF,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa;IACb,SAAS;IACT,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,gBAAgB;CACjB,CAAC"}

package/dist/mcp-server/tools/definitions/list-files.tool.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview zenodo_list_files — pages a Zenodo deposit's file manifest (taken
+ * from the record GET, which embeds the complete manifest), optionally filtered by
+ * key substring, or lists the members of one of its .zip files.
+ * @module mcp-server/tools/definitions/list-files
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const listFiles: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodString;
+    archive_key: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    key_contains: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    recid: z.ZodString;
+    kind: z.ZodEnum<{
+        archive: "archive";
+        manifest: "manifest";
+    }>;
+    access_status: z.ZodString;
+    files_access: z.ZodOptional<z.ZodString>;
+    embargo_until: z.ZodOptional<z.ZodString>;
+    files_enabled: z.ZodBoolean;
+    key_contains: z.ZodOptional<z.ZodString>;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+    matched: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    next_offset: z.ZodOptional<z.ZodNumber>;
+    file_count: z.ZodOptional<z.ZodNumber>;
+    total_bytes: z.ZodOptional<z.ZodNumber>;
+    entries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+        mimetype: z.ZodOptional<z.ZodString>;
+        md5: z.ZodOptional<z.ZodString>;
+        download_url: z.ZodString;
+        previewable: z.ZodBoolean;
+        listable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    archive: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+        download_url: z.ZodString;
+        listed_members: z.ZodNumber;
+        upstream_truncated: z.ZodBoolean;
+        directory_count: z.ZodNumber;
+    }, z.core.$strip>>;
+    members: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+        compressed_size: z.ZodOptional<z.ZodNumber>;
+        mimetype: z.ZodOptional<z.ZodString>;
+        previewable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "invalid_identifier";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host";
+    readonly 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.";
+}, {
+    readonly reason: "record_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The record 404s, its metadata is restricted, or a non-Zenodo DOI is not registered to a record";
+    readonly recovery: "Check the id with zenodo_get_record, or find the deposit with zenodo_search_records.";
+}, {
+    readonly reason: "record_deleted";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The record was deleted from Zenodo; only its removal tombstone remains";
+    readonly recovery: "Call zenodo_get_record with this id for the removal date and reason, then find a replacement deposit with zenodo_search_records.";
+}, {
+    readonly reason: "file_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "archive_key is not a key in the record, or Zenodo has no member listing for it";
+    readonly recovery: "Call zenodo_list_files without archive_key to see this record’s file keys.";
+}, {
+    readonly reason: "not_an_archive";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "archive_key is not a .zip";
+    readonly recovery: "Only .zip files can be listed; read a small text file with zenodo_read_file or fetch this file from its download_url.";
+}, {
+    readonly reason: "archive_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo cannot open the .zip named by archive_key: its member listing answered HTTP 500 after one retry, or no complete response arrived in time";
+    readonly thrownBy: "service";
+    readonly recovery: "Zenodo cannot list every .zip; download the archive from the URL in the error message (its download_url in the manifest) and list it locally, or read the record’s other files with zenodo_read_file.";
+}, {
+    readonly reason: "record_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly 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)";
+    readonly thrownBy: "service";
+    readonly 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 file manifest cannot be listed, and if a keyword search also fails, Zenodo is degraded.";
+}, {
+    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_list_files again with the same arguments.";
+}], {
+    readonly truncated: z.ZodBoolean;
+    readonly shown: z.ZodNumber;
+    readonly cap: z.ZodNumber;
+    readonly totalCount: z.ZodNumber;
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=list-files.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-files.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-files.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsBjE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmZpB,CAAC"}

package/dist/mcp-server/tools/definitions/list-files.tool.js

@@ -0,0 +1,348 @@
+/**
+ * @fileoverview zenodo_list_files — pages a Zenodo deposit's file manifest (taken
+ * from the record GET, which embeds the complete manifest), optionally filtered by
+ * key substring, or lists the members of one of its .zip files.
+ * @module mcp-server/tools/definitions/list-files
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { parseRecordRef } from '../../../services/zenodo/identifiers.js';
+import { isZip, previewMode } from '../../../services/zenodo/text-preview.js';
+import { getZenodoService } from '../../../services/zenodo/zenodo-service.js';
+import { inline } from '../render.js';
+import { blankToUndefined } from '../schema-helpers.js';
+/** True when zenodo_read_file reads the file rather than refusing it unread. */
+const readsAsText = (key, mimetype) => previewMode(key, mimetype) !== 'binary';
+const PREVIEWABLE_DESCRIPTION = 'True when zenodo_read_file reads this as text: a text MIME type or extension, or an extensionless application/octet-stream file (LICENSE, Makefile) whose content is checked on read and returned only if it is UTF-8 text.';
+/** A window of `items` plus the paging facts every arm reports. */
+function pageOf(items, offset, limit) {
+    const slice = items.slice(offset, offset + limit);
+    const hasMore = offset + limit < items.length;
+    return { slice, matched: items.length, hasMore, nextOffset: offset + limit };
+}
+export const listFiles = tool('zenodo_list_files', {
+    title: 'List Zenodo record files',
+    description: "Page through a Zenodo deposit's file manifest (key, size, MIME type, MD5, download URL, previewability), optionally filtered by a substring of the file key, or list the members inside one of its .zip files by setting archive_key. Restricted and embargoed files return the access status and embargo date with no entries. Read a small text file or ZIP member with zenodo_read_file.",
+    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 lists the latest version’s files.'),
+        archive_key: z
+            .preprocess(blankToUndefined, z.string().max(1000).optional())
+            .describe('Exact file key of a .zip in this record (from the manifest) to list its members instead of the manifest. Omit to list the manifest.'),
+        key_contains: z
+            .preprocess(blankToUndefined, z.string().max(200).optional())
+            .describe('Case-insensitive substring filter on file keys (manifest) or member paths (archive), applied before paging.'),
+        offset: z.number().int().min(0).default(0).describe('Entries to skip before this page.'),
+        limit: z.number().int().min(1).max(200).default(50).describe('Entries per page (1–200).'),
+    }),
+    output: z.object({
+        recid: z
+            .string()
+            .describe('Record id whose files are listed (the latest version for a concept id).'),
+        kind: z
+            .enum(['manifest', 'archive'])
+            .describe('manifest: the record’s files; archive: members of the .zip named by archive_key.'),
+        access_status: z
+            .string()
+            .describe('Record access status: open, restricted, embargoed, or metadata-only.'),
+        files_access: z
+            .string()
+            .optional()
+            .describe('File access: public or restricted; absent when Zenodo does not report it.'),
+        embargo_until: z.string().optional().describe('Embargo end date, when an embargo is active.'),
+        files_enabled: z.boolean().describe('False for a metadata-only deposit.'),
+        key_contains: z.string().optional().describe('The key filter applied, when set.'),
+        offset: z.number().describe('Entries skipped before this page.'),
+        limit: z.number().describe('Page size applied.'),
+        matched: z.number().describe('Entries matching the filter, before paging.'),
+        has_more: z.boolean().describe('True when more matching entries follow this page.'),
+        next_offset: z.number().optional().describe('Offset of the next page, when has_more.'),
+        file_count: z
+            .number()
+            .optional()
+            .describe('Total files in the record (manifest kind); absent when files are restricted or embargoed.'),
+        total_bytes: z
+            .number()
+            .optional()
+            .describe('Total size of the record’s files in bytes (manifest kind); absent when files are restricted or embargoed.'),
+        entries: z
+            .array(z
+            .object({
+            key: z.string().describe('File key — pass to zenodo_read_file as key.'),
+            size: z.number().optional().describe('Size in bytes, when reported.'),
+            mimetype: z.string().optional().describe('MIME type, when reported.'),
+            md5: z.string().optional().describe('MD5 checksum (hex), when reported.'),
+            download_url: z.string().describe('Direct download URL.'),
+            previewable: z.boolean().describe(PREVIEWABLE_DESCRIPTION),
+            listable: z
+                .boolean()
+                .describe('True for a .zip, whose members zenodo_list_files lists when given this key as archive_key.'),
+        })
+            .describe('One file in the manifest.'))
+            .optional()
+            .describe('Manifest files on this page (manifest kind); empty when files are restricted.'),
+        archive: z
+            .object({
+            key: z.string().describe('The .zip file key.'),
+            size: z.number().optional().describe('Size of the .zip in bytes, when reported.'),
+            download_url: z
+                .string()
+                .describe('Direct download URL of the .zip — the complete member list needs the file.'),
+            listed_members: z.number().describe('File members Zenodo listed for this archive.'),
+            upstream_truncated: z
+                .boolean()
+                .describe('True when Zenodo cut the listing at 1,000 nodes (files plus directories), so members are missing.'),
+            directory_count: z.number().describe('Directories Zenodo listed for this archive.'),
+        })
+            .optional()
+            .describe('The archive being listed (archive kind); absent when files are restricted.'),
+        members: z
+            .array(z
+            .object({
+            path: z
+                .string()
+                .describe('Member path inside the archive — pass to zenodo_read_file as archive_member.'),
+            size: z.number().optional().describe('Uncompressed size in bytes, when reported.'),
+            compressed_size: z
+                .number()
+                .optional()
+                .describe('Compressed size in bytes, when reported.'),
+            mimetype: z.string().optional().describe('MIME type, when reported.'),
+            previewable: z.boolean().describe(PREVIEWABLE_DESCRIPTION),
+        })
+            .describe('One archive member.'))
+            .optional()
+            .describe('Archive members on this page (archive kind); empty when files are restricted.'),
+    }),
+    enrichment: {
+        truncated: z.boolean().describe('True when more matching entries follow this page.'),
+        shown: z.number().describe('Entries returned on this page.'),
+        cap: z.number().describe('Page size applied.'),
+        totalCount: z.number().describe('Entries matching the filter, before paging.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('File access notes, empty-filter guidance, listing caps, or paging guidance.'),
+    },
+    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: 'archive_key is not a key in the record, or Zenodo has no member listing for it',
+            recovery: 'Call zenodo_list_files without archive_key to see this record’s file keys.',
+        },
+        {
+            reason: 'not_an_archive',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'archive_key is not a .zip',
+            recovery: 'Only .zip files can be listed; read a small text file with zenodo_read_file or fetch this file from its download_url.',
+        },
+        {
+            reason: 'archive_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Zenodo cannot open the .zip named by archive_key: its member listing answered HTTP 500 after one retry, or no complete response arrived in time',
+            thrownBy: 'service',
+            recovery: 'Zenodo cannot list every .zip; download the archive from the URL in the error message (its download_url in the manifest) and list it locally, or read the record’s other 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 file manifest cannot be listed, 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_list_files again with the same arguments.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.enrich({ truncated: false, shown: 0, cap: input.limit, totalCount: 0 });
+        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 } = record;
+        const archiveKey = input.archive_key;
+        const common = {
+            recid: record.recid,
+            kind: archiveKey ? 'archive' : 'manifest',
+            access_status: access.status,
+            ...(access.files ? { files_access: access.files } : {}),
+            ...(access.embargo_until ? { embargo_until: access.embargo_until } : {}),
+            files_enabled: files.enabled,
+            ...(input.key_contains ? { key_contains: input.key_contains } : {}),
+            offset: input.offset,
+            limit: input.limit,
+        };
+        const needle = input.key_contains?.toLowerCase();
+        if (files.enabled && access.files === 'restricted') {
+            const until = access.embargo_until ? ` until ${access.embargo_until}` : '';
+            ctx.enrich.notice(`Files are ${access.status}${until}; only metadata is available. zenodo_get_record shows the access details.`);
+            return {
+                ...common,
+                matched: 0,
+                has_more: false,
+                ...(archiveKey ? { members: [] } : { entries: [] }),
+            };
+        }
+        const notice = [];
+        const finish = (page, noun, partialListing = false) => {
+            ctx.enrich({ shown: page.slice.length });
+            ctx.enrich.total(page.matched);
+            if (needle && page.matched === 0) {
+                const filter = inline(input.key_contains ?? '');
+                notice.push(partialListing
+                    ? `No listed members contain "${filter}", but the member may lie past the listing cap: if you know its full path, read it directly with zenodo_read_file (key ${inline(archiveKey ?? '')}, archive_member set to that path).`
+                    : `No ${noun} contain "${filter}"; call zenodo_list_files again without key_contains.`);
+            }
+            else if (page.matched > 0 && input.offset >= page.matched) {
+                notice.push(`Offset ${input.offset} is past the last of ${page.matched} ${noun}; call again with a lower offset.`);
+            }
+            if (page.hasMore) {
+                notice.push(`Showing ${page.slice.length} of ${page.matched}; call again with offset ${page.nextOffset}.`);
+                ctx.enrich.truncated({
+                    shown: page.slice.length,
+                    cap: input.limit,
+                    guidance: notice.join(' '),
+                });
+            }
+            else if (notice.length) {
+                ctx.enrich.notice(notice.join(' '));
+            }
+            return {
+                matched: page.matched,
+                has_more: page.hasMore,
+                ...(page.hasMore ? { next_offset: page.nextOffset } : {}),
+            };
+        };
+        if (!archiveKey) {
+            if (!files.enabled)
+                notice.push('This record has no files (metadata-only deposit).');
+            const matching = needle
+                ? files.entries.filter((e) => e.key.toLowerCase().includes(needle))
+                : files.entries;
+            const page = pageOf(matching, input.offset, input.limit);
+            const paging = finish(page, 'files');
+            return {
+                ...common,
+                ...paging,
+                ...(files.count !== undefined ? { file_count: files.count } : {}),
+                ...(files.total_bytes !== undefined ? { total_bytes: files.total_bytes } : {}),
+                entries: page.slice.map((e) => ({
+                    ...e,
+                    previewable: readsAsText(e.key, e.mimetype),
+                    listable: isZip(e.key, e.mimetype),
+                })),
+            };
+        }
+        const entry = files.entries.find((e) => e.key === archiveKey);
+        if (!entry) {
+            throw ctx.fail('file_not_found', files.enabled
+                ? `Record ${record.recid} has no file with key "${inline(archiveKey)}".`
+                : `Record ${record.recid} is a metadata-only deposit with no files.`, ctx.recoveryFor('file_not_found'));
+        }
+        if (!isZip(entry.key, entry.mimetype)) {
+            throw ctx.fail('not_an_archive', `"${inline(archiveKey)}" is not a .zip file${entry.mimetype ? ` (${entry.mimetype})` : ''}; only ZIP archives can be listed.`, ctx.recoveryFor('not_an_archive'));
+        }
+        const container = await service.getContainer(record.recid, entry.key, ctx);
+        if (container.status === 'not_found') {
+            throw ctx.fail('file_not_found', `Zenodo has no member listing for "${inline(archiveKey)}" in record ${record.recid}.`, ctx.recoveryFor('file_not_found'));
+        }
+        const { listing } = container;
+        if (listing.upstream_truncated) {
+            notice.push('Zenodo lists at most 1,000 entries of an archive, so some members are missing from this listing; download the archive from archive.download_url for the complete list.');
+        }
+        const matching = needle
+            ? listing.members.filter((m) => m.path.toLowerCase().includes(needle))
+            : listing.members;
+        const page = pageOf(matching, input.offset, input.limit);
+        const paging = finish(page, 'members', listing.upstream_truncated);
+        return {
+            ...common,
+            ...paging,
+            archive: {
+                key: entry.key,
+                ...(entry.size !== undefined ? { size: entry.size } : {}),
+                download_url: entry.download_url,
+                listed_members: listing.members.length,
+                upstream_truncated: listing.upstream_truncated,
+                directory_count: listing.directory_count,
+            },
+            members: page.slice.map((m) => ({ ...m, previewable: readsAsText(m.path, m.mimetype) })),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Zenodo record ${result.recid} — ${result.kind === 'archive' ? 'archive members' : 'files'}`,
+            `**Kind:** ${result.kind} | **Access:** ${inline(result.access_status)}${result.files_access ? `, files ${inline(result.files_access)}` : ''}${result.embargo_until ? `, embargoed until ${inline(result.embargo_until)}` : ''} | **Files enabled:** ${result.files_enabled}`,
+        ];
+        const totals = [
+            result.file_count !== undefined ? `**File count:** ${result.file_count}` : undefined,
+            result.total_bytes !== undefined ? `**Total bytes:** ${result.total_bytes}` : undefined,
+        ].filter(Boolean);
+        if (totals.length)
+            lines.push(totals.join(' | '));
+        lines.push(`**Matched:** ${result.matched}${result.key_contains ? ` (key contains "${inline(result.key_contains)}")` : ''} | **Offset:** ${result.offset} | **Limit:** ${result.limit} | **Has more:** ${result.has_more}${result.next_offset !== undefined ? ` | **Next offset:** ${result.next_offset}` : ''}`);
+        const a = result.archive;
+        if (a) {
+            lines.push(`**Archive:** ${inline(a.key)} (${a.size ?? '?'} bytes) — ${a.listed_members} members and ${a.directory_count} directories listed; upstream truncated: ${a.upstream_truncated} — ${a.download_url}`);
+        }
+        for (const e of result.entries ?? []) {
+            lines.push(`- ${inline(e.key)} — ${e.size ?? '?'} bytes${e.mimetype ? `, ${inline(e.mimetype)}` : ''}${e.md5 ? `, md5 ${inline(e.md5)}` : ''}; previewable: ${e.previewable}; listable: ${e.listable} — ${e.download_url}`);
+        }
+        for (const m of result.members ?? []) {
+            lines.push(`- ${inline(m.path)} — ${m.size ?? '?'} bytes (compressed ${m.compressed_size ?? '?'})${m.mimetype ? `, ${inline(m.mimetype)}` : ''}; previewable: ${m.previewable}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=list-files.tool.js.map

package/dist/mcp-server/tools/definitions/list-files.tool.js.map

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

package/dist/mcp-server/tools/definitions/list-versions.tool.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview zenodo_list_versions — lists a Zenodo deposit's version series,
+ * newest first. Accepts every identifier form zenodo_get_record accepts; a miss
+ * (unknown id, deleted record, restricted metadata, DOI not on Zenodo) is a result.
+ * @module mcp-server/tools/definitions/list-versions
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const listVersions: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodString;
+    page: z.ZodDefault<z.ZodNumber>;
+    size: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    found: z.ZodBoolean;
+    input_kind: z.ZodEnum<{
+        external_doi: "external_doi";
+        record_id: "record_id";
+        url: "url";
+        zenodo_doi: "zenodo_doi";
+    }>;
+    miss_kind: z.ZodOptional<z.ZodEnum<{
+        deleted: "deleted";
+        not_found: "not_found";
+        not_on_zenodo: "not_on_zenodo";
+        restricted: "restricted";
+    }>>;
+    guidance: z.ZodOptional<z.ZodString>;
+    tombstone: z.ZodOptional<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>>;
+    concept_recid: z.ZodOptional<z.ZodString>;
+    concept_doi: z.ZodOptional<z.ZodString>;
+    total_versions: z.ZodOptional<z.ZodNumber>;
+    latest_recid: z.ZodOptional<z.ZodString>;
+    page: z.ZodNumber;
+    size: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    next_page: z.ZodOptional<z.ZodNumber>;
+    versions: z.ZodArray<z.ZodObject<{
+        recid: z.ZodString;
+        doi: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        publication_date: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+        is_latest: z.ZodOptional<z.ZodBoolean>;
+        file_count: z.ZodOptional<z.ZodNumber>;
+        total_bytes: z.ZodOptional<z.ZodNumber>;
+        views: z.ZodOptional<z.ZodNumber>;
+        downloads: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "invalid_identifier";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host";
+    readonly 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.";
+}, {
+    readonly reason: "result_window_exceeded";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "page × size exceeds 10,000";
+    readonly recovery: "Zenodo pages only the first 10,000 versions of a series, and no series comes near that; call zenodo_list_versions with page 1 (total_versions and has_more show how far the series goes).";
+}, {
+    readonly reason: "record_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Zenodo could not serve this record or its versions page: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete record response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit)";
+    readonly thrownBy: "service";
+    readonly recovery: "Look the record up with zenodo_search_records using query doi:\"<its DOI>\" (all_versions true) or its title; withdrawn legacy records and deposits with more than about 10,000 files fail on the record endpoint, and if a keyword search also fails, Zenodo is degraded.";
+}, {
+    readonly reason: "upstream_timeout";
+    readonly code: JsonRpcErrorCode.Timeout;
+    readonly when: "The versions page got no complete response within its time budget";
+    readonly retryable: false;
+    readonly thrownBy: "service";
+    readonly recovery: "Call zenodo_list_versions again with a smaller size (5); this series holds large file manifests.";
+}, {
+    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_list_versions again with the same arguments.";
+}], {
+    readonly truncated: z.ZodBoolean;
+    readonly shown: z.ZodNumber;
+    readonly cap: z.ZodNumber;
+    readonly totalCount: z.ZodNumber;
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=list-versions.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-versions.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-versions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-versions.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAUjE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuSvB,CAAC"}