@cyanheads/zenodo-mcp-server 0.1.1

package/dist/mcp-server/tools/record-miss.js

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview The `found: false` outcome zenodo_get_record and zenodo_list_versions
+ * share: the removal-tombstone schema and the `miss_kind` + guidance for each way an
+ * id can fail to resolve, so both tools describe a miss identically.
+ * @module mcp-server/tools/record-miss
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** Output schema of a deleted record's removal tombstone. */
+export const TombstoneSchema = z
+    .object({
+    removal_date: z.string().optional().describe('When the record was removed (ISO 8601).'),
+    removal_reason: z.string().optional().describe('Removal reason id, e.g. spam or retracted.'),
+    note: z.string().optional().describe('Removal note, when non-empty.'),
+    citation_text: z
+        .string()
+        .optional()
+        .describe('The citation the tombstone still serves — the only bibliographic data a deleted record keeps.'),
+})
+    .describe('Removal tombstone of a deleted record.');
+/** `miss_kind`, guidance, and (for a deleted record) the tombstone of a record GET that found nothing. */
+export function recordMiss(recid, lookup) {
+    switch (lookup.status) {
+        case 'not_found':
+            return {
+                miss_kind: 'not_found',
+                guidance: `No Zenodo record has id ${recid}; it may never have existed. Search by title with zenodo_search_records, or by query doi:"10.5281/zenodo.${recid}" with all_versions true.`,
+            };
+        case 'deleted': {
+            const { tombstone } = lookup;
+            const date = tombstone.removal_date?.slice(0, 10) ?? 'an unrecorded date';
+            return {
+                miss_kind: 'deleted',
+                guidance: `Record ${recid} was removed from Zenodo on ${date} (reason: ${tombstone.removal_reason ?? 'not given'}); only its tombstone citation remains. Find a replacement or another version by title with zenodo_search_records.`,
+                tombstone,
+            };
+        }
+        case 'restricted':
+            return {
+                miss_kind: 'restricted',
+                guidance: `Record ${recid} exists but its metadata is restricted to authorized users and cannot be read anonymously.`,
+            };
+    }
+}
+/** `miss_kind` and guidance for a non-Zenodo DOI that no Zenodo record carries. */
+export function notOnZenodoMiss(doi) {
+    return {
+        miss_kind: 'not_on_zenodo',
+        guidance: `DOI ${doi} is not registered to a Zenodo record. It resolves elsewhere at https://doi.org/${doi}; to find a related deposit, search by title with zenodo_search_records.`,
+    };
+}
+//# sourceMappingURL=record-miss.js.map

package/dist/mcp-server/tools/record-miss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-miss.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/record-miss.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACvF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC5F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACrE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+FAA+F,CAChG;CACJ,CAAC;KACD,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AAEtD,0GAA0G;AAC1G,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAkD;IAC1F,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,WAAW;YACd,OAAO;gBACL,SAAS,EAAE,WAAoB;gBAC/B,QAAQ,EAAE,2BAA2B,KAAK,4GAA4G,KAAK,2BAA2B;aACvL,CAAC;QACJ,KAAK,SAAS,EAAE,CAAC;YACf,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;YAC7B,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,oBAAoB,CAAC;YAC1E,OAAO;gBACL,SAAS,EAAE,SAAkB;gBAC7B,QAAQ,EAAE,UAAU,KAAK,+BAA+B,IAAI,aAAa,SAAS,CAAC,cAAc,IAAI,WAAW,oHAAoH;gBACpO,SAAS;aACV,CAAC;QACJ,CAAC;QACD,KAAK,YAAY;YACf,OAAO;gBACL,SAAS,EAAE,YAAqB;gBAChC,QAAQ,EAAE,UAAU,KAAK,4FAA4F;aACtH,CAAC;IACN,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO;QACL,SAAS,EAAE,eAAwB;QACnC,QAAQ,EAAE,OAAO,GAAG,mFAAmF,GAAG,0EAA0E;KACrL,CAAC;AACJ,CAAC"}

package/dist/mcp-server/tools/render.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Render helpers every Zenodo tool's `format()` uses for untrusted,
+ * depositor-supplied text: `inline` for single-line slots, `quoteBlock` for
+ * multi-line fields, `fence` for file previews. They keep upstream text readable as
+ * data and stop it from breaking out of the slot it is rendered in.
+ * @module mcp-server/tools/render
+ */
+/**
+ * Flattens a string for an inline slot (a title, name, keyword, file key): every
+ * run of CR, LF, NEL, U+2028, or U+2029 becomes one space.
+ */
+export declare function inline(s: string): string;
+/** True when `s` holds a line break {@link inline} would flatten \u2014 the cue to render it with {@link quoteBlock}. */
+export declare function hasLineBreak(s: string): boolean;
+/**
+ * Renders multi-line untrusted text as a blockquote under a lead line. Every line —
+ * split on CRLF, CR, LF, NEL, U+2028, and U+2029 — gets a `> ` prefix, so nothing
+ * in the text can end the quote.
+ */
+export declare function quoteBlock(text: string, lead?: string): string;
+/**
+ * Renders file content inside a code fence whose backtick run is one longer than
+ * the longest run in the content (minimum 3), preceded by a line naming the source
+ * as untrusted data. Lines are split on CR, LF, and CRLF.
+ */
+export declare function fence(text: string, source: {
+    key: string;
+    lang?: string;
+    recid: string;
+}): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/mcp-server/tools/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,yHAAyH;AACzH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAyC,GAAG,MAAM,CAG9F;AASD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CASjG"}

package/dist/mcp-server/tools/render.js

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Render helpers every Zenodo tool's `format()` uses for untrusted,
+ * depositor-supplied text: `inline` for single-line slots, `quoteBlock` for
+ * multi-line fields, `fence` for file previews. They keep upstream text readable as
+ * data and stop it from breaking out of the slot it is rendered in.
+ * @module mcp-server/tools/render
+ */
+const INLINE_BREAKS = /[\r\n\u0085\u2028\u2029]+/g;
+const LINE_BREAK = /[\r\n\u0085\u2028\u2029]/;
+const LINE_SPLIT = /\r\n|[\r\n\u0085\u2028\u2029]/;
+/**
+ * Flattens a string for an inline slot (a title, name, keyword, file key): every
+ * run of CR, LF, NEL, U+2028, or U+2029 becomes one space.
+ */
+export function inline(s) {
+    return s.replace(INLINE_BREAKS, ' ');
+}
+/** True when `s` holds a line break {@link inline} would flatten \u2014 the cue to render it with {@link quoteBlock}. */
+export function hasLineBreak(s) {
+    return LINE_BREAK.test(s);
+}
+/**
+ * Renders multi-line untrusted text as a blockquote under a lead line. Every line —
+ * split on CRLF, CR, LF, NEL, U+2028, and U+2029 — gets a `> ` prefix, so nothing
+ * in the text can end the quote.
+ */
+export function quoteBlock(text, lead = 'Depositor-supplied text (untrusted):') {
+    const lines = text.split(LINE_SPLIT).map((line) => (line ? `> ${line}` : '>'));
+    return [lead, ...lines].join('\n');
+}
+/** Longest run of consecutive backticks in `text`. */
+function longestBacktickRun(text) {
+    let longest = 0;
+    for (const run of text.match(/`+/g) ?? [])
+        longest = Math.max(longest, run.length);
+    return longest;
+}
+/**
+ * Renders file content inside a code fence whose backtick run is one longer than
+ * the longest run in the content (minimum 3), preceded by a line naming the source
+ * as untrusted data. Lines are split on CR, LF, and CRLF.
+ */
+export function fence(text, source) {
+    const ticks = '`'.repeat(Math.max(3, longestBacktickRun(text) + 1));
+    const body = text.split(/\r\n|[\r\n]/).join('\n');
+    return [
+        `Untrusted file content from Zenodo record ${source.recid}, ${inline(source.key)} — shown as data:`,
+        `${ticks}${source.lang ?? ''}`,
+        body,
+        ticks,
+    ].join('\n');
+}
+//# sourceMappingURL=render.js.map

package/dist/mcp-server/tools/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,aAAa,GAAG,4BAA4B,CAAC;AACnD,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAC9C,MAAM,UAAU,GAAG,+BAA+B,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,yHAAyH;AACzH,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAI,GAAG,sCAAsC;IACpF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/E,OAAO,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,sDAAsD;AACtD,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,MAAqD;IACvF,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO;QACL,6CAA6C,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB;QACnG,GAAG,KAAK,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE;QAC9B,IAAI;QACJ,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/mcp-server/tools/schema-helpers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Input preprocessors shared by the Zenodo tools. Form clients submit
+ * every optional field, blank ones as `''`; these make a blank value read as unset
+ * so no optional field needs `.min(1)`. Enum inputs also fold case and separators
+ * and accept one-to-one aliases before the enum check.
+ * @module mcp-server/tools/schema-helpers
+ */
+/** Trims a string; `''` or whitespace-only → `undefined`, so a blank form field reads as "not set". */
+export declare const blankToUndefined: (v: unknown) => unknown;
+/** A lone string becomes a one-element array; blank elements are dropped, and an array left empty reads as unset. */
+export declare const toOptionalArray: (v: unknown) => unknown;
+/**
+ * Preprocess for an enum input. A blank value reads as unset; a value whose case- and
+ * separator-folded form names exactly one option, or one of the listed aliases, maps
+ * to that option. Anything else passes through unchanged, so the enum still rejects
+ * it with the valid options listed. The advertised JSON Schema keeps the canonical
+ * enum: the mapping runs before validation and changes nothing a client sees.
+ */
+export declare function enumPreprocess<const T extends readonly [string, ...string[]]>(options: T, aliases?: Readonly<Record<string, T[number]>>): (v: unknown) => unknown;
+//# sourceMappingURL=schema-helpers.d.ts.map

package/dist/mcp-server/tools/schema-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/schema-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,MAAO,OAAO,KAAG,OAI7C,CAAC;AAEF,qHAAqH;AACrH,eAAO,MAAM,eAAe,MAAO,OAAO,KAAG,OAM5C,CAAC;AAKF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAC3E,OAAO,EAAE,CAAC,EACV,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,GAChD,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAQzB"}

package/dist/mcp-server/tools/schema-helpers.js

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Input preprocessors shared by the Zenodo tools. Form clients submit
+ * every optional field, blank ones as `''`; these make a blank value read as unset
+ * so no optional field needs `.min(1)`. Enum inputs also fold case and separators
+ * and accept one-to-one aliases before the enum check.
+ * @module mcp-server/tools/schema-helpers
+ */
+/** Trims a string; `''` or whitespace-only → `undefined`, so a blank form field reads as "not set". */
+export const blankToUndefined = (v) => {
+    if (typeof v !== 'string')
+        return v;
+    const trimmed = v.trim();
+    return trimmed === '' ? undefined : trimmed;
+};
+/** A lone string becomes a one-element array; blank elements are dropped, and an array left empty reads as unset. */
+export const toOptionalArray = (v) => {
+    const b = blankToUndefined(v);
+    const arr = typeof b === 'string' ? [b] : b;
+    if (!Array.isArray(arr))
+        return arr;
+    const kept = arr.map(blankToUndefined).filter((x) => x !== undefined);
+    return kept.length ? kept : undefined;
+};
+/** Folds case and separators, so `Metadata Only`, `metadata_only`, and `METADATA-ONLY` compare equal. */
+const foldEnumKey = (s) => s.toLowerCase().replace(/[\s_-]+/g, '');
+/**
+ * Preprocess for an enum input. A blank value reads as unset; a value whose case- and
+ * separator-folded form names exactly one option, or one of the listed aliases, maps
+ * to that option. Anything else passes through unchanged, so the enum still rejects
+ * it with the valid options listed. The advertised JSON Schema keeps the canonical
+ * enum: the mapping runs before validation and changes nothing a client sees.
+ */
+export function enumPreprocess(options, aliases = {}) {
+    const table = new Map();
+    for (const [alias, option] of Object.entries(aliases))
+        table.set(foldEnumKey(alias), option);
+    for (const option of options)
+        table.set(foldEnumKey(option), option);
+    return (v) => {
+        const b = blankToUndefined(v);
+        return typeof b === 'string' ? (table.get(foldEnumKey(b)) ?? b) : b;
+    };
+}
+//# sourceMappingURL=schema-helpers.js.map

package/dist/mcp-server/tools/schema-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-helpers.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/schema-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uGAAuG;AACvG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAU,EAAW,EAAE;IACtD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC,CAAC;AAEF,qHAAqH;AACrH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAU,EAAW,EAAE;IACrD,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACxC,CAAC,CAAC;AAEF,yGAAyG;AACzG,MAAM,WAAW,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAU,EACV,OAAO,GAAwC,EAAE;IAEjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7F,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACrE,OAAO,CAAC,CAAC,EAAE,EAAE;QACX,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC"}

package/dist/services/zenodo/cache.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Process-local TTL LRU cache with an approximate byte budget. Zenodo
+ * data is public, so one cache is shared across tenants; hits save the shared
+ * egress IP's rate budget.
+ * @module services/zenodo/cache
+ */
+/** Budget options for {@link TtlLruCache}. */
+export interface CacheOptions {
+    /** Approximate total budget across all entries. */
+    maxBytes: number;
+    /** Entries estimated above this size are not stored. */
+    maxEntryBytes: number;
+}
+/** In-memory TTL cache, least-recently-used eviction by approximate byte size. */
+export declare class TtlLruCache {
+    #private;
+    constructor(options: CacheOptions);
+    /** Returns the live value for `key` (refreshing its recency), or `undefined`. */
+    get<T>(key: string): T | undefined;
+    /** Stores `value` for `ttlMs`. Oversized values are skipped; older entries are evicted to fit. */
+    set(key: string, value: unknown, ttlMs: number): void;
+    /** Drops every entry. */
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/services/zenodo/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/services/zenodo/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAOD,kFAAkF;AAClF,qBAAa,WAAW;;IAKtB,YAAY,OAAO,EAAE,YAAY,EAEhC;IAED,iFAAiF;IACjF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAUjC;IAED,kGAAkG;IAClG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWpD;IAED,yBAAyB;IACzB,KAAK,IAAI,IAAI,CAGZ;CAMF"}

package/dist/services/zenodo/cache.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Process-local TTL LRU cache with an approximate byte budget. Zenodo
+ * data is public, so one cache is shared across tenants; hits save the shared
+ * egress IP's rate budget.
+ * @module services/zenodo/cache
+ */
+/** Approximate size of a JSON-shaped value: its serialized length. */
+function estimateBytes(value) {
+    return value === undefined ? 0 : (JSON.stringify(value)?.length ?? 0);
+}
+/** In-memory TTL cache, least-recently-used eviction by approximate byte size. */
+export class TtlLruCache {
+    #entries = new Map();
+    #options;
+    #bytes = 0;
+    constructor(options) {
+        this.#options = options;
+    }
+    /** Returns the live value for `key` (refreshing its recency), or `undefined`. */
+    get(key) {
+        const entry = this.#entries.get(key);
+        if (!entry)
+            return;
+        if (entry.expiresAt <= Date.now()) {
+            this.#delete(key, entry);
+            return;
+        }
+        this.#entries.delete(key);
+        this.#entries.set(key, entry);
+        return entry.value;
+    }
+    /** Stores `value` for `ttlMs`. Oversized values are skipped; older entries are evicted to fit. */
+    set(key, value, ttlMs) {
+        const bytes = estimateBytes(value);
+        const existing = this.#entries.get(key);
+        if (existing)
+            this.#delete(key, existing);
+        if (bytes > this.#options.maxEntryBytes)
+            return;
+        this.#entries.set(key, { bytes, expiresAt: Date.now() + ttlMs, value });
+        this.#bytes += bytes;
+        for (const [oldKey, oldEntry] of this.#entries) {
+            if (this.#bytes <= this.#options.maxBytes)
+                break;
+            this.#delete(oldKey, oldEntry);
+        }
+    }
+    /** Drops every entry. */
+    clear() {
+        this.#entries.clear();
+        this.#bytes = 0;
+    }
+    #delete(key, entry) {
+        this.#entries.delete(key);
+        this.#bytes -= entry.bytes;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/services/zenodo/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/services/zenodo/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,sEAAsE;AACtE,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,kFAAkF;AAClF,MAAM,OAAO,WAAW;IACb,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAC;IACpC,QAAQ,CAAe;IAChC,MAAM,GAAG,CAAC,CAAC;IAEX,YAAY,OAAqB;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,iFAAiF;IACjF,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED,kGAAkG;IAClG,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,KAAa;QAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,QAAQ;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC1C,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa;YAAE,OAAO;QAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACrB,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ;gBAAE,MAAM;YACjD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,KAAY;QAC/B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC;IAC7B,CAAC;CACF"}

package/dist/services/zenodo/html-to-text.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Deterministic HTML → plain-text conversion for depositor-supplied
+ * record descriptions. The one documented transformation of upstream text: drop
+ * script/style, turn block ends and line breaks into newlines, inline link targets,
+ * strip tags, decode entities, normalize whitespace.
+ * @module services/zenodo/html-to-text
+ */
+/**
+ * Decodes numeric (decimal and hex) entities, the fixed named table (any case), and
+ * the Latin-1 named entities (exact case). Unknown names stay as written.
+ */
+export declare function decodeEntities(text: string): string;
+/**
+ * Converts an HTML fragment to plain text:
+ * 1. drops `<script>`/`<style>` elements with their content (and comments);
+ * 2. `<br>` → newline, closing block tags → newline, `<li>` → `- `;
+ * 3. `<a href="X">T</a>` → `T (X)` when X is http(s) and differs from T;
+ * 4. strips remaining tags; 5. decodes entities;
+ * 6. normalizes CRLF/CR to LF, trims trailing spaces per line, collapses 3+
+ *    newlines to 2, and trims the result.
+ */
+export declare function htmlToText(html: string): string;
+//# sourceMappingURL=html-to-text.d.ts.map

package/dist/services/zenodo/html-to-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-text.d.ts","sourceRoot":"","sources":["../../../src/services/zenodo/html-to-text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4CH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD;AAgED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB/C"}

package/dist/services/zenodo/html-to-text.js

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Deterministic HTML → plain-text conversion for depositor-supplied
+ * record descriptions. The one documented transformation of upstream text: drop
+ * script/style, turn block ends and line breaks into newlines, inline link targets,
+ * strip tags, decode entities, normalize whitespace.
+ * @module services/zenodo/html-to-text
+ */
+const NAMED_ENTITIES = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    nbsp: ' ',
+    ndash: '–',
+    mdash: '—',
+    hellip: '…',
+    lsquo: '‘',
+    rsquo: '’',
+    ldquo: '“',
+    rdquo: '”',
+    copy: '©',
+    reg: '®',
+    deg: '°',
+};
+/**
+ * The HTML 4 Latin-1 entities (U+00A0–U+00FF), case-sensitive. Zenodo's
+ * description editor stores accented letters as named entities (`n&uacute;meros`),
+ * so non-English descriptions stay unreadable without them.
+ */
+const LATIN1_ENTITIES = Object.fromEntries('AElig:198 Aacute:193 Acirc:194 Agrave:192 Aring:197 Atilde:195 Auml:196 Ccedil:199 ETH:208 Eacute:201 Ecirc:202 Egrave:200 Euml:203 Iacute:205 Icirc:206 Igrave:204 Iuml:207 Ntilde:209 Oacute:211 Ocirc:212 Ograve:210 Oslash:216 Otilde:213 Ouml:214 THORN:222 Uacute:218 Ucirc:219 Ugrave:217 Uuml:220 Yacute:221 aacute:225 acirc:226 acute:180 aelig:230 agrave:224 aring:229 atilde:227 auml:228 brvbar:166 ccedil:231 cedil:184 cent:162 curren:164 divide:247 eacute:233 ecirc:234 egrave:232 eth:240 euml:235 frac12:189 frac14:188 frac34:190 iacute:237 icirc:238 iexcl:161 igrave:236 iquest:191 iuml:239 laquo:171 macr:175 micro:181 middot:183 not:172 ntilde:241 oacute:243 ocirc:244 ograve:242 ordf:170 ordm:186 oslash:248 otilde:245 ouml:246 para:182 plusmn:177 pound:163 raquo:187 sect:167 shy:173 sup1:185 sup2:178 sup3:179 szlig:223 thorn:254 times:215 uacute:250 ucirc:251 ugrave:249 uml:168 uuml:252 yacute:253 yen:165 yuml:255'
+    .split(' ')
+    .map((pair) => {
+    const [name, code] = pair.split(':');
+    return [name, Number(code)];
+}));
+function codePointToString(codePoint) {
+    return Number.isInteger(codePoint) &&
+        codePoint > 0 &&
+        codePoint <= 0x10ffff &&
+        (codePoint < 0xd800 || codePoint > 0xdfff)
+        ? String.fromCodePoint(codePoint)
+        : '\uFFFD';
+}
+/**
+ * Decodes numeric (decimal and hex) entities, the fixed named table (any case), and
+ * the Latin-1 named entities (exact case). Unknown names stay as written.
+ */
+export function decodeEntities(text) {
+    return text.replace(/&(#x[0-9a-f]+|#\d+|[a-z][a-z0-9]*);/gi, (match, body) => {
+        if (body[0] === '#') {
+            const hex = body[1] === 'x' || body[1] === 'X';
+            return codePointToString(Number.parseInt(body.slice(hex ? 2 : 1), hex ? 16 : 10));
+        }
+        const named = NAMED_ENTITIES[body.toLowerCase()];
+        if (named !== undefined)
+            return named;
+        const latin1 = LATIN1_ENTITIES[body];
+        return latin1 === undefined ? match : String.fromCodePoint(latin1);
+    });
+}
+/** Re-escapes the characters entity decoding would otherwise read twice. */
+function escapeForDecode(text) {
+    return text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
+}
+/**
+ * Every pattern and scan below stays linear on hostile input: descriptions are
+ * depositor-supplied and converted for every search hit, so a pattern that rescans
+ * to the end of the text from each `<` (or each space) would let one deposit stall
+ * the server. Tag patterns stop at the next `<` or `>` instead of scanning past it.
+ */
+/** Drops every `<…>` tag: each `<` through the next `>`, as `/<[^>]*>/g` would, in one pass. */
+function stripTags(html) {
+    let out = '';
+    let from = 0;
+    for (;;) {
+        const open = html.indexOf('<', from);
+        const close = open === -1 ? -1 : html.indexOf('>', open);
+        if (close === -1)
+            return out + html.slice(from);
+        out += html.slice(from, open);
+        from = close + 1;
+    }
+}
+const HREF = /\bhref\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i;
+/**
+ * `<a href="X">T</a>` → `T (X)` when X is http(s) and differs from T, else `T`.
+ * Each closing tag is searched for once, from its opening tag; with none left, the
+ * remaining links stay as they are.
+ */
+function inlineLinks(html) {
+    const openTag = /<a\b([^<>]*)>/gi;
+    const closeTag = /<\/a\s*>/gi;
+    let out = '';
+    let from = 0;
+    for (let open = openTag.exec(html); open; open = openTag.exec(html)) {
+        const attr = HREF.exec(open[1] ?? '');
+        if (!attr)
+            continue;
+        closeTag.lastIndex = openTag.lastIndex;
+        const close = closeTag.exec(html);
+        if (!close)
+            break;
+        const inner = html.slice(openTag.lastIndex, close.index);
+        const href = decodeEntities(attr[1] ?? attr[2] ?? attr[3] ?? '').trim();
+        const text = decodeEntities(stripTags(inner)).trim();
+        out +=
+            html.slice(from, open.index) +
+                (/^https?:\/\//i.test(href) && href !== text ? `${inner} (${escapeForDecode(href)})` : inner);
+        from = close.index + close[0].length;
+        openTag.lastIndex = from;
+    }
+    return out + html.slice(from);
+}
+/** `line` without trailing spaces and tabs. */
+function trimTrailingBlanks(line) {
+    let end = line.length;
+    while (end > 0 && (line[end - 1] === ' ' || line[end - 1] === '\t'))
+        end--;
+    return line.slice(0, end);
+}
+/**
+ * Converts an HTML fragment to plain text:
+ * 1. drops `<script>`/`<style>` elements with their content (and comments);
+ * 2. `<br>` → newline, closing block tags → newline, `<li>` → `- `;
+ * 3. `<a href="X">T</a>` → `T (X)` when X is http(s) and differs from T;
+ * 4. strips remaining tags; 5. decodes entities;
+ * 6. normalizes CRLF/CR to LF, trims trailing spaces per line, collapses 3+
+ *    newlines to 2, and trims the result.
+ */
+export function htmlToText(html) {
+    let s = html
+        .replace(/<!--[\s\S]*?(?:-->|$)/g, '')
+        .replace(/<(script|style)\b[^<>]*>[\s\S]*?(?:<\/\1\s*>|$)/gi, '');
+    s = s
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/(?:p|div|h[1-6]|li|tr|blockquote|pre|ul|ol|table)\s*>/gi, '\n')
+        .replace(/<li\b[^<>]*>/gi, '- ');
+    s = decodeEntities(stripTags(inlineLinks(s)));
+    return s
+        .replace(/\r\n?/g, '\n')
+        .split('\n')
+        .map(trimTrailingBlanks)
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+//# sourceMappingURL=html-to-text.js.map

package/dist/services/zenodo/html-to-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-text.js","sourceRoot":"","sources":["../../../src/services/zenodo/html-to-text.ts"],"names":[],"mappings":"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"}

package/dist/services/zenodo/http.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview The single fetch boundary to the Zenodo REST API. Per-call status
+ * accept-lists (206/301/302/403/404/410/416 are outcomes here, not errors), the
+ * rate-limit header gate, two pacers (search and general buckets), and the retry
+ * matrix. Only paths the service builds are fetched, against a constant base URL,
+ * and redirects are followed only within zenodo.org.
+ * @module services/zenodo/http
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+/** Upstream rate-limit bucket. `search` is the record-search list only (30/min). */
+export type Bucket = 'search' | 'general';
+/**
+ * Which row of the retry matrix a call follows: `search` (record search),
+ * `doi_lookup` (the server-built DOI search), `record` (record GET), `versions`
+ * (`/versions`), `archive` (a ZIP's `/container` listing or member read), `other`
+ * (file content, `versions/latest`, citations, vocabularies).
+ */
+export type EndpointKind = 'search' | 'doi_lookup' | 'record' | 'versions' | 'archive' | 'other';
+/** One upstream request as the service builds it. */
+export interface ZenodoRequest {
+    accept: string;
+    /** Per-attempt time budget (capped by the ladder's remaining budget). */
+    attemptMs: number;
+    bucket: Bucket;
+    /** `archive` endpoints: the archive's download URL, named in a typed failure. */
+    downloadUrl?: string;
+    endpoint: EndpointKind;
+    /** Statuses returned to the caller as results rather than mapped to errors. */
+    okStatuses: readonly number[];
+    /** Log label. */
+    operation: string;
+    /** Path under `/api`, starting with `/`, already percent-encoded. */
+    path: string;
+    query?: readonly (readonly [string, string])[];
+    range?: string;
+    /** `follow` (default): follow redirects within zenodo.org. `manual`: return the 3xx itself. */
+    redirect?: 'follow' | 'manual';
+}
+/** Per-attempt budgets. Multi-thousand-file record GETs legitimately take 32–34 s. */
+export declare const JSON_ATTEMPT_MS = 45000;
+export declare const CONTENT_ATTEMPT_MS = 20000;
+/** Cancels a response body that will not be read, releasing the connection. */
+export declare function discardBody(res: Response): Promise<void>;
+/** Reads a UTF-8 body of at most {@link MAX_BODY_BYTES}; a larger one is refused, not buffered. */
+export declare function readText(res: Response): Promise<string>;
+/** Reads a JSON body. An HTML page or unparseable body on a 2xx is a transient upstream fault. */
+export declare function readJson<T>(res: Response): Promise<T>;
+/**
+ * Streams a body, keeping at most `maxBytes` after skipping `skipBytes`, and
+ * cancels the stream as soon as the cap is passed. `more` is true when bytes
+ * remained past the cap.
+ */
+export declare function readCapped(res: Response, maxBytes: number, skipBytes?: number): Promise<{
+    bytes: Uint8Array;
+    more: boolean;
+}>;
+/** The HTTP client: pacing, header gate, retry ladder, and status mapping. */
+export declare class ZenodoHttp {
+    #private;
+    constructor(options: {
+        accessToken?: string | undefined;
+        userAgent: string;
+    });
+    /** Rejects queued waiters and clears the pacers' timers. */
+    dispose(): void;
+    /**
+     * Runs one request through the retry ladder (outside) and the bucket's pacer
+     * (inside). `read` consumes the response of an accepted status and runs inside
+     * the attempt, so parse faults are retried with the fetch.
+     */
+    request<T>(req: ZenodoRequest, read: (res: Response) => Promise<T>, ctx: Context): Promise<T>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/services/zenodo/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/services/zenodo/http.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAuBtD,oFAAoF;AACpF,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjG,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,+EAA+E;IAC/E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED,sFAAsF;AACtF,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAyBzC,+EAA+E;AAC/E,wBAAsB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,mGAAmG;AACnG,wBAAsB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7D;AAED,kGAAkG;AAClG,wBAAsB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB3D;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAI,GACZ,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAkC/C;AAED,8EAA8E;AAC9E,qBAAa,UAAU;;IAOrB,YAAY,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAwB3E;IAED,4DAA4D;IAC5D,OAAO,IAAI,IAAI,CAGd;IAED;;;;OAIG;IACG,OAAO,CAAC,CAAC,EACb,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,CAAC,CAAC,CA6BZ;CAiQF"}