@cyanheads/cern-inspire-mcp-server 0.1.3 → 0.3.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 (80) hide show
  1. package/AGENTS.md +35 -20
  2. package/CLAUDE.md +35 -20
  3. package/Dockerfile +5 -3
  4. package/README.md +69 -120
  5. package/changelog/0.2.x/0.2.0.md +35 -0
  6. package/changelog/0.3.x/0.3.0.md +31 -0
  7. package/changelog/template.md +10 -3
  8. package/dist/index.js +2 -1
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/resources/definitions/index.d.ts +28 -0
  11. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  12. package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts +28 -0
  13. package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts.map +1 -1
  14. package/dist/mcp-server/resources/definitions/inspire-literature.resource.js +1 -1
  15. package/dist/mcp-server/resources/definitions/inspire-literature.resource.js.map +1 -1
  16. package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts +2 -2
  17. package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts.map +1 -1
  18. package/dist/mcp-server/tools/definitions/export-citations.tool.js +22 -31
  19. package/dist/mcp-server/tools/definitions/export-citations.tool.js.map +1 -1
  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 +11 -13
  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 +61 -3
  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 +136 -40
  26. package/dist/mcp-server/tools/definitions/get-paper.tool.js.map +1 -1
  27. package/dist/mcp-server/tools/definitions/index.d.ts +258 -142
  28. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  29. package/dist/mcp-server/tools/definitions/index.js +2 -0
  30. package/dist/mcp-server/tools/definitions/index.js.map +1 -1
  31. package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -1
  32. package/dist/mcp-server/tools/definitions/list-reference.tool.js +20 -10
  33. package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -1
  34. package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts +17 -5
  35. package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts.map +1 -1
  36. package/dist/mcp-server/tools/definitions/search-authors.tool.js +69 -25
  37. package/dist/mcp-server/tools/definitions/search-authors.tool.js.map +1 -1
  38. package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts +16 -5
  39. package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts.map +1 -1
  40. package/dist/mcp-server/tools/definitions/search-experiments.tool.js +72 -28
  41. package/dist/mcp-server/tools/definitions/search-experiments.tool.js.map +1 -1
  42. package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts +3 -3
  43. package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts.map +1 -1
  44. package/dist/mcp-server/tools/definitions/search-hepdata.tool.js +19 -15
  45. package/dist/mcp-server/tools/definitions/search-hepdata.tool.js.map +1 -1
  46. package/dist/mcp-server/tools/definitions/search-institutions.tool.d.ts +77 -0
  47. package/dist/mcp-server/tools/definitions/search-institutions.tool.d.ts.map +1 -0
  48. package/dist/mcp-server/tools/definitions/search-institutions.tool.js +228 -0
  49. package/dist/mcp-server/tools/definitions/search-institutions.tool.js.map +1 -0
  50. package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts +1 -1
  51. package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts.map +1 -1
  52. package/dist/mcp-server/tools/definitions/search-literature.tool.js +21 -20
  53. package/dist/mcp-server/tools/definitions/search-literature.tool.js.map +1 -1
  54. package/dist/mcp-server/tools/inputs.d.ts +34 -4
  55. package/dist/mcp-server/tools/inputs.d.ts.map +1 -1
  56. package/dist/mcp-server/tools/inputs.js +202 -7
  57. package/dist/mcp-server/tools/inputs.js.map +1 -1
  58. package/dist/services/http/fetch-bounded.d.ts +1 -1
  59. package/dist/services/http/fetch-bounded.js +1 -1
  60. package/dist/services/inspire/identifiers.d.ts +20 -6
  61. package/dist/services/inspire/identifiers.d.ts.map +1 -1
  62. package/dist/services/inspire/identifiers.js +30 -9
  63. package/dist/services/inspire/identifiers.js.map +1 -1
  64. package/dist/services/inspire/inspire-service.d.ts +27 -10
  65. package/dist/services/inspire/inspire-service.d.ts.map +1 -1
  66. package/dist/services/inspire/inspire-service.js +115 -47
  67. package/dist/services/inspire/inspire-service.js.map +1 -1
  68. package/dist/services/inspire/normalize.d.ts +10 -2
  69. package/dist/services/inspire/normalize.d.ts.map +1 -1
  70. package/dist/services/inspire/normalize.js +84 -1
  71. package/dist/services/inspire/normalize.js.map +1 -1
  72. package/dist/services/inspire/types.d.ts +135 -4
  73. package/dist/services/inspire/types.d.ts.map +1 -1
  74. package/dist/utils/render.d.ts +6 -4
  75. package/dist/utils/render.d.ts.map +1 -1
  76. package/dist/utils/render.js +8 -4
  77. package/dist/utils/render.js.map +1 -1
  78. package/package.json +11 -10
  79. package/server.json +3 -3
  80. package/skills/cern-inspire-guide/SKILL.md +43 -0
@@ -0,0 +1,228 @@
1
+ /**
2
+ * @fileoverview cern_inspire_search_institutions — one page of INSPIRE-HEP
3
+ * institution records by name words, an exact recorded name (`legacy_ICN`), or
4
+ * recid: the recorded name, hierarchy, types, location, paper count, related
5
+ * records, and the `affid:N` literature query that selects each record's papers.
6
+ * @module mcp-server/tools/definitions/search-institutions.tool
7
+ */
8
+ import { tool, z } from '@cyanheads/mcp-ts-core';
9
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
10
+ import { blankAsUnset, moreResultsNotice, pastLastPageNotice, RESULT_WINDOW, } from '../inputs.js';
11
+ import { isRecid } from '../../../services/inspire/identifiers.js';
12
+ import { getInspireService } from '../../../services/inspire/inspire-service.js';
13
+ import { callerEcho, inline } from '../../../utils/render.js';
14
+ /** Also the default: a university's main and physics records can sit 20 rows apart. */
15
+ const MAX_LIMIT = 25;
16
+ const institutionSchema = z
17
+ .object({
18
+ recid: z.string().describe('INSPIRE institution record ID.'),
19
+ legacyIcn: z
20
+ .string()
21
+ .optional()
22
+ .describe('The institution name INSPIRE records on papers (e.g. Tokyo U.): the name paper affiliations carry and aff NAME matches; legacy_ICN:"NAME" as the query finds this record exactly. Absent when not recorded.'),
23
+ hierarchy: z
24
+ .array(z
25
+ .object({
26
+ name: z.string().optional().describe('Unit name, when recorded.'),
27
+ acronym: z.string().optional().describe('Unit acronym, when recorded.'),
28
+ })
29
+ .describe('One level: a name, an acronym, or both.'))
30
+ .describe('The unit this record represents, then each parent, most specific first (a department, then its university).'),
31
+ institutionTypes: z
32
+ .array(z.string().describe('Institution type.'))
33
+ .describe('Institution types (University, Research Center, Company, Other).'),
34
+ cities: z
35
+ .array(z.string().describe('City.'))
36
+ .describe("Cities across the record's addresses, primary address first."),
37
+ countryCodes: z
38
+ .array(z.string().describe('Country code.'))
39
+ .describe("Country codes across the record's addresses, primary address first."),
40
+ numberOfPapers: z
41
+ .number()
42
+ .optional()
43
+ .describe("INSPIRE's stored paper count; it can differ from the number of records literatureQuery matches."),
44
+ relatedRecords: z
45
+ .array(z
46
+ .object({
47
+ recid: z.string().describe('INSPIRE institution record ID of the related record.'),
48
+ relation: z
49
+ .string()
50
+ .optional()
51
+ .describe("parent: the related record is this one's parent institution (a department's university); successor: this institution has become the related one; predecessor: the related one has become this institution. Absent when INSPIRE records none of these."),
52
+ })
53
+ .describe('One linked institution record.'))
54
+ .describe('Linked institution records: parents, successors, and predecessors.'),
55
+ inactive: z
56
+ .boolean()
57
+ .optional()
58
+ .describe('True when INSPIRE marks the institution as no longer active; omitted when INSPIRE records nothing.'),
59
+ literatureQuery: z
60
+ .string()
61
+ .describe("affid:N, selecting the papers linked to this record; pass to cern_inspire_search_literature, or as query to cern_inspire_get_citation_summary. It matches this record only: join a department's and its parent's with or (affid:903338 or affid:945165)."),
62
+ })
63
+ .describe('One matching institution record.');
64
+ const renderLevel = (level) => level.name && level.acronym
65
+ ? `${inline(level.name)} (${inline(level.acronym)})`
66
+ : inline(level.name ?? level.acronym ?? '');
67
+ function renderInstitution(i, position) {
68
+ const lines = [`### ${position}. ${i.legacyIcn ? inline(i.legacyIcn) : '(no recorded name)'}`];
69
+ lines.push([
70
+ `**recid:** ${i.recid}`,
71
+ i.numberOfPapers !== undefined && `**Papers (INSPIRE count):** ${i.numberOfPapers}`,
72
+ i.inactive !== undefined && `**Inactive:** ${i.inactive ? 'yes' : 'no'}`,
73
+ ]
74
+ .filter(Boolean)
75
+ .join(' · '));
76
+ if (i.hierarchy.length > 0) {
77
+ lines.push(`**Hierarchy (most specific first):** ${i.hierarchy.map(renderLevel).join('; ')}`);
78
+ }
79
+ if (i.institutionTypes.length > 0) {
80
+ lines.push(`**Types:** ${i.institutionTypes.map(inline).join(', ')}`);
81
+ }
82
+ const location = [
83
+ i.cities.length > 0 && `**Cities:** ${i.cities.map(inline).join(', ')}`,
84
+ i.countryCodes.length > 0 && `**Country codes:** ${i.countryCodes.map(inline).join(', ')}`,
85
+ ].filter(Boolean);
86
+ if (location.length > 0)
87
+ lines.push(location.join(' · '));
88
+ if (i.relatedRecords.length > 0) {
89
+ lines.push(`**Related institution recids:** ${i.relatedRecords
90
+ .map((r) => r.relation ? `${inline(r.relation)} ${r.recid}` : `${r.recid} (no relation type)`)
91
+ .join('; ')}`);
92
+ }
93
+ lines.push(`**Literature query:** ${inline(i.literatureQuery)}`);
94
+ return lines;
95
+ }
96
+ export const searchInstitutionsTool = tool('cern_inspire_search_institutions', {
97
+ title: 'Search INSPIRE institutions',
98
+ description: 'Find institutions in INSPIRE-HEP (universities, departments, laboratories) by name words, an exact recorded name, or recid, for the recid that affid:N takes. Free text (University of Washington, Tokyo) returns candidates in INSPIRE\'s order, not by size: a university\'s papers often sit under department records whose parent is its "(main)" record, so pick from each record\'s hierarchy, paper count, and related records, and page on before concluding a unit is absent. legacy_ICN:"NAME" matches one recorded name exactly and case-sensitively (legacy_ICN:"Tokyo U."), the form cern_inspire_get_paper lists in authors[].affiliations; digits alone look up a recid. Each record carries that recorded name (legacyIcn, which aff NAME matches), hierarchy, institution types, cities, country codes, INSPIRE\'s paper count, parent, successor, and predecessor links, inactive status, and a literatureQuery (affid:N) for cern_inspire_search_literature or cern_inspire_get_citation_summary. affid:N matches one record; join several with or. Returns one page of records; request the next with page and the same limit. Only the first 10,000 results of a query are reachable.',
99
+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
100
+ input: z.object({
101
+ query: z
102
+ .string()
103
+ .trim()
104
+ .min(1)
105
+ .max(200)
106
+ .describe('Institution name words (University of Washington, Tokyo); one exact recorded name as legacy_ICN:"NAME" (case-sensitive, e.g. legacy_ICN:"Tokyo U."; legacy_ICN clauses joined with or match nothing); or an institution recid (digits only).'),
107
+ page: blankAsUnset(z.number().int().min(1).default(1)).describe('Page number, starting at 1. page × effective limit (after clamping) may not exceed 10,000.'),
108
+ limit: blankAsUnset(z.number().int().min(1).default(MAX_LIMIT)).describe('Institutions per page (positive integer, default 25; above 25 uses 25).'),
109
+ }),
110
+ output: z.object({
111
+ institutions: z
112
+ .array(institutionSchema)
113
+ .describe('The institution records on this page, in INSPIRE order.'),
114
+ page: z.number().describe('The page returned.'),
115
+ limit: z.number().describe('The effective limit after clamping: institutions per page.'),
116
+ hasMore: z.boolean().describe('True when INSPIRE has a further page of results.'),
117
+ }),
118
+ enrichment: {
119
+ totalCount: z.number().describe('Total institution records the query matched.'),
120
+ truncated: z.boolean().describe('True when more results exist beyond this page.'),
121
+ shown: z.number().describe('Number of records on this page.'),
122
+ cap: z.number().describe('The limit applied.'),
123
+ nextPage: z
124
+ .number()
125
+ .optional()
126
+ .describe('The page number to request next, with the same limit, when one exists within the 10,000-result window.'),
127
+ notice: z.string().optional().describe('Guidance on an empty or paged result.'),
128
+ },
129
+ enrichmentTrailer: {
130
+ nextPage: { label: 'Next page' },
131
+ },
132
+ errors: [
133
+ {
134
+ reason: 'beyond_result_window',
135
+ code: JsonRpcErrorCode.ValidationError,
136
+ when: 'page × effective limit (after clamping) exceeds the 10,000 results INSPIRE serves for one query.',
137
+ recovery: 'Narrow the query with more name words, the city, or the exact legacy_ICN:"NAME" form until it matches under 10,000 records, then page again with cern_inspire_search_institutions.',
138
+ severity: 'notice',
139
+ },
140
+ {
141
+ reason: 'invalid_query',
142
+ code: JsonRpcErrorCode.ValidationError,
143
+ when: 'INSPIRE answered 400 to a parameter value it refuses.',
144
+ recovery: 'Retry cern_inspire_search_institutions with plain institution name words, or one legacy_ICN:"NAME" clause with the name in double quotes.',
145
+ severity: 'notice',
146
+ thrownBy: 'service',
147
+ },
148
+ {
149
+ reason: 'inspire_rate_limited',
150
+ code: JsonRpcErrorCode.RateLimited,
151
+ when: 'INSPIRE returned 429 after the pacer and retries.',
152
+ recovery: 'Wait the retry-after seconds this error states (at least 5), then retry this call; INSPIRE allows 15 requests per 5 seconds from one address.',
153
+ retryable: true,
154
+ thrownBy: 'service',
155
+ },
156
+ {
157
+ reason: 'pacer_shed',
158
+ code: JsonRpcErrorCode.RateLimited,
159
+ when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.",
160
+ recovery: "This server's INSPIRE request queue is saturated; wait the seconds in this error's retryAfter field (about 5 when it is not shown), then retry this call with fewer cern_inspire calls running in parallel.",
161
+ retryable: true,
162
+ thrownBy: 'service',
163
+ },
164
+ {
165
+ reason: 'upstream_unreadable',
166
+ code: JsonRpcErrorCode.ServiceUnavailable,
167
+ when: 'The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.',
168
+ 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_search_institutions with the same page and limit.',
169
+ thrownBy: 'service',
170
+ },
171
+ ],
172
+ async handler(requested, ctx) {
173
+ const input = { ...requested, limit: Math.min(requested.limit, MAX_LIMIT) };
174
+ const reduction = requested.limit > input.limit
175
+ ? `limit ${requested.limit} reduced to ${input.limit}.`
176
+ : undefined;
177
+ ctx.enrich({ truncated: false, shown: 0, cap: input.limit });
178
+ ctx.enrich.total(0);
179
+ if (input.page * input.limit > RESULT_WINDOW) {
180
+ throw ctx.fail('beyond_result_window', `page ${input.page} × limit ${input.limit} reaches past the first 10,000 results, which is all INSPIRE serves for one query.`, { page: input.page, limit: input.limit });
181
+ }
182
+ const inspire = getInspireService();
183
+ const result = await inspire.searchInstitutions({ query: input.query, page: input.page, size: input.limit }, inspire.beginCall(ctx));
184
+ const shown = result.institutions.length;
185
+ ctx.enrich({ shown });
186
+ ctx.enrich.total(result.total);
187
+ ctx.log.info('Institution search completed', { total: result.total, shown, page: input.page });
188
+ const notices = reduction ? [reduction] : [];
189
+ if (shown === 0) {
190
+ notices.push(result.total > 0
191
+ ? pastLastPageNotice(input.page, result.total, input.limit)
192
+ : isRecid(input.query)
193
+ ? `No INSPIRE institution record has recid ${input.query}; search by name words or by legacy_ICN:"NAME" instead.`
194
+ : `No INSPIRE institution matched "${callerEcho(input.query)}". Try fewer name words or the city; legacy_ICN:"NAME" matches one recorded name exactly, case and punctuation included, as a paper's author affiliations list it in cern_inspire_get_paper.`);
195
+ }
196
+ if (result.hasMore) {
197
+ const nextPage = input.page + 1;
198
+ const reachable = nextPage * input.limit <= RESULT_WINDOW;
199
+ if (reachable)
200
+ ctx.enrich({ nextPage });
201
+ notices.unshift(reachable
202
+ ? moreResultsNotice(nextPage, 'limit', input.limit)
203
+ : 'INSPIRE serves only the first 10,000 results of a query; narrow it with more name words, the city, or the exact legacy_ICN:"NAME" form to reach the rest.');
204
+ ctx.enrich.truncated({ shown, cap: input.limit, guidance: notices.join(' ') });
205
+ }
206
+ else if (notices.length > 0) {
207
+ ctx.enrich.notice(notices.join(' '));
208
+ }
209
+ return {
210
+ institutions: result.institutions,
211
+ page: input.page,
212
+ limit: input.limit,
213
+ hasMore: result.hasMore,
214
+ };
215
+ },
216
+ format: (result) => {
217
+ const lines = [
218
+ `## INSPIRE institutions, page ${result.page}`,
219
+ `**Page:** ${result.page} · **Limit:** ${result.limit} · **Institutions on this page:** ${result.institutions.length} · **More pages:** ${result.hasMore ? 'yes' : 'no'}`,
220
+ ];
221
+ const offset = (result.page - 1) * result.limit;
222
+ result.institutions.forEach((institution, i) => {
223
+ lines.push('', ...renderInstitution(institution, offset + i + 1));
224
+ });
225
+ return [{ type: 'text', text: lines.join('\n') }];
226
+ },
227
+ });
228
+ //# sourceMappingURL=search-institutions.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-institutions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-institutions.tool.ts"],"names":[],"mappings":"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"}
@@ -79,7 +79,7 @@ export declare const searchLiteratureTool: import("@cyanheads/mcp-ts-core").Tool
79
79
  }, z.core.$strip>, readonly [{
80
80
  readonly reason: "beyond_result_window";
81
81
  readonly code: JsonRpcErrorCode.ValidationError;
82
- readonly when: "page × size exceeds the 10,000 results INSPIRE serves for one query.";
82
+ readonly when: "page × effective size (after clamping) exceeds the 10,000 results INSPIRE serves for one query.";
83
83
  readonly recovery: "Narrow the query with year_from/year_to, document_types, or tighter terms until it matches under 10,000 records, then page again with cern_inspire_search_literature.";
84
84
  readonly severity: "notice";
85
85
  }, {
@@ -1 +1 @@
1
- {"version":3,"file":"search-literature.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-literature.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAiMjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6M/B,CAAC"}
1
+ {"version":3,"file":"search-literature.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-literature.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAmMjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwN/B,CAAC"}
@@ -6,11 +6,9 @@
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, documentTypesInput, formatAppliedFilters, hasEmptyQueryField, hasFacetFilters, subjectsInput, yearFromInput, yearToInput, } from '../inputs.js';
9
+ import { arxivVersionNotice, blankAsUnset, documentTypesInput, formatAppliedFilters, hasEmptyQueryField, hasFacetFilters, moreResultsNotice, pastLastPageNotice, RESULT_WINDOW, subjectsInput, unversionArxivIds, yearFromInput, yearToInput, } from '../inputs.js';
10
10
  import { getInspireService } from '../../../services/inspire/inspire-service.js';
11
11
  import { callerEcho, identifier, inline, quote } from '../../../utils/render.js';
12
- /** INSPIRE serves at most this many results of one query (`page × size`). */
13
- const RESULT_WINDOW = 10_000;
14
12
  /** Above this many matches a query is flagged as possibly mis-parsed (Design Decisions #17). */
15
13
  const BROAD_MATCH_THRESHOLD = 100_000;
16
14
  /**
@@ -168,21 +166,21 @@ export const searchLiteratureTool = tool('cern_inspire_search_literature', {
168
166
  .trim()
169
167
  .min(1)
170
168
  .max(1000)
171
- .describe('INSPIRE query syntax or free text. Common operators: "a Jane.Doe.1" or "a Doe, J" (author), "t higgs boson" (title words), "cn atlas" or "collaboration:atlas" (collaboration), "date > 2015", "topcite 500+" (cited 500+ times), "refersto:recid:451647" (papers citing a record), "citedby:recid:451647" (its references), "j Phys.Rev.Lett." (journal), "eprint 1207.7214"; combine with and/or/not. Bare words search all fields. Empty recognized field clauses such as "a:" are invalid; other syntax is passed to INSPIRE without complete grammar validation. See cern_inspire_list_reference topic search_syntax.'),
169
+ .describe('INSPIRE query syntax or free text. Common operators: "a Jane.Doe.1" or "a Doe, J" (author), "t higgs boson" (title words), "cn atlas" or "collaboration:atlas" (collaboration), "date > 2015", "topcite 500+" (cited 500+ times), "refersto:recid:451647" (papers citing a record), "citedby:recid:451647" (its references), "j Phys.Rev.Lett." (journal), "eprint 1207.7214"; combine with and/or/not. Bare words search all fields. Empty recognized field clauses such as a: or a:"" (including whitespace-only quoted values) are invalid; other syntax is passed to INSPIRE without complete grammar validation. See cern_inspire_list_reference topic search_syntax.'),
172
170
  sort: blankAsUnset(z.enum(SORTS).default('relevance')).describe('Result order: relevance (default), mostrecent, or mostcited.'),
173
171
  document_types: documentTypesInput,
174
172
  subjects: subjectsInput,
175
173
  year_from: yearFromInput,
176
174
  year_to: yearToInput,
177
- page: blankAsUnset(z.number().int().min(1).default(1)).describe('Page number, starting at 1. page × size may not exceed 10,000.'),
178
- size: blankAsUnset(z.number().int().min(1).max(100).default(10)).describe('Papers per page (1–100, default 10).'),
175
+ 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.'),
176
+ size: blankAsUnset(z.number().int().min(1).default(10)).describe('Papers per page (positive integer, default 10; above 100 uses 100).'),
179
177
  }),
180
178
  output: z.object({
181
179
  papers: z
182
180
  .array(literatureHitSchema)
183
181
  .describe('The papers on this page, in the requested order.'),
184
182
  page: z.number().describe('The page returned.'),
185
- size: z.number().describe('The page size requested.'),
183
+ size: z.number().describe('The effective page size after clamping.'),
186
184
  hasMore: z.boolean().describe('True when INSPIRE has a further page of results.'),
187
185
  }),
188
186
  enrichment: {
@@ -193,11 +191,14 @@ export const searchLiteratureTool = tool('cern_inspire_search_literature', {
193
191
  nextPage: z
194
192
  .number()
195
193
  .optional()
196
- .describe('The page number to request next, when one exists within the 10,000-result window.'),
194
+ .describe('The page number to request next, with the same size, when one exists within the 10,000-result window.'),
197
195
  appliedFilters: z
198
196
  .string()
199
197
  .describe('Sort and filters applied, e.g. "sort=mostcited; years=2012–2015", or "none".'),
200
- notice: z.string().optional().describe('Guidance on an empty, very broad, or paged result.'),
198
+ notice: z
199
+ .string()
200
+ .optional()
201
+ .describe('Guidance on an empty, very broad, or paged result, and each arXiv clause sent without its version suffix.'),
201
202
  },
202
203
  enrichmentTrailer: {
203
204
  nextPage: { label: 'Next page' },
@@ -207,7 +208,7 @@ export const searchLiteratureTool = tool('cern_inspire_search_literature', {
207
208
  {
208
209
  reason: 'beyond_result_window',
209
210
  code: JsonRpcErrorCode.ValidationError,
210
- when: 'page × size exceeds the 10,000 results INSPIRE serves for one query.',
211
+ when: 'page × effective size (after clamping) exceeds the 10,000 results INSPIRE serves for one query.',
211
212
  recovery: 'Narrow the query with year_from/year_to, document_types, or tighter terms until it matches under 10,000 records, then page again with cern_inspire_search_literature.',
212
213
  severity: 'notice',
213
214
  },
@@ -250,7 +251,9 @@ export const searchLiteratureTool = tool('cern_inspire_search_literature', {
250
251
  thrownBy: 'service',
251
252
  },
252
253
  ],
253
- async handler(input, ctx) {
254
+ async handler(requested, ctx) {
255
+ const input = { ...requested, size: Math.min(requested.size, 100) };
256
+ const reduction = requested.size > input.size ? `size ${requested.size} reduced to ${input.size}.` : undefined;
254
257
  const filters = {
255
258
  documentTypes: input.document_types,
256
259
  subjects: input.subjects,
@@ -271,8 +274,9 @@ export const searchLiteratureTool = tool('cern_inspire_search_literature', {
271
274
  if (input.page * input.size > RESULT_WINDOW) {
272
275
  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 });
273
276
  }
277
+ const sent = unversionArxivIds(input.query);
274
278
  const inspire = getInspireService();
275
- const result = await inspire.searchLiterature({ query: input.query, sort: input.sort, page: input.page, size: input.size, ...filters }, inspire.beginCall(ctx));
279
+ const result = await inspire.searchLiterature({ query: sent.query, sort: input.sort, page: input.page, size: input.size, ...filters }, inspire.beginCall(ctx));
276
280
  ctx.enrich.total(result.total);
277
281
  ctx.enrich({ shown: result.papers.length });
278
282
  ctx.log.info('Literature search completed', {
@@ -280,9 +284,9 @@ export const searchLiteratureTool = tool('cern_inspire_search_literature', {
280
284
  shown: result.papers.length,
281
285
  page: input.page,
282
286
  });
283
- const notices = [];
287
+ const notices = [reduction, arxivVersionNotice(sent.rewrites)].filter((notice) => notice !== undefined);
284
288
  if (result.papers.length === 0) {
285
- notices.push(...zeroHitNotice(input, result.total, filters));
289
+ notices.push(...zeroHitNotice({ ...input, query: sent.query }, result.total, filters));
286
290
  }
287
291
  else if (result.total > BROAD_MATCH_THRESHOLD) {
288
292
  notices.push(`This query matched ${result.total.toLocaleString('en-US')} of INSPIRE's ~1.9 M records. INSPIRE does not reject malformed syntax (an unparsed operator widens the match), so check the query against cern_inspire_list_reference topic search_syntax.`);
@@ -293,7 +297,7 @@ export const searchLiteratureTool = tool('cern_inspire_search_literature', {
293
297
  if (reachable)
294
298
  ctx.enrich({ nextPage });
295
299
  notices.unshift(reachable
296
- ? `More results: request page ${nextPage} for the next ${input.size}.`
300
+ ? moreResultsNotice(nextPage, 'size', input.size)
297
301
  : 'INSPIRE serves only the first 10,000 results of a query; narrow it with year_from/year_to, document_types, or tighter terms to reach the rest.');
298
302
  ctx.enrich.truncated({
299
303
  shown: result.papers.length,
@@ -325,11 +329,8 @@ export const searchLiteratureTool = tool('cern_inspire_search_literature', {
325
329
  });
326
330
  /** The zero-hit notice fragments that hold for this call (design § search_literature). */
327
331
  function zeroHitNotice(input, total, filters) {
328
- if (total > 0) {
329
- return [
330
- `Page ${input.page} is past the last page (${Math.ceil(total / input.size)}); request a lower page.`,
331
- ];
332
- }
332
+ if (total > 0)
333
+ return [pastLastPageNotice(input.page, total, input.size)];
333
334
  const fragments = [`No INSPIRE literature matched "${callerEcho(input.query)}".`];
334
335
  if (hasFacetFilters(filters)) {
335
336
  fragments.push(`Filters narrowed the set (${formatAppliedFilters(filters)}); drop them to widen — multiple document_types or subjects must all hold.`);
@@ -1 +1 @@
1
- {"version":3,"file":"search-literature.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-literature.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"search-literature.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-literature.tool.ts"],"names":[],"mappings":"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"}
@@ -1,8 +1,10 @@
1
1
  /**
2
2
  * @fileoverview Input schemas and helpers shared across the INSPIRE tools: the
3
- * blank-as-unset wrapper for form clients, the `paper` identifier input and the
4
- * route from a HEPData record to its paper, the facet enum arrays (comma-joined
5
- * or array, case-folded), the year bounds, the author-identifier inputs, and the
3
+ * blank-as-unset wrapper for form clients, the paging window and past-the-end
4
+ * notice, the query scanners (the empty-field guard and the arXiv version-suffix
5
+ * rewrite with its notice), the `paper` identifier input and the route from a
6
+ * HEPData record to its paper, the facet enum arrays (comma-joined or array,
7
+ * case-folded), the year bounds, the author-identifier inputs, and the
6
8
  * applied-filters echo string.
7
9
  * @module mcp-server/tools/inputs
8
10
  */
@@ -13,12 +15,39 @@ import type { FacetFilters } from '../../services/inspire/types.js';
13
15
  * field (enums with a default included) takes the default instead of failing.
14
16
  */
15
17
  export declare const blankAsUnset: <T extends z.ZodType>(schema: T) => z.ZodPreprocess<T, unknown>;
18
+ /** INSPIRE serves at most this many results of one query (`page × size`). */
19
+ export declare const RESULT_WINDOW = 10000;
20
+ /** The notice for a page that holds nothing although the query matched `total` records. */
21
+ export declare const pastLastPageNotice: (page: number, total: number, size: number) => string;
22
+ /** The next-page notice; it names the page-size parameter and its value, since the next call must repeat the size to keep the page boundaries. */
23
+ export declare const moreResultsNotice: (nextPage: number, param: 'limit' | 'size', value: number) => string;
16
24
  /**
17
- * Finds an empty standalone recognized `field:` clause, ignoring quoted and regex values
25
+ * Finds an empty standalone recognized `field:` clause, including empty quoted values, ignoring nonempty quoted and regex values
18
26
  * and embedded selectors. This is a linear scan, not a complete query parser:
19
27
  * value negation, groups, unknown fields and nested colon values pass through.
20
28
  */
21
29
  export declare function hasEmptyQueryField(query: string): boolean;
30
+ /** One arXiv clause sent without its version suffix: the clause as the caller wrote it and as sent. */
31
+ interface ArxivVersionRewrite {
32
+ sent: string;
33
+ written: string;
34
+ }
35
+ /**
36
+ * Removes the version suffix (`v2` or `V2`) from every arXiv ID a literature query
37
+ * gives as an arXiv clause value, since INSPIRE indexes arXiv IDs without one:
38
+ * `arxiv:ID`, `eprint:ID`, and `arxiv_eprints.value:ID` (quoted, `arXiv:`-prefixed,
39
+ * or after a space), `arxiv ID` and `eprint ID` at a clause start, and a bare ID at
40
+ * a clause start (the query start, or after `(`, `and`, `or`, `not`). The values of
41
+ * other fields stay as written: `refersto:` and `citedby:` (which select by recid),
42
+ * title words, and a group given as a field's value; so do quoted phrases, regex
43
+ * values, URLs, and DOIs. One pass over quote- and regex-aware tokens, not a parser.
44
+ */
45
+ export declare function unversionArxivIds(query: string): {
46
+ query: string;
47
+ rewrites: ArxivVersionRewrite[];
48
+ };
49
+ /** The notice naming each clause `unversionArxivIds` rewrote, as written and as sent; `undefined` for none. */
50
+ export declare function arxivVersionNotice(rewrites: readonly ArxivVersionRewrite[]): string | undefined;
22
51
  /**
23
52
  * The call that leads from HEPData record `n` to its paper: the HEPData search
24
53
  * matches the record DOI and returns the record's paper recids.
@@ -95,4 +124,5 @@ export interface AppliedFilters extends FacetFilters {
95
124
  export declare function formatAppliedFilters(filters: AppliedFilters): string;
96
125
  /** True when any facet filter (document types, subjects, years) is set. */
97
126
  export declare function hasFacetFilters(filters: FacetFilters): boolean;
127
+ export {};
98
128
  //# sourceMappingURL=inputs.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/inputs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAO3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,UAAU,CAAC,gCACU,CAAC;AAgBtE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAoCzD;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,MAAO,MAAM,WACyG,CAAC;AAUtJ;;;;;GAKG;AACH,eAAO,MAAM,UAAU,uCAUpB,CAAC;AA6BJ;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;cAM9B,CAAC;AAEF,wHAAwH;AACxH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;cAEzB,CAAC;AAIF,yFAAyF;AACzF,eAAO,MAAM,aAAa,sDAEzB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,WAAW,sDAEvB,CAAC;AAKF,sHAAsH;AACtH,eAAO,MAAM,gBAAgB,uCAI1B,CAAC;AAEJ,wFAAwF;AACxF,eAAO,MAAM,aAAa,sDAOvB,CAAC;AAEJ,uGAAuG;AACvG,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAGpB;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAUpE;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAO9D"}
1
+ {"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/inputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAQ3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,UAAU,CAAC,gCACU,CAAC;AAEtE,6EAA6E;AAC7E,eAAO,MAAM,aAAa,QAAS,CAAC;AAEpC,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,SAAU,MAAM,SAAS,MAAM,QAAQ,MAAM,KAAG,MACW,CAAC;AAE3F,kJAAkJ;AAClJ,eAAO,MAAM,iBAAiB,aAClB,MAAM,SACT,OAAO,GAAG,MAAM,SAChB,MAAM,KACZ,MAA0E,CAAC;AAgB9E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAgDzD;AAQD,uGAAuG;AACvG,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,CA6IA;AAED,+GAA+G;AAC/G,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,GAAG,SAAS,CAM/F;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,MAAO,MAAM,WACyG,CAAC;AAUtJ;;;;;GAKG;AACH,eAAO,MAAM,UAAU,uCAUpB,CAAC;AA6BJ;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;cAM9B,CAAC;AAEF,wHAAwH;AACxH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;cAEzB,CAAC;AAIF,yFAAyF;AACzF,eAAO,MAAM,aAAa,sDAEzB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,WAAW,sDAEvB,CAAC;AAKF,sHAAsH;AACtH,eAAO,MAAM,gBAAgB,uCAI1B,CAAC;AAEJ,wFAAwF;AACxF,eAAO,MAAM,aAAa,sDAOvB,CAAC;AAEJ,uGAAuG;AACvG,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAGpB;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAUpE;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAO9D"}