@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.
- package/AGENTS.md +39 -39
- package/CLAUDE.md +39 -39
- package/Dockerfile +8 -3
- package/README.md +59 -115
- package/changelog/0.1.x/0.1.3.md +34 -0
- package/changelog/0.2.x/0.2.0.md +35 -0
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/index.d.ts +10 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts +10 -0
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.js +1 -1
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.js.map +1 -1
- package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts +48 -4
- package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/export-citations.tool.js +51 -25
- package/dist/mcp-server/tools/definitions/export-citations.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js +10 -7
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts +22 -1
- package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-paper.tool.js +79 -23
- package/dist/mcp-server/tools/definitions/get-paper.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +146 -91
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-reference.tool.js +6 -1
- package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-authors.tool.js +7 -3
- package/dist/mcp-server/tools/definitions/search-authors.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-experiments.tool.js +17 -10
- package/dist/mcp-server/tools/definitions/search-experiments.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.js +8 -6
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts +3 -3
- package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-literature.tool.js +16 -11
- package/dist/mcp-server/tools/definitions/search-literature.tool.js.map +1 -1
- package/dist/mcp-server/tools/inputs.d.ts +6 -0
- package/dist/mcp-server/tools/inputs.d.ts.map +1 -1
- package/dist/mcp-server/tools/inputs.js +71 -0
- package/dist/mcp-server/tools/inputs.js.map +1 -1
- package/dist/services/inspire/inspire-service.d.ts +11 -3
- package/dist/services/inspire/inspire-service.d.ts.map +1 -1
- package/dist/services/inspire/inspire-service.js +58 -37
- package/dist/services/inspire/inspire-service.js.map +1 -1
- package/dist/services/inspire/normalize.d.ts +3 -2
- package/dist/services/inspire/normalize.d.ts.map +1 -1
- package/dist/services/inspire/normalize.js +23 -3
- package/dist/services/inspire/normalize.js.map +1 -1
- package/dist/services/inspire/types.d.ts +27 -7
- package/dist/services/inspire/types.d.ts.map +1 -1
- package/dist/utils/render.d.ts +6 -4
- package/dist/utils/render.d.ts.map +1 -1
- package/dist/utils/render.js +8 -4
- package/dist/utils/render.js.map +1 -1
- package/package.json +12 -11
- package/server.json +10 -24
- 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
|
|
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).
|
|
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
|
|
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: '
|
|
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,
|
|
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(
|
|
107
|
-
|
|
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
|
|
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
|
-
:
|
|
144
|
-
?
|
|
145
|
-
:
|
|
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
|
|
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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,
|
|
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: "
|
|
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;
|
|
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: '
|
|
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 "${
|
|
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 "${
|
|
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:
|
|
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
|
|
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:
|
|
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,
|
|
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
|
|
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('
|
|
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
|
|
88
|
+
.describe('Affiliations listed for this contributor on this paper.'),
|
|
72
89
|
})
|
|
73
|
-
.describe('One
|
|
74
|
-
.describe('
|
|
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('', `###
|
|
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:
|
|
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).
|
|
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
|
|
341
|
-
|
|
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
|
|
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
|
-
|
|
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,
|
|
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 "${
|
|
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 "${
|
|
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 =
|
|
454
|
+
const capped = input.author_offset + shown < authorsInRecord;
|
|
402
455
|
if (capped) {
|
|
403
|
-
notices.push(
|
|
404
|
-
? `
|
|
405
|
-
: `Showing ${
|
|
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
|
|
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(' '));
|