@cyanheads/zenodo-mcp-server 0.1.1 → 0.1.3

package/dist/mcp-server/tools/definitions/get-record.tool.js

@@ -1,17 +1,20 @@
 /**
  * @fileoverview zenodo_get_record — resolves one Zenodo deposit from a record id,
  * Zenodo or external DOI, or zenodo.org/doi.org URL and returns its full metadata,
- * the first 25 files, and optionally a formatted citation. A miss (unknown id,
- * deleted record, restricted metadata, DOI not on Zenodo) is a result, not an error.
+ * the first 25 files, and optionally a formatted citation. Fields cut at a display
+ * cap are listed in `continuations` with a cursor; passing one back returns the
+ * next window of that field. A miss (unknown id, deleted record, restricted
+ * metadata, DOI not on Zenodo) is a result, not an error.
  * @module mcp-server/tools/definitions/get-record
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { decodeCursor, encodeCursor } from '@cyanheads/mcp-ts-core/utils';
 import { parseRecordRef, recordUrl } from '../../../services/zenodo/identifiers.js';
 import { getZenodoService } from '../../../services/zenodo/zenodo-service.js';
 import { notOnZenodoMiss, recordMiss, TombstoneSchema } from '../record-miss.js';
 import { hasLineBreak, inline, quoteBlock } from '../render.js';
-import { enumPreprocess } from '../schema-helpers.js';
+import { blankToUndefined, enumPreprocess } from '../schema-helpers.js';
 const CITATION_STYLES = [
     'bibtex',
     'csl-json',
@@ -29,6 +32,29 @@ const COMMUNITIES_CAP = 25;
 const DESCRIPTION_CAP = 4_000;
 const ADDITIONAL_DESCRIPTIONS_CAP = 5;
 const ADDITIONAL_DESCRIPTION_TEXT_CAP = 1_000;
+/** Characters per text window in cursor mode. */
+const TEXT_WINDOW = 8_000;
+/** The list fields a cursor can page, in record order. */
+const LIST_FIELDS = [
+    'additional_descriptions',
+    'creators',
+    'contributors',
+    'keywords',
+    'funding',
+    'related_identifiers',
+    'communities',
+];
+const FieldSchema = z.enum(['description', ...LIST_FIELDS]);
+const UnitSchema = z.enum(['characters', 'entries']);
+/** The state a cursor carries: framework pagination state bound to one record revision. */
+const CursorStateSchema = z.object({
+    offset: z.number().int().min(0),
+    limit: z.number().int().min(1),
+    recid: z.string(),
+    rev: z.number().int().optional(),
+    field: FieldSchema,
+    index: z.number().int().min(0).optional(),
+});
 const PersonSchema = z
     .object({
     name: z.string().describe('Display name as deposited.'),
@@ -57,6 +83,46 @@ const UsageSchema = z
         .describe('Unique downloads, as zenodo.org displays them; absent when not reported.'),
 })
     .describe('Usage counts.');
+const AdditionalDescriptionSchema = z
+    .object({
+    type: z.string().optional().describe('Description type, e.g. Notes or Methods.'),
+    text: z.string().describe('Plain text, first 1,000 characters.'),
+    length: z.number().describe('Full plain-text length in characters.'),
+    truncated: z
+        .boolean()
+        .describe('True when text was cut at 1,000 characters; continuations carries a cursor for the rest.'),
+})
+    .describe('One additional description.');
+const FundingSchema = z
+    .object({
+    funder_id: z.string().optional().describe('Funder ROR id.'),
+    funder_name: z.string().optional().describe('Funder name.'),
+    award_id: z
+        .string()
+        .optional()
+        .describe('Award id (<funder-ror>::<number>) — feeds zenodo_search_records award.'),
+    award_number: z.string().optional().describe('Grant number.'),
+    award_acronym: z.string().optional().describe('Award acronym.'),
+    award_title: z.string().optional().describe('Award title.'),
+    award_program: z.string().optional().describe('Funding program.'),
+    award_doi: z.string().optional().describe('Award DOI, e.g. 10.3030/101135562.'),
+    award_url: z.string().optional().describe('Award landing page URL.'),
+})
+    .describe('One funding entry.');
+const RelatedIdentifierSchema = z
+    .object({
+    identifier: z.string().describe('The related identifier (DOI, arXiv id, URL, PMID, …).'),
+    scheme: z.string().optional().describe('Identifier scheme, e.g. doi, arxiv, url.'),
+    relation: z.string().optional().describe('Relation type id, e.g. issupplementto or cites.'),
+    resource_type: z.string().optional().describe('Resource type id of the related item.'),
+})
+    .describe('One related identifier.');
+const CommunitySchema = z
+    .object({
+    slug: z.string().describe('Community slug — feeds zenodo_search_records community.'),
+    title: z.string().optional().describe('Community title.'),
+})
+    .describe('One community.');
 const RecordSchema = z
     .object({
     recid: z.string().describe('Record id of this version.'),
@@ -97,28 +163,25 @@ const RecordSchema = z
     description: z
         .string()
         .optional()
-        .describe('Description converted from HTML to plain text, capped at 4,000 characters; absent when the record has none.'),
+        .describe('Description converted from HTML to plain text, first 4,000 characters; absent when the record has none.'),
     description_truncated: z
         .boolean()
         .optional()
-        .describe('True when the description was cut at 4,000 characters. Present with description.'),
+        .describe('True when the description was cut at 4,000 characters; continuations carries a cursor for the rest. Present with description.'),
     description_length: z
         .number()
         .optional()
         .describe('Full plain-text length of the description in characters. Present with description.'),
     additional_descriptions: z
-        .array(z
-        .object({
-        type: z.string().optional().describe('Description type, e.g. Notes or Methods.'),
-        text: z.string().describe('Plain text, capped at 1,000 characters.'),
-    })
-        .describe('One additional description.'))
-        .describe('Up to 5 additional descriptions.'),
+        .array(AdditionalDescriptionSchema)
+        .describe('First 5 additional descriptions, in record order (index 0 first).'),
+    additional_description_count: z.number().describe('Total additional descriptions.'),
     creators: z.array(PersonSchema).describe('First 25 creators.'),
     creator_count: z.number().describe('Total creators.'),
     contributors: z.array(PersonSchema).describe('First 25 contributors.'),
     contributor_count: z.number().describe('Total contributors.'),
-    keywords: z.array(z.string()).describe('Up to 50 subject keywords.'),
+    keywords: z.array(z.string()).describe('First 50 subject keywords.'),
+    keyword_count: z.number().describe('Total subject keywords.'),
     rights: z
         .array(z
         .object({
@@ -146,52 +209,16 @@ const RecordSchema = z
         embargo_reason: z.string().optional().describe('Embargo reason, when active.'),
     })
         .describe('Access status and embargo.'),
-    funding: z
-        .array(z
-        .object({
-        funder_id: z.string().optional().describe('Funder ROR id.'),
-        funder_name: z.string().optional().describe('Funder name.'),
-        award_id: z
-            .string()
-            .optional()
-            .describe('Award id (<funder-ror>::<number>) — feeds zenodo_search_records award.'),
-        award_number: z.string().optional().describe('Grant number.'),
-        award_acronym: z.string().optional().describe('Award acronym.'),
-        award_title: z.string().optional().describe('Award title.'),
-        award_program: z.string().optional().describe('Funding program.'),
-        award_doi: z.string().optional().describe('Award DOI, e.g. 10.3030/101135562.'),
-        award_url: z.string().optional().describe('Award landing page URL.'),
-    })
-        .describe('One funding entry.'))
-        .describe('Up to 50 funding entries (funders and grants).'),
-    related_identifiers: z
-        .array(z
-        .object({
-        identifier: z
-            .string()
-            .describe('The related identifier (DOI, arXiv id, URL, PMID, …).'),
-        scheme: z.string().optional().describe('Identifier scheme, e.g. doi, arxiv, url.'),
-        relation: z
-            .string()
-            .optional()
-            .describe('Relation type id, e.g. issupplementto or cites.'),
-        resource_type: z.string().optional().describe('Resource type id of the related item.'),
-    })
-        .describe('One related identifier.'))
-        .describe('First 50 related identifiers.'),
+    funding: z.array(FundingSchema).describe('First 50 funding entries (funders and grants).'),
+    funding_count: z.number().describe('Total funding entries.'),
+    related_identifiers: z.array(RelatedIdentifierSchema).describe('First 50 related identifiers.'),
     related_identifier_count: z.number().describe('Total related identifiers.'),
     code_repository: z
         .string()
         .optional()
         .describe('Source code repository URL; absent when none is linked.'),
-    communities: z
-        .array(z
-        .object({
-        slug: z.string().describe('Community slug — feeds zenodo_search_records community.'),
-        title: z.string().optional().describe('Community title.'),
-    })
-        .describe('One community.'))
-        .describe('Up to 25 communities holding this record.'),
+    communities: z.array(CommunitySchema).describe('First 25 communities holding this record.'),
+    community_count: z.number().describe('Total communities holding this record.'),
     versions: z
         .object({
         index: z
@@ -244,6 +271,225 @@ const RecordSchema = z
     zenodo_url: z.string().describe('Record landing page on zenodo.org.'),
 })
     .describe('The deposit’s metadata.');
+const ContinuationSchema = z
+    .object({
+    field: FieldSchema.describe('The field that was cut.'),
+    index: z
+        .number()
+        .optional()
+        .describe('Position of the additional description whose text was cut (0 = first). Present only for an additional description’s text.'),
+    unit: UnitSchema.describe('characters for description text, entries for a list (additional_descriptions without index is the list).'),
+    shown: z
+        .number()
+        .describe('Characters or entries of the field returned so far, counted from its start; the cursor resumes here.'),
+    total: z.number().describe('Full length of the field in characters, or its total entries.'),
+    id: z
+        .string()
+        .describe('Record id the cursor is bound to; pass it as id beside the cursor, whatever id form this call took.'),
+    cursor: z
+        .string()
+        .describe('Pass as cursor, with this entry’s id, to get the next window of this field.'),
+})
+    .describe('One field cut short in this response.');
+const WindowSchema = z
+    .object({
+    field: FieldSchema.describe('The field this window continues.'),
+    index: z
+        .number()
+        .optional()
+        .describe('Position of the additional description whose text this window continues (0 = first). Present only for an additional description’s text.'),
+    unit: UnitSchema.describe('characters for a text window, entries for a list window.'),
+    offset: z.number().describe('Characters or entries of the field before this window.'),
+    shown: z.number().describe('Characters or entries in this window.'),
+    total: z.number().describe('Full length of the field in characters, or its total entries.'),
+    text: z
+        .string()
+        .optional()
+        .describe('Up to 8,000 characters of the field’s plain text, starting at offset. Present when unit is characters.'),
+    additional_descriptions: z
+        .array(AdditionalDescriptionSchema)
+        .optional()
+        .describe('Up to 5 additional descriptions starting at offset, each text cut at 1,000 characters. Present when field is additional_descriptions and unit is entries.'),
+    creators: z
+        .array(PersonSchema)
+        .optional()
+        .describe('Up to 25 creators starting at offset. Present when field is creators.'),
+    contributors: z
+        .array(PersonSchema)
+        .optional()
+        .describe('Up to 25 contributors starting at offset. Present when field is contributors.'),
+    keywords: z
+        .array(z.string())
+        .optional()
+        .describe('Up to 50 subject keywords starting at offset. Present when field is keywords.'),
+    funding: z
+        .array(FundingSchema)
+        .optional()
+        .describe('Up to 50 funding entries starting at offset. Present when field is funding.'),
+    related_identifiers: z
+        .array(RelatedIdentifierSchema)
+        .optional()
+        .describe('Up to 50 related identifiers starting at offset. Present when field is related_identifiers.'),
+    communities: z
+        .array(CommunitySchema)
+        .optional()
+        .describe('Up to 25 communities starting at offset. Present when field is communities.'),
+})
+    .describe('One window of a field a previous response cut short.');
+const isHighSurrogate = (code) => code >= 0xd800 && code <= 0xdbff;
+/** `n`, or `n − 1` when cutting `text` at `n` would split a surrogate pair. */
+const cutAt = (text, n) => n < text.length && isHighSurrogate(text.charCodeAt(n - 1)) ? n - 1 : n;
+function additionalDescriptionView(d) {
+    return {
+        ...(d.type ? { type: d.type } : {}),
+        text: d.text.slice(0, cutAt(d.text, ADDITIONAL_DESCRIPTION_TEXT_CAP)),
+        length: d.text.length,
+        truncated: d.text.length > ADDITIONAL_DESCRIPTION_TEXT_CAP,
+    };
+}
+/** A continuation for `field` resuming at `shown`, its cursor bound to this record revision. */
+function continuation(record, cut, limit) {
+    return {
+        ...cut,
+        id: record.recid,
+        cursor: encodeCursor({
+            offset: cut.shown,
+            limit,
+            recid: record.recid,
+            ...(record.revision !== undefined ? { rev: record.revision } : {}),
+            field: cut.field,
+            ...(cut.index !== undefined ? { index: cut.index } : {}),
+        }),
+    };
+}
+/** One page of a list field from `offset`, at the field's display cap. */
+function listPage(record, field, offset) {
+    const page = (all, size, arm) => {
+        const items = all.slice(offset, offset + size);
+        return { arm: arm(items), size, shown: items.length, total: all.length };
+    };
+    switch (field) {
+        case 'additional_descriptions':
+            return page(record.additional_descriptions, ADDITIONAL_DESCRIPTIONS_CAP, (items) => ({
+                additional_descriptions: items.map(additionalDescriptionView),
+            }));
+        case 'creators':
+            return page(record.creators, PEOPLE_CAP, (creators) => ({ creators }));
+        case 'contributors':
+            return page(record.contributors, PEOPLE_CAP, (contributors) => ({ contributors }));
+        case 'keywords':
+            return page(record.keywords, LIST_CAP, (keywords) => ({ keywords }));
+        case 'funding':
+            return page(record.funding, LIST_CAP, (funding) => ({ funding }));
+        case 'related_identifiers':
+            return page(record.related_identifiers, LIST_CAP, (related_identifiers) => ({
+                related_identifiers,
+            }));
+        case 'communities':
+            return page(record.communities, COMMUNITIES_CAP, (communities) => ({ communities }));
+    }
+}
+/** Continuations for the cut texts among additional descriptions `from`…`to - 1`. */
+function additionalTextCuts(record, from, to) {
+    return record.additional_descriptions.slice(from, to).flatMap((d, i) => d.text.length > ADDITIONAL_DESCRIPTION_TEXT_CAP
+        ? [
+            continuation(record, {
+                field: 'additional_descriptions',
+                index: from + i,
+                unit: 'characters',
+                shown: cutAt(d.text, ADDITIONAL_DESCRIPTION_TEXT_CAP),
+                total: d.text.length,
+            }, TEXT_WINDOW),
+        ]
+        : []);
+}
+/** Every field the record view cuts, in record order; files page through zenodo_list_files instead. */
+function recordContinuations(record) {
+    const cuts = [];
+    const description = record.description;
+    if (description && description.length > DESCRIPTION_CAP) {
+        cuts.push(continuation(record, {
+            field: 'description',
+            unit: 'characters',
+            shown: cutAt(description, DESCRIPTION_CAP),
+            total: description.length,
+        }, TEXT_WINDOW));
+    }
+    for (const field of LIST_FIELDS) {
+        const { size, shown, total } = listPage(record, field, 0);
+        if (shown < total) {
+            cuts.push(continuation(record, { field, unit: 'entries', shown, total }, size));
+        }
+        if (field === 'additional_descriptions')
+            cuts.push(...additionalTextCuts(record, 0, shown));
+    }
+    return cuts;
+}
+/** The window a cursor names in `record`, or why it names none. */
+function openWindow(record, state) {
+    const revision = (rev) => (rev === undefined ? '' : ` revision ${rev}`);
+    if (state.recid !== record.recid || state.rev !== record.revision) {
+        return `The cursor continues record ${state.recid}${revision(state.rev)}, but id resolves to record ${record.recid}${revision(record.revision)}; the cursor belongs to another record or the record has changed since it was issued.`;
+    }
+    const { field, index, offset } = state;
+    const name = `${field}${index === undefined ? '' : ` index ${index}`}`;
+    const pastEnd = `The cursor points past the end of ${name} in record ${record.recid}.`;
+    const noSuchField = `Record ${record.recid} has no ${name} for the cursor to continue.`;
+    const text = field === 'description' && index === undefined
+        ? record.description
+        : field === 'additional_descriptions' && index !== undefined
+            ? record.additional_descriptions[index]?.text
+            : undefined;
+    if (text !== undefined) {
+        if (offset >= text.length)
+            return pastEnd;
+        const end = cutAt(text, Math.min(offset + TEXT_WINDOW, text.length));
+        const cut = { field, ...(index === undefined ? {} : { index }), unit: 'characters' };
+        return {
+            window: {
+                ...cut,
+                offset,
+                shown: end - offset,
+                total: text.length,
+                text: text.slice(offset, end),
+            },
+            continuations: end < text.length
+                ? [continuation(record, { ...cut, shown: end, total: text.length }, TEXT_WINDOW)]
+                : [],
+            size: TEXT_WINDOW,
+        };
+    }
+    if (field === 'description' || index !== undefined)
+        return noSuchField;
+    const page = listPage(record, field, offset);
+    if (offset >= page.total)
+        return pastEnd;
+    const end = offset + page.shown;
+    return {
+        window: { field, unit: 'entries', offset, shown: page.shown, total: page.total, ...page.arm },
+        continuations: [
+            ...(end < page.total
+                ? [
+                    continuation(record, { field, unit: 'entries', shown: end, total: page.total }, page.size),
+                ]
+                : []),
+            ...(field === 'additional_descriptions' ? additionalTextCuts(record, offset, end) : []),
+        ],
+        size: page.size,
+    };
+}
+/** The continuation state `cursor` carries, or undefined when it is not one this tool issued. */
+function readCursor(cursor, ctx) {
+    let decoded;
+    try {
+        decoded = decodeCursor(cursor, ctx);
+    }
+    catch {
+        return;
+    }
+    const state = CursorStateSchema.safeParse(decoded);
+    return state.success ? state.data : undefined;
+}
 /** Applies get_record's display caps to a normalized record. */
 function toRecordView(record, latestRecid) {
     const description = record.description;
@@ -262,29 +508,30 @@ function toRecordView(record, latestRecid) {
         ...(record.resource_type ? { resource_type: record.resource_type } : {}),
         ...(description
             ? {
-                description: description.slice(0, DESCRIPTION_CAP),
+                description: description.slice(0, cutAt(description, DESCRIPTION_CAP)),
                 description_truncated: description.length > DESCRIPTION_CAP,
                 description_length: description.length,
             }
             : {}),
         additional_descriptions: record.additional_descriptions
             .slice(0, ADDITIONAL_DESCRIPTIONS_CAP)
-            .map((d) => ({
-            ...(d.type ? { type: d.type } : {}),
-            text: d.text.slice(0, ADDITIONAL_DESCRIPTION_TEXT_CAP),
-        })),
+            .map(additionalDescriptionView),
+        additional_description_count: record.additional_descriptions.length,
         creators: record.creators.slice(0, PEOPLE_CAP),
         creator_count: record.creators.length,
         contributors: record.contributors.slice(0, PEOPLE_CAP),
         contributor_count: record.contributors.length,
         keywords: record.keywords.slice(0, LIST_CAP),
+        keyword_count: record.keywords.length,
         rights: record.rights,
         access: record.access,
         funding: record.funding.slice(0, LIST_CAP),
+        funding_count: record.funding.length,
         related_identifiers: record.related_identifiers.slice(0, LIST_CAP),
         related_identifier_count: record.related_identifiers.length,
         ...(record.code_repository ? { code_repository: record.code_repository } : {}),
         communities: record.communities.slice(0, COMMUNITIES_CAP),
+        community_count: record.communities.length,
         versions: { ...record.versions, ...(latestRecid ? { latest_recid: latestRecid } : {}) },
         ...(record.stats ? { stats: record.stats } : {}),
         files: {
@@ -315,9 +562,84 @@ function renderPerson(p) {
         parts.push(`— ${affiliations.join('; ')}`);
     return `- ${parts.join(' ')}`;
 }
+function renderFunding(f) {
+    const funder = [
+        f.funder_name ? inline(f.funder_name) : undefined,
+        f.funder_id ? `(${inline(f.funder_id)})` : undefined,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    const award = [
+        f.award_acronym ? inline(f.award_acronym) : undefined,
+        f.award_number ? `no. ${inline(f.award_number)}` : undefined,
+        f.award_id ? `[award id ${inline(f.award_id)}]` : undefined,
+        f.award_program ? `program ${inline(f.award_program)}` : undefined,
+        f.award_doi ? `DOI ${inline(f.award_doi)}` : undefined,
+        f.award_url ? inline(f.award_url) : undefined,
+    ]
+        .filter(Boolean)
+        .join(', ');
+    const lines = [`- ${funder || 'Unnamed funder'}${award ? ` — ${award}` : ''}`];
+    if (f.award_title) {
+        lines.push(hasLineBreak(f.award_title)
+            ? quoteBlock(f.award_title, '  Award title (untrusted):')
+            : `  Award title: ${f.award_title}`);
+    }
+    return lines;
+}
+function renderRelated(x) {
+    return `- ${inline(x.relation ?? 'related')}: ${inline(x.identifier)}${x.scheme ? ` (${inline(x.scheme)})` : ''}${x.resource_type ? ` [${inline(x.resource_type)}]` : ''}`;
+}
+function renderCommunities(communities) {
+    return communities
+        .map((c) => `${inline(c.slug)}${c.title ? ` (${inline(c.title)})` : ''}`)
+        .join('; ');
+}
+/** One additional description at its position in the record, with its length and any cut. */
+function renderAdditionalDescription(d, index, total) {
+    return [
+        '',
+        `### Additional description${d.type ? ` — ${inline(d.type)}` : ''} (index ${index} of ${total}: ${d.length} chars${d.truncated ? ', truncated to 1,000' : ''})`,
+        quoteBlock(d.text),
+    ];
+}
+/** Every continuation of one response names the same record id, so the heading names it once. */
+function renderContinuations(continuations) {
+    return [
+        '',
+        `### Continuations (pass a cursor with id ${continuations[0]?.id} for the next window)`,
+        ...continuations.map((c) => `- ${c.field}${c.index === undefined ? '' : ` index ${c.index}`}: ${c.shown} of ${c.total} ${c.unit} returned so far — cursor: \`${c.cursor}\``),
+    ];
+}
+function renderWindow(w) {
+    const lines = [
+        '',
+        `### Window: ${w.field}${w.index === undefined ? '' : ` index ${w.index}`} — ${w.unit} from offset ${w.offset}, ${w.shown} shown of ${w.total}`,
+    ];
+    if (w.text !== undefined)
+        lines.push(quoteBlock(w.text));
+    if (w.additional_descriptions) {
+        w.additional_descriptions.forEach((d, i) => {
+            lines.push(...renderAdditionalDescription(d, w.offset + i, w.total));
+        });
+    }
+    if (w.creators)
+        lines.push(...w.creators.map(renderPerson));
+    if (w.contributors)
+        lines.push(...w.contributors.map(renderPerson));
+    if (w.keywords)
+        lines.push(`**Keywords:** ${w.keywords.map(inline).join('; ')}`);
+    if (w.funding)
+        lines.push(...w.funding.flatMap(renderFunding));
+    if (w.related_identifiers)
+        lines.push(...w.related_identifiers.map(renderRelated));
+    if (w.communities)
+        lines.push(`**Communities:** ${renderCommunities(w.communities)}`);
+    return lines;
+}
 export const getRecord = tool('zenodo_get_record', {
     title: 'Get a Zenodo record',
-    description: 'Resolve one Zenodo deposit from a record id, a Zenodo DOI (10.5281/zenodo.N), a concept DOI or concept record id (resolves to the latest version), another DOI deposited on Zenodo, or a zenodo.org or doi.org URL, and return its full metadata: description, creators with ORCIDs and ROR affiliations, license, access and embargo, funding and grants, related identifiers, communities, version position, usage counts, and the first 25 files. Optionally includes a formatted citation. A miss (an unknown id, a deleted record with its removal tombstone, restricted metadata, or a DOI not registered on Zenodo) returns found: false with guidance instead of an error.',
+    description: 'Resolve one Zenodo deposit from a record id, a Zenodo DOI (10.5281/zenodo.N), a concept DOI or concept record id (resolves to the latest version), another DOI deposited on Zenodo, or a zenodo.org or doi.org URL, and return its full metadata: description, creators with ORCIDs and ROR affiliations, license, access and embargo, funding and grants, related identifiers, communities, version position, usage counts, and the first 25 files. Optionally includes a formatted citation. Long text and lists are cut at display caps with their totals reported; every cut except the file list (paged with zenodo_list_files) is listed in continuations with a cursor and the record id it is bound to, and passing both back returns the next window of that field (8,000 characters of text, or the next page of entries) in place of the record. A miss (an unknown id, a deleted record with its removal tombstone, restricted metadata, or a DOI not registered on Zenodo) returns found: false with guidance instead of an error.',
     annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
     input: z.object({
         id: z
@@ -329,6 +651,9 @@ export const getRecord = tool('zenodo_get_record', {
         citation_style: z
             .preprocess(enumPreprocess(CITATION_STYLES), z.enum(CITATION_STYLES).optional())
             .describe('Include a formatted citation of the resolved version: bibtex, csl-json, or a text style (apa, chicago-author-date, harvard-cite-them-right, ieee, modern-language-association, nature). Case, spaces, hyphens, and underscores are ignored when matching (BibTeX, APA, CSL JSON). Omit for none.'),
+        cursor: z
+            .preprocess(blankToUndefined, z.string().max(500).optional())
+            .describe('A continuations[].cursor from an earlier zenodo_get_record response, passed unchanged with that continuation’s id as id. Returns that field’s next window (8,000 characters of text, or the next page of entries) as window, in place of record. Omit to get the record.'),
     }),
     output: z.object({
         found: z.boolean().describe('True when the record resolved.'),
@@ -345,7 +670,12 @@ export const getRecord = tool('zenodo_get_record', {
             .describe('Why nothing resolved. Present when not found.'),
         guidance: z.string().optional().describe('What to do next. Present when not found.'),
         tombstone: TombstoneSchema.optional().describe('Removal tombstone. Present when miss_kind is deleted.'),
-        record: RecordSchema.optional().describe('The record. Present when found.'),
+        record: RecordSchema.optional().describe('The record. Present when found and no cursor was passed.'),
+        window: WindowSchema.optional().describe('The next window of the field the cursor continues. Present when found and a cursor was passed, in place of record.'),
+        continuations: z
+            .array(ContinuationSchema)
+            .optional()
+            .describe('Every field this response cut short, each with a cursor for the rest. Absent when nothing was cut; files are paged with zenodo_list_files instead.'),
         citation: z
             .string()
             .optional()
@@ -356,9 +686,15 @@ export const getRecord = tool('zenodo_get_record', {
             .describe('The citation style used. Present with citation.'),
     }),
     enrichment: {
-        truncated: z.boolean().describe('True when the record has more files than the 25 shown.'),
-        shown: z.number().describe('File entries shown.'),
-        cap: z.number().describe('Maximum file entries shown (25).'),
+        truncated: z
+            .boolean()
+            .describe('Without cursor: true when anything was cut, files past the 25 shown or any field in continuations. With cursor: true when continuations lists a next step, because the field continues past this window or an additional description on this page was cut.'),
+        shown: z
+            .number()
+            .describe('Without cursor: file entries shown. With cursor: characters or entries in the window.'),
+        cap: z
+            .number()
+            .describe('Without cursor: maximum file entries shown (25). With cursor: the window size (8,000 characters, or the field’s page of entries).'),
         notice: z.string().optional().describe('File access notes or a pointer to zenodo_list_files.'),
     },
     errors: [
@@ -368,6 +704,12 @@ export const getRecord = tool('zenodo_get_record', {
             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: 'invalid_cursor',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'cursor is not one this tool returned in continuations, belongs to another record, or the record was edited after the cursor was issued',
+            recovery: 'Pass the cursor with the record id the message names as id to continue that record; otherwise call zenodo_get_record with this id and no cursor for this record’s own continuations, and pass one of those cursors unchanged with the id it lists.',
+        },
         {
             reason: 'record_unavailable',
             code: JsonRpcErrorCode.ServiceUnavailable,
@@ -388,7 +730,11 @@ export const getRecord = tool('zenodo_get_record', {
         ctx.enrich({ truncated: false, shown: 0, cap: FILES_CAP });
         const ref = parseRecordRef(input.id);
         if (ref.kind === 'invalid') {
-            throw ctx.fail('invalid_identifier', ref.message, ctx.recoveryFor('invalid_identifier'));
+            throw ctx.fail('invalid_identifier', ref.message);
+        }
+        const cursor = input.cursor === undefined ? undefined : readCursor(input.cursor, ctx);
+        if (input.cursor !== undefined && !cursor) {
+            throw ctx.fail('invalid_cursor', 'The cursor is not a zenodo_get_record continuation; it may be cut short or altered.');
         }
         const service = getZenodoService();
         const inputKind = ref.inputKind;
@@ -414,12 +760,32 @@ export const getRecord = tool('zenodo_get_record', {
             record = lookup.record;
             resolvedFrom = record.concept_recid === ref.recid ? 'concept_to_latest' : 'version';
         }
+        const opened = cursor && openWindow(record, cursor);
+        if (typeof opened === 'string')
+            throw ctx.fail('invalid_cursor', opened);
         const [latestRecid, citation] = await Promise.all([
-            record.versions.is_latest === false ? service.latestRecid(record.recid, ctx) : undefined,
+            !opened && record.versions.is_latest === false
+                ? service.latestRecid(record.recid, ctx)
+                : undefined,
             input.citation_style
                 ? service.getCitation(record.recid, input.citation_style, ctx)
                 : undefined,
         ]);
+        const cited = citation !== undefined && input.citation_style
+            ? { citation, citation_style: input.citation_style }
+            : {};
+        if (opened) {
+            const { window, continuations, size } = opened;
+            ctx.enrich({ truncated: continuations.length > 0, shown: window.shown, cap: size });
+            return {
+                found: true,
+                input_kind: inputKind,
+                resolved_from: resolvedFrom,
+                window,
+                ...(continuations.length ? { continuations } : {}),
+                ...cited,
+            };
+        }
         const view = toRecordView(record, latestRecid);
         ctx.enrich({ shown: view.files.shown });
         const fileCount = record.files.count ?? record.files.entries.length;
@@ -431,17 +797,19 @@ export const getRecord = tool('zenodo_get_record', {
             ctx.enrich.truncated({
                 shown: view.files.shown,
                 cap: FILES_CAP,
-                guidance: `Showing ${FILES_CAP} of ${fileCount} files; page the rest with zenodo_list_files.`,
+                guidance: `Showing ${FILES_CAP} of ${fileCount.toLocaleString('en-US')} files; page the rest with zenodo_list_files.`,
             });
         }
+        const continuations = recordContinuations(record);
+        if (continuations.length)
+            ctx.enrich({ truncated: true });
         return {
             found: true,
             input_kind: inputKind,
             resolved_from: resolvedFrom,
             record: view,
-            ...(citation !== undefined && input.citation_style
-                ? { citation, citation_style: input.citation_style }
-                : {}),
+            ...(continuations.length ? { continuations } : {}),
+            ...cited,
         };
     },
     format: (result) => {
@@ -503,43 +871,17 @@ export const getRecord = tool('zenodo_get_record', {
             if (r.contributors.length || r.contributor_count) {
                 lines.push('', `### Contributors (${r.contributor_count})`, ...r.contributors.map(renderPerson));
             }
-            if (r.keywords.length)
-                lines.push('', `**Keywords:** ${r.keywords.map(inline).join('; ')}`);
-            if (r.communities.length) {
-                lines.push(`**Communities:** ${r.communities.map((c) => `${inline(c.slug)}${c.title ? ` (${inline(c.title)})` : ''}`).join('; ')}`);
+            if (r.keywords.length || r.keyword_count) {
+                lines.push('', `**Keywords (${r.keyword_count}):** ${r.keywords.map(inline).join('; ')}`);
             }
-            if (r.funding.length) {
-                lines.push('', '### Funding');
-                for (const f of r.funding) {
-                    const funder = [
-                        f.funder_name ? inline(f.funder_name) : undefined,
-                        f.funder_id ? `(${inline(f.funder_id)})` : undefined,
-                    ]
-                        .filter(Boolean)
-                        .join(' ');
-                    const award = [
-                        f.award_acronym ? inline(f.award_acronym) : undefined,
-                        f.award_number ? `no. ${inline(f.award_number)}` : undefined,
-                        f.award_id ? `[award id ${inline(f.award_id)}]` : undefined,
-                        f.award_program ? `program ${inline(f.award_program)}` : undefined,
-                        f.award_doi ? `DOI ${inline(f.award_doi)}` : undefined,
-                        f.award_url ? inline(f.award_url) : undefined,
-                    ]
-                        .filter(Boolean)
-                        .join(', ');
-                    lines.push(`- ${funder || 'Unnamed funder'}${award ? ` — ${award}` : ''}`);
-                    if (f.award_title) {
-                        lines.push(hasLineBreak(f.award_title)
-                            ? quoteBlock(f.award_title, '  Award title (untrusted):')
-                            : `  Award title: ${f.award_title}`);
-                    }
-                }
+            if (r.communities.length || r.community_count) {
+                lines.push(`**Communities (${r.community_count}):** ${renderCommunities(r.communities)}`);
+            }
+            if (r.funding.length || r.funding_count) {
+                lines.push('', `### Funding (${r.funding_count})`, ...r.funding.flatMap(renderFunding));
             }
             if (r.related_identifiers.length || r.related_identifier_count) {
-                lines.push('', `### Related identifiers (${r.related_identifier_count})`);
-                for (const x of r.related_identifiers) {
-                    lines.push(`- ${inline(x.relation ?? 'related')}: ${inline(x.identifier)}${x.scheme ? ` (${inline(x.scheme)})` : ''}${x.resource_type ? ` [${inline(x.resource_type)}]` : ''}`);
-                }
+                lines.push('', `### Related identifiers (${r.related_identifier_count})`, ...r.related_identifiers.map(renderRelated));
             }
             if (r.description) {
                 lines.push('', `### Description (${r.description_length ?? r.description.length} chars${r.description_truncated ? ', truncated to 4,000' : ''})`, quoteBlock(r.description));
@@ -547,15 +889,19 @@ export const getRecord = tool('zenodo_get_record', {
             else if (r.description_length !== undefined || r.description_truncated !== undefined) {
                 lines.push(`Description length: ${r.description_length}, truncated: ${r.description_truncated}`);
             }
-            for (const d of r.additional_descriptions) {
-                lines.push('', `### Additional description${d.type ? ` — ${inline(d.type)}` : ''}`, quoteBlock(d.text));
-            }
+            r.additional_descriptions.forEach((d, i) => {
+                lines.push(...renderAdditionalDescription(d, i, r.additional_description_count));
+            });
             const files = r.files;
             lines.push('', `### Files (enabled: ${files.enabled}, count: ${files.count ?? 'not disclosed'}, total bytes: ${files.total_bytes ?? 'not disclosed'}, shown: ${files.shown})`);
             for (const f of files.entries) {
                 lines.push(`- ${inline(f.key)} — ${f.size ?? '?'} bytes${f.mimetype ? `, ${inline(f.mimetype)}` : ''}${f.md5 ? `, md5 ${inline(f.md5)}` : ''} — ${f.download_url}`);
             }
         }
+        if (result.window)
+            lines.push(...renderWindow(result.window));
+        if (result.continuations)
+            lines.push(...renderContinuations(result.continuations));
         if (result.citation) {
             lines.push('', quoteBlock(result.citation, `Citation (${result.citation_style ?? 'requested style'}, untrusted):`));
         }