@cyanheads/biorxiv-mcp-server 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/AGENTS.md +7 -2
  2. package/CLAUDE.md +7 -2
  3. package/README.md +12 -7
  4. package/changelog/0.2.x/0.2.3.md +26 -0
  5. package/changelog/0.2.x/0.2.4.md +17 -0
  6. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.d.ts +13 -2
  7. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.d.ts.map +1 -1
  8. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.js +45 -5
  9. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.js.map +1 -1
  10. package/dist/mcp-server/tools/definitions/biorxiv-get-preprint.tool.d.ts +11 -0
  11. package/dist/mcp-server/tools/definitions/biorxiv-get-preprint.tool.d.ts.map +1 -1
  12. package/dist/mcp-server/tools/definitions/biorxiv-get-preprint.tool.js +50 -13
  13. package/dist/mcp-server/tools/definitions/biorxiv-get-preprint.tool.js.map +1 -1
  14. package/dist/mcp-server/tools/definitions/biorxiv-get-published-version.tool.d.ts +10 -1
  15. package/dist/mcp-server/tools/definitions/biorxiv-get-published-version.tool.d.ts.map +1 -1
  16. package/dist/mcp-server/tools/definitions/biorxiv-get-published-version.tool.js +26 -1
  17. package/dist/mcp-server/tools/definitions/biorxiv-get-published-version.tool.js.map +1 -1
  18. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.d.ts +16 -0
  19. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.d.ts.map +1 -1
  20. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.js +54 -12
  21. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.js.map +1 -1
  22. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.d.ts +23 -0
  23. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.d.ts.map +1 -1
  24. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.js +85 -19
  25. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.js.map +1 -1
  26. package/dist/mcp-server/tools/definitions/index.d.ts +39 -2
  27. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  28. package/dist/services/biorxiv/biorxiv-service.d.ts +7 -1
  29. package/dist/services/biorxiv/biorxiv-service.d.ts.map +1 -1
  30. package/dist/services/biorxiv/biorxiv-service.js +148 -92
  31. package/dist/services/biorxiv/biorxiv-service.js.map +1 -1
  32. package/dist/services/biorxiv-fulltext/biorxiv-fulltext-service.d.ts.map +1 -1
  33. package/dist/services/biorxiv-fulltext/biorxiv-fulltext-service.js +1 -19
  34. package/dist/services/biorxiv-fulltext/biorxiv-fulltext-service.js.map +1 -1
  35. package/dist/services/europe-pmc/europe-pmc-service.d.ts +4 -0
  36. package/dist/services/europe-pmc/europe-pmc-service.d.ts.map +1 -1
  37. package/dist/services/europe-pmc/europe-pmc-service.js +83 -35
  38. package/dist/services/europe-pmc/europe-pmc-service.js.map +1 -1
  39. package/dist/services/shared.d.ts +35 -2
  40. package/dist/services/shared.d.ts.map +1 -1
  41. package/dist/services/shared.js +64 -2
  42. package/dist/services/shared.js.map +1 -1
  43. package/package.json +1 -1
  44. package/server.json +3 -3
@@ -1 +1 @@
1
- {"version":3,"file":"biorxiv-fulltext-service.js","sourceRoot":"","sources":["../../../src/services/biorxiv-fulltext/biorxiv-fulltext-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"biorxiv-fulltext-service.js","sourceRoot":"","sources":["../../../src/services/biorxiv-fulltext/biorxiv-fulltext-service.ts"],"names":[],"mappings":"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"}
@@ -3,6 +3,9 @@
3
3
  * for preprint keyword search. Returns ranked DOI lists used by
4
4
  * biorxiv_search_preprints for bioRxiv/medRxiv enrichment. All requests
5
5
  * include a polite User-Agent and are retried with exponential backoff.
6
+ * Detects HTML error pages, and classifies an origin rate limit (HTTP 429) as
7
+ * its own retryable `rate_limited` condition carrying the parsed `Retry-After`
8
+ * wait — never the upstream response body.
6
9
  * @module services/europe-pmc/europe-pmc-service
7
10
  */
8
11
  import type { Context } from '@cyanheads/mcp-ts-core';
@@ -34,6 +37,7 @@ export declare class EuropePmcService {
34
37
  * with DOIs plus the upstream hitCount grand total, used to drive bioRxiv API
35
38
  * enrichment. Requests the minimal field set (doi, title, authorString,
36
39
  * firstPublicationDate, abstractText).
40
+ * Throws a retryable `rate_limited` error when the origin returns HTTP 429.
37
41
  */
38
42
  search(options: SearchOptions, ctx: Context): Promise<EuropePmcSearchResult>;
39
43
  }
@@ -1 +1 @@
1
- {"version":3,"file":"europe-pmc-service.d.ts","sourceRoot":"","sources":["../../../src/services/europe-pmc/europe-pmc-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAMvD;IAED;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAwFjF;CACF;AAMD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAErF;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAItD"}
1
+ {"version":3,"file":"europe-pmc-service.d.ts","sourceRoot":"","sources":["../../../src/services/europe-pmc/europe-pmc-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAWrE,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AA+CpB,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAMvD;IAED;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA6FjF;CACF;AAMD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAErF;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAItD"}
@@ -3,12 +3,53 @@
3
3
  * for preprint keyword search. Returns ranked DOI lists used by
4
4
  * biorxiv_search_preprints for bioRxiv/medRxiv enrichment. All requests
5
5
  * include a polite User-Agent and are retried with exponential backoff.
6
+ * Detects HTML error pages, and classifies an origin rate limit (HTTP 429) as
7
+ * its own retryable `rate_limited` condition carrying the parsed `Retry-After`
8
+ * wait — never the upstream response body.
6
9
  * @module services/europe-pmc/europe-pmc-service
7
10
  */
8
- import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
11
+ import { McpError, rateLimited, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
9
12
  import { fetchWithTimeout, withRetry } from '@cyanheads/mcp-ts-core/utils';
10
13
  import { getServerConfig } from '../../config/server-config.js';
11
- import { asRc, detectHtmlError, normalizeUpstreamText, SERVER_VERSION } from '../../services/shared.js';
14
+ import { asRc, describeWait, detectHtmlError, normalizeUpstreamText, parseRetryAfterSeconds, SERVER_VERSION, } from '../../services/shared.js';
15
+ /**
16
+ * The one status this service classifies itself rather than treating as a bug.
17
+ * Passing it to `fetchWithTimeout` only lowers the log severity from `error` to
18
+ * `debug`; the thrown error and its classification are unchanged.
19
+ */
20
+ const EXPECTED_STATUSES = [429];
21
+ /**
22
+ * Re-throws a failed EuropePMC call, classifying HTTP 429 as its own retryable
23
+ * `rate_limited` condition. Everything else — 5xx, timeout, network error, the
24
+ * HTML-error guard below — re-throws untouched for the framework's
25
+ * auto-classifier.
26
+ *
27
+ * `fetchWithTimeout` attaches the upstream response body to `err.data`
28
+ * (`body`/`responseBody`), so the replacement payload is built from scratch
29
+ * rather than spread: only the parsed `Retry-After` crosses into it. Retry is
30
+ * not this function's concern — `withRetry` already honors `data.retryAfter`
31
+ * and fails fast when the requested wait exceeds its cap, so by the time a 429
32
+ * reaches here the waiting is over and only classification is left.
33
+ */
34
+ function rethrowClassified(err) {
35
+ const data = err instanceof McpError
36
+ ? err.data
37
+ : undefined;
38
+ if (data?.status !== 429)
39
+ throw err;
40
+ const retryAfter = parseRetryAfterSeconds(data.retryAfter);
41
+ const wait = describeWait(retryAfter);
42
+ throw rateLimited(retryAfter === undefined
43
+ ? 'EuropePMC is rate-limiting this host (HTTP 429).'
44
+ : `EuropePMC is rate-limiting this host (HTTP 429) and asked for a ${retryAfter}-second wait before the next request.`, {
45
+ reason: 'rate_limited',
46
+ retryable: true,
47
+ ...(retryAfter !== undefined && { retryAfter }),
48
+ recovery: {
49
+ hint: `Wait ${wait} before querying EuropePMC again — only keyword search reaches this origin, so preprint metadata lookups on api.biorxiv.org are outside this limit.`,
50
+ },
51
+ }, { cause: err });
52
+ }
12
53
  export class EuropePmcService {
13
54
  baseUrl;
14
55
  userAgent;
@@ -24,6 +65,7 @@ export class EuropePmcService {
24
65
  * with DOIs plus the upstream hitCount grand total, used to drive bioRxiv API
25
66
  * enrichment. Requests the minimal field set (doi, title, authorString,
26
67
  * firstPublicationDate, abstractText).
68
+ * Throws a retryable `rate_limited` error when the origin returns HTTP 429.
27
69
  */
28
70
  async search(options, ctx) {
29
71
  const limit = Math.min(options.limit ?? 25, 100);
@@ -68,42 +110,48 @@ export class EuropePmcService {
68
110
  });
69
111
  const url = `${this.baseUrl}/search?${params.toString()}&filter=${filterParam}`;
70
112
  const rc = asRc(ctx);
71
- return await withRetry(async () => {
72
- const response = await fetchWithTimeout(url, 20_000, rc, {
73
- signal: ctx.signal,
74
- headers: { 'User-Agent': this.userAgent },
75
- });
76
- const text = await response.text();
77
- if (detectHtmlError(text)) {
78
- throw serviceUnavailable('EuropePMC returned HTML instead of JSON — service may be degraded.', { url });
79
- }
80
- const data = JSON.parse(text);
81
- const results = (data.resultList?.result ?? [])
82
- .filter((raw) => raw.doi != null)
83
- .map((raw) => {
84
- const title = normalizeUpstreamText(raw.title);
85
- const abstract = normalizeUpstreamText(raw.abstractText);
113
+ try {
114
+ return await withRetry(async () => {
115
+ const response = await fetchWithTimeout(url, 20_000, rc, {
116
+ signal: ctx.signal,
117
+ headers: { 'User-Agent': this.userAgent },
118
+ expectedStatuses: EXPECTED_STATUSES,
119
+ });
120
+ const text = await response.text();
121
+ if (detectHtmlError(text)) {
122
+ throw serviceUnavailable('EuropePMC returned HTML instead of JSON — service may be degraded.', { url });
123
+ }
124
+ const data = JSON.parse(text);
125
+ const results = (data.resultList?.result ?? [])
126
+ .filter((raw) => raw.doi != null)
127
+ .map((raw) => {
128
+ const title = normalizeUpstreamText(raw.title);
129
+ const abstract = normalizeUpstreamText(raw.abstractText);
130
+ return {
131
+ doi: raw.doi,
132
+ ...(title && { title }),
133
+ ...(raw.authorString && { authors: raw.authorString }),
134
+ ...(raw.firstPublicationDate && { publishedDate: raw.firstPublicationDate }),
135
+ ...(abstract && { abstract }),
136
+ };
137
+ });
86
138
  return {
87
- doi: raw.doi,
88
- ...(title && { title }),
89
- ...(raw.authorString && { authors: raw.authorString }),
90
- ...(raw.firstPublicationDate && { publishedDate: raw.firstPublicationDate }),
91
- ...(abstract && { abstract }),
139
+ hitCount: data.hitCount ?? results.length,
140
+ results,
141
+ // Absent on the last page (EuropePMC omits it) — omit here too so
142
+ // callers read "no field" as "no more pages".
143
+ ...(data.nextCursorMark && { nextCursorMark: data.nextCursorMark }),
92
144
  };
145
+ }, {
146
+ operation: 'EuropePmcService.search',
147
+ context: rc,
148
+ baseDelayMs: 300,
149
+ signal: ctx.signal,
93
150
  });
94
- return {
95
- hitCount: data.hitCount ?? results.length,
96
- results,
97
- // Absent on the last page (EuropePMC omits it) — omit here too so
98
- // callers read "no field" as "no more pages".
99
- ...(data.nextCursorMark && { nextCursorMark: data.nextCursorMark }),
100
- };
101
- }, {
102
- operation: 'EuropePmcService.search',
103
- context: rc,
104
- baseDelayMs: 300,
105
- signal: ctx.signal,
106
- });
151
+ }
152
+ catch (err) {
153
+ rethrowClassified(err);
154
+ }
107
155
  }
108
156
  }
109
157
  // ─── Init / accessor ─────────────────────────────────────────────────────────
@@ -1 +1 @@
1
- {"version":3,"file":"europe-pmc-service.js","sourceRoot":"","sources":["../../../src/services/europe-pmc/europe-pmc-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"europe-pmc-service.js","sourceRoot":"","sources":["../../../src/services/europe-pmc/europe-pmc-service.ts"],"names":[],"mappings":"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"}
@@ -1,7 +1,9 @@
1
1
  /**
2
2
  * @fileoverview Shared utilities for biorxiv-mcp-server service layer. Provides
3
- * the Context→RequestContext cast, HTML error detection, and the server version
4
- * string used in User-Agent headers across all services.
3
+ * the Context→RequestContext cast, HTML error detection, calendar-date and
4
+ * upstream-text normalization, `Retry-After` parsing and rate-limit rejection
5
+ * lookup shared by every fetch path, and the server version string used in
6
+ * User-Agent headers across all services.
5
7
  * @module services/shared
6
8
  */
7
9
  import type { Context } from '@cyanheads/mcp-ts-core';
@@ -45,6 +47,37 @@ export declare function isValidCalendarDate(dateStr: string): boolean;
45
47
  * fields as absent rather than as empty strings.
46
48
  */
47
49
  export declare function normalizeUpstreamText(text: string | undefined): string | undefined;
50
+ /**
51
+ * Reads a `Retry-After` header value as a wait in whole seconds. RFC 9110 §10.2.3
52
+ * allows either delta-seconds or an HTTP-date; the date form is converted to a
53
+ * wait from now and clamped at zero. Returns undefined for an absent, malformed,
54
+ * or unparseable value so callers fall back to generic wording rather than
55
+ * echoing an uninterpretable header into agent-facing prose.
56
+ *
57
+ * Shared by every fetch path — the JSON API, the full-text article origin, and
58
+ * EuropePMC each surface the same header and must read it identically.
59
+ */
60
+ export declare function parseRetryAfterSeconds(raw: unknown): number | undefined;
61
+ /**
62
+ * Finds an origin rate limit among a set of rejections, recognising the
63
+ * `reason: 'rate_limited'` marker this server's services attach when they
64
+ * classify an HTTP 429. Returns the wait the caller should honor — the longest
65
+ * of the reported ones, since a shorter wait would still land inside whichever
66
+ * origin asked for the longer one — or an empty object when a rate limit fired
67
+ * without a usable `Retry-After`. Returns undefined when no rejection was a
68
+ * rate limit, so callers fall through to their generic upstream-failure
69
+ * contract entry.
70
+ */
71
+ export declare function findRateLimit(errors: readonly unknown[]): {
72
+ retryAfter?: number;
73
+ } | undefined;
74
+ /**
75
+ * Renders a `Retry-After` wait as the phrase every rate-limit recovery hint
76
+ * interpolates, so the wording an agent reads is identical whichever origin or
77
+ * tool produced the limit — including the fallback for a 429 whose response
78
+ * named no usable wait.
79
+ */
80
+ export declare function describeWait(seconds: number | undefined): string;
48
81
  /**
49
82
  * Version string used in outbound User-Agent headers. Derived from package.json
50
83
  * (the single source of truth) so it can never drift from the released version.
@@ -1 +1 @@
1
- {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/services/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE;;;GAGG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAEjD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU5D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAuBlF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,MAA4B,CAAC"}
1
+ {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/services/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE;;;GAGG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAEjD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU5D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAuBlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAiB7F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEhE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,MAA4B,CAAC"}
@@ -1,9 +1,12 @@
1
1
  /**
2
2
  * @fileoverview Shared utilities for biorxiv-mcp-server service layer. Provides
3
- * the Context→RequestContext cast, HTML error detection, and the server version
4
- * string used in User-Agent headers across all services.
3
+ * the Context→RequestContext cast, HTML error detection, calendar-date and
4
+ * upstream-text normalization, `Retry-After` parsing and rate-limit rejection
5
+ * lookup shared by every fetch path, and the server version string used in
6
+ * User-Agent headers across all services.
5
7
  * @module services/shared
6
8
  */
9
+ import { McpError } from '@cyanheads/mcp-ts-core/errors';
7
10
  import packageJson from '../../package.json' with { type: 'json' };
8
11
  /**
9
12
  * Cast Context to RequestContext for fetchWithTimeout / withRetry.
@@ -81,6 +84,65 @@ export function normalizeUpstreamText(text) {
81
84
  .trim();
82
85
  return cleaned || undefined;
83
86
  }
87
+ /**
88
+ * Reads a `Retry-After` header value as a wait in whole seconds. RFC 9110 §10.2.3
89
+ * allows either delta-seconds or an HTTP-date; the date form is converted to a
90
+ * wait from now and clamped at zero. Returns undefined for an absent, malformed,
91
+ * or unparseable value so callers fall back to generic wording rather than
92
+ * echoing an uninterpretable header into agent-facing prose.
93
+ *
94
+ * Shared by every fetch path — the JSON API, the full-text article origin, and
95
+ * EuropePMC each surface the same header and must read it identically.
96
+ */
97
+ export function parseRetryAfterSeconds(raw) {
98
+ if (typeof raw !== 'string')
99
+ return;
100
+ const trimmed = raw.trim();
101
+ if (/^\d+$/.test(trimmed))
102
+ return Number(trimmed);
103
+ const dateMs = Date.parse(trimmed);
104
+ if (Number.isNaN(dateMs))
105
+ return;
106
+ return Math.max(0, Math.round((dateMs - Date.now()) / 1000));
107
+ }
108
+ /**
109
+ * Finds an origin rate limit among a set of rejections, recognising the
110
+ * `reason: 'rate_limited'` marker this server's services attach when they
111
+ * classify an HTTP 429. Returns the wait the caller should honor — the longest
112
+ * of the reported ones, since a shorter wait would still land inside whichever
113
+ * origin asked for the longer one — or an empty object when a rate limit fired
114
+ * without a usable `Retry-After`. Returns undefined when no rejection was a
115
+ * rate limit, so callers fall through to their generic upstream-failure
116
+ * contract entry.
117
+ */
118
+ export function findRateLimit(errors) {
119
+ let found = false;
120
+ let longest;
121
+ for (const err of errors) {
122
+ if (!(err instanceof McpError))
123
+ continue;
124
+ const data = err.data;
125
+ if (data?.reason !== 'rate_limited')
126
+ continue;
127
+ found = true;
128
+ if (typeof data.retryAfter === 'number' &&
129
+ (longest === undefined || data.retryAfter > longest)) {
130
+ longest = data.retryAfter;
131
+ }
132
+ }
133
+ if (!found)
134
+ return;
135
+ return longest === undefined ? {} : { retryAfter: longest };
136
+ }
137
+ /**
138
+ * Renders a `Retry-After` wait as the phrase every rate-limit recovery hint
139
+ * interpolates, so the wording an agent reads is identical whichever origin or
140
+ * tool produced the limit — including the fallback for a 429 whose response
141
+ * named no usable wait.
142
+ */
143
+ export function describeWait(seconds) {
144
+ return seconds === undefined ? 'a minute or two' : `${seconds} seconds`;
145
+ }
84
146
  /**
85
147
  * Version string used in outbound User-Agent headers. Derived from package.json
86
148
  * (the single source of truth) so it can never drift from the released version.
@@ -1 +1 @@
1
- {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/services/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,GAAY;IAC/B,OAAO,GAAgC,CAAC;AAC1C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,CACL,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,CAChG,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,OAAO,GAAG,IAAI;QAClB,0EAA0E;SACzE,OAAO,CAAC,qBAAqB,EAAE,GAAG,CAAC;QACpC,0EAA0E;SACzE,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC;QAC1C,+EAA+E;SAC9E,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,0EAA0E;SACzE,OAAO,CAAC,0BAA0B,EAAE,GAAG,CAAC;QACzC,4DAA4D;SAC3D,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;QAC7B,0CAA0C;SACzC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC;QACrC,2EAA2E;QAC3E,6DAA6D;SAC5D,OAAO,CAAC,wEAAwE,EAAE,EAAE,CAAC;QACtF,uDAAuD;SACtD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACV,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW,WAAW,CAAC,OAAO,CAAC"}
1
+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/services/shared.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/biorxiv-mcp-server",
3
- "version": "0.2.2",
3
+ "version": "0.2.4",
4
4
  "mcpName": "io.github.cyanheads/biorxiv-mcp-server",
5
5
  "description": "Search and retrieve bioRxiv and medRxiv preprints — by DOI, date interval, or keyword — via MCP. STDIO or Streamable HTTP.",
6
6
  "type": "module",
package/server.json CHANGED
@@ -6,14 +6,14 @@
6
6
  "url": "https://github.com/cyanheads/biorxiv-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.2.2",
9
+ "version": "0.2.4",
10
10
  "packages": [
11
11
  {
12
12
  "registryType": "npm",
13
13
  "registryBaseUrl": "https://registry.npmjs.org",
14
14
  "identifier": "@cyanheads/biorxiv-mcp-server",
15
15
  "runtimeHint": "bun",
16
- "version": "0.2.2",
16
+ "version": "0.2.4",
17
17
  "packageArguments": [
18
18
  {
19
19
  "type": "positional",
@@ -62,7 +62,7 @@
62
62
  "registryBaseUrl": "https://registry.npmjs.org",
63
63
  "identifier": "@cyanheads/biorxiv-mcp-server",
64
64
  "runtimeHint": "bun",
65
- "version": "0.2.2",
65
+ "version": "0.2.4",
66
66
  "packageArguments": [
67
67
  {
68
68
  "type": "positional",