@cyanheads/cern-inspire-mcp-server 0.1.2 → 0.2.0

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 (66) hide show
  1. package/AGENTS.md +39 -39
  2. package/CLAUDE.md +39 -39
  3. package/Dockerfile +8 -3
  4. package/README.md +59 -115
  5. package/changelog/0.1.x/0.1.3.md +34 -0
  6. package/changelog/0.2.x/0.2.0.md +35 -0
  7. package/dist/index.js +2 -1
  8. package/dist/index.js.map +1 -1
  9. package/dist/mcp-server/resources/definitions/index.d.ts +10 -0
  10. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  11. package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts +10 -0
  12. package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts.map +1 -1
  13. package/dist/mcp-server/resources/definitions/inspire-literature.resource.js +1 -1
  14. package/dist/mcp-server/resources/definitions/inspire-literature.resource.js.map +1 -1
  15. package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts +48 -4
  16. package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts.map +1 -1
  17. package/dist/mcp-server/tools/definitions/export-citations.tool.js +51 -25
  18. package/dist/mcp-server/tools/definitions/export-citations.tool.js.map +1 -1
  19. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts +2 -2
  20. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts.map +1 -1
  21. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js +10 -7
  22. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js.map +1 -1
  23. package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts +22 -1
  24. package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts.map +1 -1
  25. package/dist/mcp-server/tools/definitions/get-paper.tool.js +79 -23
  26. package/dist/mcp-server/tools/definitions/get-paper.tool.js.map +1 -1
  27. package/dist/mcp-server/tools/definitions/index.d.ts +146 -91
  28. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  29. package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -1
  30. package/dist/mcp-server/tools/definitions/list-reference.tool.js +6 -1
  31. package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -1
  32. package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts.map +1 -1
  33. package/dist/mcp-server/tools/definitions/search-authors.tool.js +7 -3
  34. package/dist/mcp-server/tools/definitions/search-authors.tool.js.map +1 -1
  35. package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts.map +1 -1
  36. package/dist/mcp-server/tools/definitions/search-experiments.tool.js +17 -10
  37. package/dist/mcp-server/tools/definitions/search-experiments.tool.js.map +1 -1
  38. package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts +1 -1
  39. package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts.map +1 -1
  40. package/dist/mcp-server/tools/definitions/search-hepdata.tool.js +8 -6
  41. package/dist/mcp-server/tools/definitions/search-hepdata.tool.js.map +1 -1
  42. package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts +3 -3
  43. package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts.map +1 -1
  44. package/dist/mcp-server/tools/definitions/search-literature.tool.js +16 -11
  45. package/dist/mcp-server/tools/definitions/search-literature.tool.js.map +1 -1
  46. package/dist/mcp-server/tools/inputs.d.ts +6 -0
  47. package/dist/mcp-server/tools/inputs.d.ts.map +1 -1
  48. package/dist/mcp-server/tools/inputs.js +71 -0
  49. package/dist/mcp-server/tools/inputs.js.map +1 -1
  50. package/dist/services/inspire/inspire-service.d.ts +11 -3
  51. package/dist/services/inspire/inspire-service.d.ts.map +1 -1
  52. package/dist/services/inspire/inspire-service.js +58 -37
  53. package/dist/services/inspire/inspire-service.js.map +1 -1
  54. package/dist/services/inspire/normalize.d.ts +3 -2
  55. package/dist/services/inspire/normalize.d.ts.map +1 -1
  56. package/dist/services/inspire/normalize.js +23 -3
  57. package/dist/services/inspire/normalize.js.map +1 -1
  58. package/dist/services/inspire/types.d.ts +27 -7
  59. package/dist/services/inspire/types.d.ts.map +1 -1
  60. package/dist/utils/render.d.ts +6 -4
  61. package/dist/utils/render.d.ts.map +1 -1
  62. package/dist/utils/render.js +8 -4
  63. package/dist/utils/render.js.map +1 -1
  64. package/package.json +12 -11
  65. package/server.json +10 -24
  66. package/skills/cern-inspire-guide/SKILL.md +43 -0
@@ -6,7 +6,7 @@
6
6
  */
7
7
  import { tool, z } from '@cyanheads/mcp-ts-core';
8
8
  import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
9
- import { blankAsUnset } from '../inputs.js';
9
+ import { blankAsUnset, documentTypesInput, formatAppliedFilters, hasEmptyQueryField, subjectsInput, yearFromInput, yearToInput, } from '../inputs.js';
10
10
  import { getInspireService } from '../../../services/inspire/inspire-service.js';
11
11
  import { callerEcho, fenced, identifier } from '../../../utils/render.js';
12
12
  const FORMATS = ['bibtex', 'latex-eu', 'latex-us'];
@@ -25,11 +25,15 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
25
25
  .trim()
26
26
  .min(1)
27
27
  .max(1000)
28
- .describe('Literature query selecting the papers to cite. Named papers: "recid:451647 or arxiv:1207.7214 or doi:10.1016/j.physletb.2012.08.020". Or any INSPIRE query: a topic ("t higgs and topcite 500+"), an author ("a Edward.Witten.1"), or the papers citing a record ("refersto:recid:451647"). See cern_inspire_list_reference topic search_syntax.'),
28
+ .describe('Literature query selecting the papers to cite, narrowed by the same document_types, subjects, year_from and year_to filters as search. Named papers: "recid:451647 or arxiv:1207.7214 or doi:10.1016/j.physletb.2012.08.020". Or a topic ("t higgs and topcite 500+"), an author ("a Edward.Witten.1"), or citing papers ("refersto:recid:451647"). Empty recognized field clauses such as a: or a:"" (including whitespace-only quoted values) are invalid; other syntax is passed through without complete grammar validation. See cern_inspire_list_reference topic search_syntax.'),
29
29
  format: blankAsUnset(z.enum(FORMATS).default('bibtex')).describe('Entry format: bibtex (default), latex-eu, or latex-us (\\bibitem entries in European or US style).'),
30
+ document_types: documentTypesInput,
31
+ subjects: subjectsInput,
32
+ year_from: yearFromInput,
33
+ year_to: yearToInput,
30
34
  sort: blankAsUnset(z.enum(SORTS).default('relevance')).describe('Entry order: relevance (default), mostrecent, or mostcited.'),
31
- page: blankAsUnset(z.number().int().min(1).default(1)).describe('Page number, starting at 1. page × size may not exceed 10,000.'),
32
- size: blankAsUnset(z.number().int().min(1).max(MAX_ENTRIES).default(10)).describe('Entries per page (1–50, default 10).'),
35
+ page: blankAsUnset(z.number().int().min(1).default(1)).describe('Page number, starting at 1. page × effective size (after clamping) may not exceed 10,000.'),
36
+ size: blankAsUnset(z.number().int().min(1).default(10)).describe('Entries per page (positive integer, default 10; above 50 uses 50).'),
33
37
  }),
34
38
  // The sibling top-N tools (search_authors, search_experiments) call their cap `limit`.
35
39
  inputAliases: { limit: 'size' },
@@ -48,6 +52,7 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
48
52
  .describe('Citation entries, in the requested order.'),
49
53
  }),
50
54
  enrichment: {
55
+ appliedFilters: z.string().describe('Sort and filters applied, or "none".'),
51
56
  truncated: z.boolean().describe('True when more matched papers follow this page.'),
52
57
  shown: z.number().describe('Number of entries on this page.'),
53
58
  cap: z.number().describe('The page size applied.'),
@@ -58,24 +63,32 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
58
63
  notice: z
59
64
  .string()
60
65
  .optional()
61
- .describe('Guidance when nothing matched, the page is past the last or came back empty inside the match count, more papers follow, or the page could not be checked against the match count.'),
66
+ .describe('Guidance when size was reduced, nothing matched, the page is past the last or came back empty inside the match count, or more papers follow.'),
62
67
  },
63
68
  enrichmentTrailer: {
69
+ appliedFilters: { label: 'Applied filters' },
64
70
  nextPage: { label: 'Next page' },
65
71
  },
66
72
  errors: [
73
+ {
74
+ reason: 'invalid_year_range',
75
+ code: JsonRpcErrorCode.ValidationError,
76
+ when: 'year_from is later than year_to.',
77
+ recovery: 'Swap year_from and year_to so the range runs forward, or drop one bound for an open range, then retry this call.',
78
+ severity: 'notice',
79
+ },
67
80
  {
68
81
  reason: 'beyond_result_window',
69
82
  code: JsonRpcErrorCode.ValidationError,
70
- when: 'page × size exceeds the 10,000 results INSPIRE serves for one query.',
83
+ when: 'page × effective size (after clamping) exceeds the 10,000 results INSPIRE serves for one query.',
71
84
  recovery: 'Narrow the query with tighter terms, such as a date range ("and date > 2015") or a collaboration, until it matches under 10,000 papers, then page again with cern_inspire_export_citations.',
72
85
  severity: 'notice',
73
86
  },
74
87
  {
75
88
  reason: 'invalid_query',
76
89
  code: JsonRpcErrorCode.ValidationError,
77
- when: 'INSPIRE answered 400 to a parameter value it refuses.',
78
- recovery: 'Check the query against cern_inspire_list_reference topic search_syntax, then retry cern_inspire_export_citations with the corrected query.',
90
+ when: 'A recognized field clause has no value, or INSPIRE answered 400 to a parameter value it refuses.',
91
+ recovery: 'Give every field a value (for example "a Witten"), check cern_inspire_list_reference topic search_syntax, then retry cern_inspire_export_citations.',
79
92
  severity: 'notice',
80
93
  thrownBy: 'service',
81
94
  },
@@ -98,13 +111,34 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
98
111
  {
99
112
  reason: 'upstream_unreadable',
100
113
  code: JsonRpcErrorCode.ServiceUnavailable,
101
- when: 'The INSPIRE body exceeded the byte ceiling, or was JSON or HTML where citation text was expected.',
114
+ when: 'The INSPIRE body exceeded the byte ceiling, the citation page was JSON or HTML instead of citation text, or selection verification returned unreadable JSON.',
102
115
  recovery: 'Retry this call in a few seconds; if it fails again, INSPIRE is likely serving an error page, so wait a minute before retrying cern_inspire_export_citations with the same page and size.',
103
116
  thrownBy: 'service',
104
117
  },
105
118
  ],
106
- async handler(input, ctx) {
107
- ctx.enrich({ truncated: false, shown: 0, cap: input.size });
119
+ async handler(requested, ctx) {
120
+ const input = { ...requested, size: Math.min(requested.size, MAX_ENTRIES) };
121
+ const reduction = requested.size > input.size ? `size ${requested.size} reduced to ${input.size}.` : undefined;
122
+ const filters = {
123
+ documentTypes: input.document_types,
124
+ subjects: input.subjects,
125
+ yearFrom: input.year_from,
126
+ yearTo: input.year_to,
127
+ };
128
+ ctx.enrich({
129
+ truncated: false,
130
+ shown: 0,
131
+ cap: input.size,
132
+ appliedFilters: formatAppliedFilters({ sort: input.sort, ...filters }),
133
+ });
134
+ if (hasEmptyQueryField(input.query)) {
135
+ throw ctx.fail('invalid_query', 'A recognized INSPIRE field clause has no value; use "a Witten", for example.');
136
+ }
137
+ if (input.year_from !== undefined &&
138
+ input.year_to !== undefined &&
139
+ input.year_from > input.year_to) {
140
+ throw ctx.fail('invalid_year_range', `year_from (${input.year_from}) is later than year_to (${input.year_to}).`);
141
+ }
108
142
  if (input.page * input.size > RESULT_WINDOW) {
109
143
  throw ctx.fail('beyond_result_window', `page ${input.page} × size ${input.size} reaches past the first 10,000 results, which is all INSPIRE serves for one query.`, { page: input.page, size: input.size });
110
144
  }
@@ -115,6 +149,7 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
115
149
  sort: input.sort,
116
150
  page: input.page,
117
151
  size: input.size,
152
+ ...filters,
118
153
  }, inspire.beginCall(ctx));
119
154
  const shown = result.entries.length;
120
155
  ctx.enrich({ shown });
@@ -125,14 +160,10 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
125
160
  total: result.total,
126
161
  truncated: result.truncated,
127
162
  });
128
- const unchecked = input.page > 1 && result.total === undefined;
129
- const notices = [];
163
+ const notices = reduction ? [reduction] : [];
130
164
  if (shown === 0) {
131
165
  notices.push(emptyPageNotice(input, result.total));
132
166
  }
133
- else if (unchecked) {
134
- notices.push("INSPIRE's match count could not be read, so this page is unchecked against it: past the last page, INSPIRE can return an entry from an earlier page again (it does for OR queries).");
135
- }
136
167
  if (result.truncated) {
137
168
  const nextPage = input.page + 1;
138
169
  const reachable = nextPage * input.size <= RESULT_WINDOW;
@@ -140,11 +171,9 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
140
171
  ctx.enrich({ nextPage });
141
172
  notices.unshift(!reachable
142
173
  ? 'INSPIRE serves only the first 10,000 results of a query; narrow it with tighter terms, such as a date range or a collaboration, to export the rest.'
143
- : unchecked
144
- ? `This page came back full; request page ${nextPage} for any further entries.`
145
- : `More papers matched; request page ${nextPage} for the next ${input.size}${input.page === 1 && input.size < MAX_ENTRIES
146
- ? `, or raise size (up to ${MAX_ENTRIES}) to export more per call`
147
- : ''}.`);
174
+ : `More papers matched; request page ${nextPage} for the next ${input.size}${input.page === 1 && input.size < MAX_ENTRIES
175
+ ? `, or raise size (up to ${MAX_ENTRIES}) to export more per call`
176
+ : ''}.`);
148
177
  ctx.enrich.truncated({ shown, cap: input.size, guidance: notices.join(' ') });
149
178
  }
150
179
  else if (notices.length > 0) {
@@ -166,12 +195,9 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
166
195
  });
167
196
  /**
168
197
  * Why a page holds no entries: nothing matched, the page is past the last, INSPIRE
169
- * sent nothing for a page inside its own count, or no total was read to tell.
198
+ * sent nothing for a page inside its own verified count.
170
199
  */
171
200
  function emptyPageNotice(input, total) {
172
- if (input.page > 1 && total === undefined) {
173
- return `Page ${input.page} came back empty and INSPIRE's match count could not be read, so either it is past the last page or nothing matched; request page 1 to tell which.`;
174
- }
175
201
  if (total === undefined || total === 0) {
176
202
  return `No INSPIRE literature matched "${callerEcho(input.query)}"; find the papers with cern_inspire_search_literature, then export by recid ("recid:N or recid:M").`;
177
203
  }
@@ -1 +1 @@
1
- {"version":3,"file":"export-citations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/export-citations.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"export-citations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/export-citations.tool.ts"],"names":[],"mappings":"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"}
@@ -131,8 +131,8 @@ export declare const getCitationSummaryTool: import("@cyanheads/mcp-ts-core").To
131
131
  }, {
132
132
  readonly reason: "invalid_query";
133
133
  readonly code: JsonRpcErrorCode.ValidationError;
134
- readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
135
- readonly recovery: "Check the query and filters against cern_inspire_list_reference topic search_syntax, then retry cern_inspire_get_citation_summary.";
134
+ readonly when: "A recognized field clause has no value, or INSPIRE answered 400 to a parameter value it refuses.";
135
+ readonly recovery: "Give every field a value (for example \"a Witten\"), check cern_inspire_list_reference topic search_syntax, then retry cern_inspire_get_citation_summary.";
136
136
  readonly severity: "notice";
137
137
  readonly thrownBy: "service";
138
138
  }, {
@@ -1 +1 @@
1
- {"version":3,"file":"get-citation-summary.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-citation-summary.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyFjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwTjC,CAAC"}
1
+ {"version":3,"file":"get-citation-summary.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-citation-summary.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA0FjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+TjC,CAAC"}
@@ -7,11 +7,11 @@
7
7
  */
8
8
  import { tool, z } from '@cyanheads/mcp-ts-core';
9
9
  import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
10
- import { authorIdInput, blankAsUnset, documentTypesInput, formatAppliedFilters, subjectsInput, yearFromInput, yearToInput, } from '../inputs.js';
10
+ import { authorIdInput, blankAsUnset, documentTypesInput, formatAppliedFilters, hasEmptyQueryField, subjectsInput, yearFromInput, yearToInput, } from '../inputs.js';
11
11
  import { containsOrcid, routeAuthorQuery } from '../../../services/inspire/identifiers.js';
12
12
  import { BROAD_SERIES_RECORDS, CITATIONS_BY_YEAR_BUDGET_MS, getInspireService, } from '../../../services/inspire/inspire-service.js';
13
13
  import { CITATION_BUCKET_RANGES } from '../../../services/inspire/vocabulary.js';
14
- import { callerEcho, cell, inline } from '../../../utils/render.js';
14
+ import { callerEcho, cell, errorText, inline } from '../../../utils/render.js';
15
15
  /**
16
16
  * Up to this many matched records, a repeat of a cut series may be answered from
17
17
  * INSPIRE's cache: measured 2026-10-01/02, 210,258 records were cached and served
@@ -71,7 +71,7 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
71
71
  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
72
72
  input: z.object({
73
73
  author: authorIdInput,
74
- query: blankAsUnset(z.string().trim().max(1000).optional()).describe('An INSPIRE literature query, e.g. "collaboration:atlas", "t neutrino oscillation", "a Edward.Witten.1", or "affid:902725" for an institution\'s papers (CERN; affid takes the institution recid that cern_inspire_search_authors and cern_inspire_search_experiments return). Literature queries do not match ORCIDs; pass an ORCID as author. Pass this or author, not both.'),
74
+ query: blankAsUnset(z.string().trim().max(1000).optional()).describe('An INSPIRE literature query, e.g. "collaboration:atlas", "t neutrino oscillation", "a Edward.Witten.1", or "affid:902725" for an institution\'s papers (CERN; affid takes the institution recid that cern_inspire_search_authors and cern_inspire_search_experiments return). Empty recognized field clauses such as a: or a:"" (including whitespace-only quoted values) are invalid; other syntax is passed through without complete grammar validation. Literature queries do not match ORCIDs; pass an ORCID as author. Pass this or author, not both.'),
75
75
  document_types: documentTypesInput,
76
76
  subjects: subjectsInput,
77
77
  year_from: yearFromInput,
@@ -172,8 +172,8 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
172
172
  {
173
173
  reason: 'invalid_query',
174
174
  code: JsonRpcErrorCode.ValidationError,
175
- when: 'INSPIRE answered 400 to a parameter value it refuses.',
176
- recovery: 'Check the query and filters against cern_inspire_list_reference topic search_syntax, then retry cern_inspire_get_citation_summary.',
175
+ when: 'A recognized field clause has no value, or INSPIRE answered 400 to a parameter value it refuses.',
176
+ recovery: 'Give every field a value (for example "a Witten"), check cern_inspire_list_reference topic search_syntax, then retry cern_inspire_get_citation_summary.',
177
177
  severity: 'notice',
178
178
  thrownBy: 'service',
179
179
  },
@@ -215,6 +215,9 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
215
215
  }),
216
216
  });
217
217
  ctx.enrich.echo(input.query || input.author || '');
218
+ if (input.query && hasEmptyQueryField(input.query)) {
219
+ throw ctx.fail('invalid_query', 'A recognized INSPIRE field clause has no value; use "a Witten", for example.');
220
+ }
218
221
  if (input.year_from !== undefined &&
219
222
  input.year_to !== undefined &&
220
223
  input.year_from > input.year_to) {
@@ -231,11 +234,11 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
231
234
  if (input.author) {
232
235
  const route = routeAuthorQuery(input.author);
233
236
  if (route.matchedAs === 'name') {
234
- throw ctx.fail('author_not_identifier', `author "${callerEcho(input.author)}" is not a BAI, ORCID, INSPIRE ID, or author recid.`, { author: input.author });
237
+ throw ctx.fail('author_not_identifier', `author "${errorText(input.author)}" is not a BAI, ORCID, INSPIRE ID, or author recid.`, { author: input.author });
235
238
  }
236
239
  const resolved = await inspire.resolveAuthor(route, call);
237
240
  if (!resolved) {
238
- throw ctx.fail('author_not_found', `No INSPIRE author profile matched "${callerEcho(input.author)}" as ${route.matchedAs}.`, { author: input.author, matchedAs: route.matchedAs });
241
+ throw ctx.fail('author_not_found', `No INSPIRE author profile matched "${errorText(input.author)}" as ${route.matchedAs}.`, { author: input.author, matchedAs: route.matchedAs });
239
242
  }
240
243
  target = {
241
244
  kind: 'author',
@@ -1 +1 @@
1
- {"version":3,"file":"get-citation-summary.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-citation-summary.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"get-citation-summary.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-citation-summary.tool.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * @fileoverview cern_inspire_get_paper — one INSPIRE-HEP paper's full record by
3
- * recid, arXiv ID, or DOI: authors with affiliations, abstract, publication,
3
+ * recid, arXiv ID, or DOI: contributors with affiliations and recorded roles, public attached-document links, abstract, publication,
4
4
  * identifiers, citation counts, linked experiments, and whether HEPData holds
5
5
  * its numerical tables. Also exports the dossier schema the
6
6
  * `inspire://literature/{recid}` resource validates against.
@@ -22,8 +22,11 @@ export declare const paperDossierSchema: z.ZodObject<{
22
22
  abstract: z.ZodOptional<z.ZodString>;
23
23
  abstractSource: z.ZodOptional<z.ZodString>;
24
24
  authorCount: z.ZodNumber;
25
+ authorOffset: z.ZodNumber;
26
+ nextAuthorOffset: z.ZodOptional<z.ZodNumber>;
25
27
  authors: z.ZodArray<z.ZodObject<{
26
28
  name: z.ZodString;
29
+ roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
27
30
  recid: z.ZodOptional<z.ZodString>;
28
31
  bai: z.ZodOptional<z.ZodString>;
29
32
  orcid: z.ZodOptional<z.ZodString>;
@@ -59,6 +62,13 @@ export declare const paperDossierSchema: z.ZodObject<{
59
62
  citationCount: z.ZodNumber;
60
63
  citationCountWithoutSelf: z.ZodOptional<z.ZodNumber>;
61
64
  texkeys: z.ZodArray<z.ZodString>;
65
+ documents: z.ZodArray<z.ZodObject<{
66
+ url: z.ZodString;
67
+ filename: z.ZodOptional<z.ZodString>;
68
+ description: z.ZodOptional<z.ZodString>;
69
+ material: z.ZodOptional<z.ZodString>;
70
+ fulltext: z.ZodOptional<z.ZodBoolean>;
71
+ }, z.core.$strip>>;
62
72
  urls: z.ZodArray<z.ZodObject<{
63
73
  url: z.ZodString;
64
74
  description: z.ZodOptional<z.ZodString>;
@@ -95,6 +105,7 @@ export type PaperDossierOutput = z.infer<typeof paperDossierSchema>;
95
105
  export declare const getPaperTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
96
106
  paper: z.ZodPreprocess<z.ZodString, unknown>;
97
107
  max_authors: z.ZodPreprocess<z.ZodDefault<z.ZodNumber>, unknown>;
108
+ author_offset: z.ZodPreprocess<z.ZodDefault<z.ZodNumber>, unknown>;
98
109
  }, z.core.$strip>, z.ZodObject<{
99
110
  recid: z.ZodString;
100
111
  mergedFrom: z.ZodOptional<z.ZodString>;
@@ -108,8 +119,11 @@ export declare const getPaperTool: import("@cyanheads/mcp-ts-core").ToolDefiniti
108
119
  abstract: z.ZodOptional<z.ZodString>;
109
120
  abstractSource: z.ZodOptional<z.ZodString>;
110
121
  authorCount: z.ZodNumber;
122
+ authorOffset: z.ZodNumber;
123
+ nextAuthorOffset: z.ZodOptional<z.ZodNumber>;
111
124
  authors: z.ZodArray<z.ZodObject<{
112
125
  name: z.ZodString;
126
+ roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
113
127
  recid: z.ZodOptional<z.ZodString>;
114
128
  bai: z.ZodOptional<z.ZodString>;
115
129
  orcid: z.ZodOptional<z.ZodString>;
@@ -145,6 +159,13 @@ export declare const getPaperTool: import("@cyanheads/mcp-ts-core").ToolDefiniti
145
159
  citationCount: z.ZodNumber;
146
160
  citationCountWithoutSelf: z.ZodOptional<z.ZodNumber>;
147
161
  texkeys: z.ZodArray<z.ZodString>;
162
+ documents: z.ZodArray<z.ZodObject<{
163
+ url: z.ZodString;
164
+ filename: z.ZodOptional<z.ZodString>;
165
+ description: z.ZodOptional<z.ZodString>;
166
+ material: z.ZodOptional<z.ZodString>;
167
+ fulltext: z.ZodOptional<z.ZodBoolean>;
168
+ }, z.core.$strip>>;
148
169
  urls: z.ZodArray<z.ZodObject<{
149
170
  url: z.ZodString;
150
171
  description: z.ZodOptional<z.ZodString>;
@@ -1 +1 @@
1
- {"version":3,"file":"get-paper.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-paper.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA0BjE,sFAAsF;AACtF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsL7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AA2MpE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqHvB,CAAC"}
1
+ {"version":3,"file":"get-paper.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-paper.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA0BjE,sFAAsF;AACtF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2N7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AA8NpE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsIvB,CAAC"}
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * @fileoverview cern_inspire_get_paper — one INSPIRE-HEP paper's full record by
3
- * recid, arXiv ID, or DOI: authors with affiliations, abstract, publication,
3
+ * recid, arXiv ID, or DOI: contributors with affiliations and recorded roles, public attached-document links, abstract, publication,
4
4
  * identifiers, citation counts, linked experiments, and whether HEPData holds
5
5
  * its numerical tables. Also exports the dossier schema the
6
6
  * `inspire://literature/{recid}` resource validates against.
@@ -11,7 +11,7 @@ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
11
11
  import { blankAsUnset, hepdataRecordRoute, paperInput } from '../inputs.js';
12
12
  import { hepdataRecordNumber } from '../../../services/inspire/identifiers.js';
13
13
  import { getInspireService } from '../../../services/inspire/inspire-service.js';
14
- import { atLineStart, callerEcho, identifier, inline, printUrl, quote } from '../../../utils/render.js';
14
+ import { atLineStart, errorText, identifier, inline, printUrl, quote } from '../../../utils/render.js';
15
15
  /** Upper bound on `max_authors`; the full count is always in `authorCount`. */
16
16
  const MAX_AUTHORS_LIMIT = 500;
17
17
  /** The facts of one HEPData record, for the `hepdata` block and each of its `otherRecords`. */
@@ -52,11 +52,28 @@ export const paperDossierSchema = z.object({
52
52
  .string()
53
53
  .optional()
54
54
  .describe('Who supplied the abstract (e.g. arXiv, a publisher).'),
55
- authorCount: z.number().describe('Total number of authors on the paper.'),
55
+ authorCount: z
56
+ .number()
57
+ .describe('Upstream contributor count, falling back to the available contributor list length.'),
58
+ authorOffset: z
59
+ .number()
60
+ .int()
61
+ .min(0)
62
+ .describe('Zero-based starting position in the normalized available contributor list.'),
63
+ nextAuthorOffset: z
64
+ .number()
65
+ .int()
66
+ .min(0)
67
+ .optional()
68
+ .describe('Pass as author_offset to read the next page; absent when no contributors remain or the budget is zero.'),
56
69
  authors: z
57
70
  .array(z
58
71
  .object({
59
- name: z.string().describe('Author name, "Surname, Given names".'),
72
+ name: z.string().describe('Contributor name, "Surname, Given names".'),
73
+ roles: z
74
+ .array(z.string().describe('Recorded INSPIRE contributor role.'))
75
+ .optional()
76
+ .describe('Roles in recorded order; absent roles are unknown.'),
60
77
  recid: z
61
78
  .string()
62
79
  .optional()
@@ -68,10 +85,10 @@ export const paperDossierSchema = z.object({
68
85
  orcid: z.string().optional().describe('ORCID, when known.'),
69
86
  affiliations: z
70
87
  .array(z.string().describe('Affiliation name.'))
71
- .describe('Affiliations listed for this author on this paper.'),
88
+ .describe('Affiliations listed for this contributor on this paper.'),
72
89
  })
73
- .describe('One author.'))
74
- .describe('Authors in record order, capped at max_authors.'),
90
+ .describe('One contributor.'))
91
+ .describe('Contributors in record order from authorOffset, capped at the effective max_authors budget.'),
75
92
  collaborations: z
76
93
  .array(z.string().describe('Collaboration name.'))
77
94
  .describe('Collaborations credited on the paper; empty for most non-collaboration papers.'),
@@ -138,6 +155,20 @@ export const paperDossierSchema = z.object({
138
155
  texkeys: z
139
156
  .array(z.string().describe('A texkey.'))
140
157
  .describe('INSPIRE texkeys (BibTeX citation keys), current first.'),
158
+ documents: z
159
+ .array(z
160
+ .object({
161
+ url: z.string().describe('Public attached-document URL.'),
162
+ filename: z.string().optional().describe('Recorded filename.'),
163
+ description: z.string().optional().describe('Recorded document description.'),
164
+ material: z.string().optional().describe('Recorded version or material qualifier.'),
165
+ fulltext: z
166
+ .boolean()
167
+ .optional()
168
+ .describe('Recorded full-text flag; absent means unknown.'),
169
+ })
170
+ .describe('One public attached document.'))
171
+ .describe('Public attached-document links in record order; no file contents are fetched.'),
141
172
  urls: z
142
173
  .array(z
143
174
  .object({
@@ -198,7 +229,7 @@ function renderAuthor(a) {
198
229
  a.orcid && `ORCID ${identifier(a.orcid)}`,
199
230
  ].filter(Boolean);
200
231
  const affiliations = a.affiliations.length > 0 ? ` — ${a.affiliations.map(inline).join('; ')}` : '';
201
- return `- **${inline(a.name)}**${ids.length > 0 ? ` (${ids.join(' · ')})` : ''}${affiliations}`;
232
+ return `- **${inline(a.name)}**${a.roles === undefined ? '' : ` — roles: ${a.roles.map(inline).join(', ') || 'not recorded'}`}${ids.length > 0 ? ` (${ids.join(' · ')})` : ''}${affiliations}`;
202
233
  }
203
234
  /** The labelled DOI, version, table count, and data recid of one HEPData record. */
204
235
  const hepdataFacts = (r) => [
@@ -304,7 +335,9 @@ function renderPaperDossier(paper) {
304
335
  if (paper.abstract) {
305
336
  lines.push('', `### Abstract${paper.abstractSource ? ` (source: ${inline(paper.abstractSource)})` : ''}`, quote(paper.abstract));
306
337
  }
307
- lines.push('', `### Authors (${paper.authors.length} shown of ${paper.authorCount})`, ...paper.authors.map(renderAuthor));
338
+ lines.push('', `### Contributors (${paper.authors.length} shown of ${paper.authorCount})`, `**Author offset:** ${paper.authorOffset}${paper.authors.length > 0 ? ` · **Positions:** ${paper.authorOffset + 1}–${paper.authorOffset + paper.authors.length}` : ''}`, ...(paper.nextAuthorOffset === undefined
339
+ ? []
340
+ : [`**Next author offset:** ${paper.nextAuthorOffset}`]), ...paper.authors.map(renderAuthor));
308
341
  if (paper.keywords.length > 0) {
309
342
  lines.push('', `**Keywords:** ${paper.keywords.map(identifier).join('; ')}`);
310
343
  }
@@ -314,6 +347,17 @@ function renderPaperDossier(paper) {
314
347
  if (paper.urls.length > 0) {
315
348
  lines.push('', '### Links', ...paper.urls.map((u) => `- ${atLineStart(printUrl(u.url))}${u.description ? ` — ${inline(u.description)}` : ''}`));
316
349
  }
350
+ if (paper.documents.length > 0) {
351
+ lines.push('', '### Attached documents', ...paper.documents.map((document) => {
352
+ const details = [
353
+ document.filename && `filename: ${inline(document.filename)}`,
354
+ document.description && `description: ${inline(document.description)}`,
355
+ document.material && `material: ${inline(document.material)}`,
356
+ document.fulltext !== undefined && `fulltext: ${yesNo(document.fulltext)}`,
357
+ ].filter(Boolean);
358
+ return `- [${inline(document.filename ?? document.url)}](<${printUrl(document.url).replaceAll('\\', '%5C')}>)${details.length > 0 ? ` — ${details.join(' · ')}` : ''}`;
359
+ }));
360
+ }
317
361
  if (paper.licenses.length > 0) {
318
362
  lines.push('', '### Licenses', ...paper.licenses.map((l) => {
319
363
  const details = [
@@ -329,21 +373,24 @@ function renderPaperDossier(paper) {
329
373
  }
330
374
  export const getPaperTool = tool('cern_inspire_get_paper', {
331
375
  title: 'Get INSPIRE paper',
332
- description: "Fetch one paper's full INSPIRE-HEP record by recid, arXiv ID, or DOI: authors with affiliations and identifiers, abstract, publication references, arXiv and DOI identifiers, keywords, subjects, citation counts, linked experiments, texkeys, and whether HEPData holds its numerical tables (record DOI, latest version, table count, hepdata.net link). Also returns ready-made literature queries for the papers citing it and for its references. Large collaboration papers can list thousands of authors; max_authors caps the list while authorCount gives the full number.",
376
+ description: "Fetch one paper's full INSPIRE-HEP record by recid, arXiv ID, or DOI: contributors with affiliations and recorded roles, public attached-document links and identifiers, abstract, publication references, arXiv and DOI identifiers, keywords, subjects, citation counts, linked experiments, texkeys, and whether HEPData holds its numerical tables (record DOI, latest version, table count, hepdata.net link). Also returns ready-made literature queries for the papers citing it and for its references. Large collaboration papers can list thousands of authors; max_authors caps the list while authorCount gives the full number.",
333
377
  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
334
378
  input: z.object({
335
379
  paper: paperInput,
336
- max_authors: blankAsUnset(z.number().int().min(0).max(MAX_AUTHORS_LIMIT).default(25)).describe('Most authors to list (0–500, default 25). The full count is always in authorCount.'),
380
+ max_authors: blankAsUnset(z.number().int().min(0).default(25)).describe('Most contributors to list (nonnegative integer, default 25; values above 500 use 500). Zero lists no contributors. The full count is always in authorCount.'),
381
+ author_offset: blankAsUnset(z.number().int().min(0).default(0)).describe('Zero-based starting position in the normalized contributor list (default 0). Use nextAuthorOffset from the previous page.'),
337
382
  }),
338
383
  output: paperDossierSchema,
339
384
  enrichment: {
340
- truncated: z.boolean().describe('True when the author list was capped at max_authors.'),
341
- shown: z.number().describe('Number of authors listed.'),
385
+ truncated: z
386
+ .boolean()
387
+ .describe('True when available contributors remain after this page, including a zero-budget page.'),
388
+ shown: z.number().describe('Number of contributors listed.'),
342
389
  cap: z.number().describe('The max_authors cap applied.'),
343
390
  notice: z
344
391
  .string()
345
392
  .optional()
346
- .describe('Guidance when the recid asked for was merged into this record, the author list was capped, HEPData availability could not be checked, or the paper has more than one HEPData record.'),
393
+ .describe('Guidance when the recid asked for was merged into this record, the contributor list was capped, HEPData availability could not be checked, or the paper has more than one HEPData record.'),
347
394
  },
348
395
  errors: [
349
396
  {
@@ -378,31 +425,40 @@ export const getPaperTool = tool('cern_inspire_get_paper', {
378
425
  },
379
426
  ],
380
427
  async handler(input, ctx) {
381
- ctx.enrich({ truncated: false, shown: 0, cap: input.max_authors });
428
+ const cap = Math.min(input.max_authors, MAX_AUTHORS_LIMIT);
429
+ ctx.enrich({ truncated: false, shown: 0, cap });
382
430
  const inspire = getInspireService();
383
- const lookup = await inspire.getPaper(input.paper, input.max_authors, inspire.beginCall(ctx));
431
+ const lookup = await inspire.getPaper(input.paper, cap, inspire.beginCall(ctx), {
432
+ authorOffset: input.author_offset,
433
+ });
384
434
  if (!lookup) {
385
435
  const record = hepdataRecordNumber(input.paper);
386
436
  if (record) {
387
- throw ctx.fail('paper_not_found', `No INSPIRE literature record carries "${callerEcho(input.paper)}", a DOI of HEPData record ${record}, which names the data rather than a paper.`, {
437
+ throw ctx.fail('paper_not_found', `No INSPIRE literature record carries "${errorText(input.paper)}", a DOI of HEPData record ${record}, which names the data rather than a paper.`, {
388
438
  paper: input.paper,
389
439
  recovery: { hint: `To reach its paper, ${hepdataRecordRoute(record)}.` },
390
440
  });
391
441
  }
392
- throw ctx.fail('paper_not_found', `No INSPIRE literature record matches "${callerEcho(input.paper)}".`, { paper: input.paper });
442
+ throw ctx.fail('paper_not_found', `No INSPIRE literature record matches "${errorText(input.paper)}".`, { paper: input.paper });
393
443
  }
394
444
  const { paper, authorsInRecord, hepdataRecordCount = 0 } = lookup;
395
445
  const shown = paper.authors.length;
396
446
  ctx.enrich({ shown });
397
447
  const notices = [];
448
+ if (input.max_authors > cap) {
449
+ notices.push(`Requested max_authors ${input.max_authors}; applied cap ${cap}.`);
450
+ }
398
451
  if (paper.mergedFrom) {
399
452
  notices.push(`INSPIRE merged recid ${identifier(paper.mergedFrom)} into recid ${paper.recid} and redirects the old recid here; cite and query this paper as recid:${paper.recid}.`);
400
453
  }
401
- const capped = authorsInRecord > input.max_authors;
454
+ const capped = input.author_offset + shown < authorsInRecord;
402
455
  if (capped) {
403
- notices.push(input.max_authors < MAX_AUTHORS_LIMIT
404
- ? `Showing ${shown} of ${authorsInRecord} authors; raise max_authors (up to ${MAX_AUTHORS_LIMIT}) to list more.`
405
- : `Showing ${shown} of ${authorsInRecord} authors, the max_authors maximum; the other ${authorsInRecord - shown} are not listed. To check whether someone is on this paper, call cern_inspire_search_literature with query "recid:${paper.recid} and a BAI or NAME", which returns the paper when they are a listed author.`);
456
+ notices.push(cap === 0
457
+ ? `No contributors listed at author_offset ${input.author_offset}; request a positive max_authors budget to read the available contributors.`
458
+ : `Showing positions ${input.author_offset + 1}–${input.author_offset + shown} of ${authorsInRecord} available contributors; call cern_inspire_get_paper with paper "${paper.recid}", author_offset ${paper.nextAuthorOffset} and max_authors ${cap} to continue.${cap < MAX_AUTHORS_LIMIT ? ` You may also raise max_authors (up to ${MAX_AUTHORS_LIMIT}).` : ''}`);
459
+ }
460
+ else if (input.author_offset > 0 && shown === 0) {
461
+ notices.push(`Contributor list exhausted at author_offset ${input.author_offset}; ${authorsInRecord} contributors are available in this record.`);
406
462
  }
407
463
  if (paper.hepdata.status === 'lookup_failed') {
408
464
  notices.push(`HEPData availability could not be checked; retry cern_inspire_get_paper, or call cern_inspire_search_hepdata with query "literature.control_number:${paper.recid}".`);
@@ -411,7 +467,7 @@ export const getPaperTool = tool('cern_inspire_get_paper', {
411
467
  if (records)
412
468
  notices.push(records);
413
469
  if (capped) {
414
- ctx.enrich.truncated({ shown, cap: input.max_authors, guidance: notices.join(' ') });
470
+ ctx.enrich.truncated({ shown, cap, guidance: notices.join(' ') });
415
471
  }
416
472
  else if (notices.length > 0) {
417
473
  ctx.enrich.notice(notices.join(' '));