@cyanheads/cern-inspire-mcp-server 0.1.1 → 0.1.2
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 +11 -8
- package/CLAUDE.md +11 -8
- package/README.md +60 -33
- package/changelog/0.1.x/0.1.2.md +29 -0
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/index.d.ts +13 -5
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts +13 -5
- 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 +10 -1
- package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/export-citations.tool.js +83 -19
- 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 +6 -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 +71 -19
- 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 +26 -10
- package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-paper.tool.js +107 -40
- package/dist/mcp-server/tools/definitions/get-paper.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +30 -9
- 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 +27 -8
- 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 +9 -9
- 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 +6 -3
- package/dist/mcp-server/tools/definitions/search-experiments.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.js +14 -12
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-literature.tool.js +22 -11
- package/dist/mcp-server/tools/definitions/search-literature.tool.js.map +1 -1
- package/dist/mcp-server/tools/inputs.d.ts +17 -5
- package/dist/mcp-server/tools/inputs.d.ts.map +1 -1
- package/dist/mcp-server/tools/inputs.js +29 -10
- package/dist/mcp-server/tools/inputs.js.map +1 -1
- package/dist/services/inspire/identifiers.d.ts +17 -6
- package/dist/services/inspire/identifiers.d.ts.map +1 -1
- package/dist/services/inspire/identifiers.js +28 -7
- package/dist/services/inspire/identifiers.js.map +1 -1
- package/dist/services/inspire/inspire-service.d.ts +78 -18
- package/dist/services/inspire/inspire-service.d.ts.map +1 -1
- package/dist/services/inspire/inspire-service.js +293 -52
- package/dist/services/inspire/inspire-service.js.map +1 -1
- package/dist/services/inspire/markup-to-text.d.ts +32 -0
- package/dist/services/inspire/markup-to-text.d.ts.map +1 -0
- package/dist/services/inspire/markup-to-text.js +783 -0
- package/dist/services/inspire/markup-to-text.js.map +1 -0
- package/dist/services/inspire/normalize.d.ts +23 -6
- package/dist/services/inspire/normalize.d.ts.map +1 -1
- package/dist/services/inspire/normalize.js +94 -21
- package/dist/services/inspire/normalize.js.map +1 -1
- package/dist/services/inspire/types.d.ts +73 -5
- package/dist/services/inspire/types.d.ts.map +1 -1
- package/dist/utils/render.d.ts +34 -5
- package/dist/utils/render.d.ts.map +1 -1
- package/dist/utils/render.js +69 -16
- package/dist/utils/render.js.map +1 -1
- package/package.json +1 -1
- package/server.json +9 -3
|
@@ -8,14 +8,16 @@ import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
|
8
8
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
9
9
|
import { blankAsUnset } from '../inputs.js';
|
|
10
10
|
import { getInspireService } from '../../../services/inspire/inspire-service.js';
|
|
11
|
-
import { fenced,
|
|
11
|
+
import { callerEcho, fenced, identifier } from '../../../utils/render.js';
|
|
12
12
|
const FORMATS = ['bibtex', 'latex-eu', 'latex-us'];
|
|
13
13
|
const SORTS = ['relevance', 'mostrecent', 'mostcited'];
|
|
14
14
|
/** Upper bound on `size`. */
|
|
15
15
|
const MAX_ENTRIES = 50;
|
|
16
|
+
/** INSPIRE serves at most this many results of one query (`page × size`). */
|
|
17
|
+
const RESULT_WINDOW = 10_000;
|
|
16
18
|
export const exportCitationsTool = tool('cern_inspire_export_citations', {
|
|
17
19
|
title: 'Export INSPIRE citations',
|
|
18
|
-
description: 'Export INSPIRE-HEP\'s citation entries for the papers a literature query selects, as BibTeX or LaTeX \\bibitem entries (EU or US style), keyed by INSPIRE texkeys and ready to paste into a bibliography. Name specific papers with "recid:451647 or arxiv:1207.7214 or doi:10.1016/…", or export a topic, author, or citing set with any query cern_inspire_search_literature accepts. Entries are INSPIRE\'s verbatim text (long author lists arrive abbreviated as "First, Name and others").',
|
|
20
|
+
description: 'Export INSPIRE-HEP\'s citation entries for the papers a literature query selects, as BibTeX or LaTeX \\bibitem entries (EU or US style), keyed by INSPIRE texkeys and ready to paste into a bibliography. Name specific papers with "recid:451647 or arxiv:1207.7214 or doi:10.1016/…", or export a topic, author, or citing set with any query cern_inspire_search_literature accepts. Up to 50 entries per page; page through larger sets (only the first 10,000 matches are reachable). Entries are INSPIRE\'s verbatim text (long author lists arrive abbreviated as "First, Name and others").',
|
|
19
21
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
|
|
20
22
|
input: z.object({
|
|
21
23
|
query: z
|
|
@@ -26,12 +28,14 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
|
|
|
26
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.'),
|
|
27
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).'),
|
|
28
30
|
sort: blankAsUnset(z.enum(SORTS).default('relevance')).describe('Entry order: relevance (default), mostrecent, or mostcited.'),
|
|
29
|
-
|
|
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).'),
|
|
30
33
|
}),
|
|
31
34
|
// The sibling top-N tools (search_authors, search_experiments) call their cap `limit`.
|
|
32
35
|
inputAliases: { limit: 'size' },
|
|
33
36
|
output: z.object({
|
|
34
37
|
format: z.enum(FORMATS).describe('The entry format returned.'),
|
|
38
|
+
page: z.number().describe('The page returned.'),
|
|
35
39
|
entries: z
|
|
36
40
|
.array(z
|
|
37
41
|
.object({
|
|
@@ -44,15 +48,29 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
|
|
|
44
48
|
.describe('Citation entries, in the requested order.'),
|
|
45
49
|
}),
|
|
46
50
|
enrichment: {
|
|
47
|
-
truncated: z.boolean().describe('True when more papers
|
|
48
|
-
shown: z.number().describe('Number of entries
|
|
49
|
-
cap: z.number().describe('The size
|
|
51
|
+
truncated: z.boolean().describe('True when more matched papers follow this page.'),
|
|
52
|
+
shown: z.number().describe('Number of entries on this page.'),
|
|
53
|
+
cap: z.number().describe('The page size applied.'),
|
|
54
|
+
nextPage: z
|
|
55
|
+
.number()
|
|
56
|
+
.optional()
|
|
57
|
+
.describe('The page number to request next, when more papers follow within the 10,000-result window.'),
|
|
50
58
|
notice: z
|
|
51
59
|
.string()
|
|
52
60
|
.optional()
|
|
53
|
-
.describe('Guidance when nothing matched or the
|
|
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.'),
|
|
62
|
+
},
|
|
63
|
+
enrichmentTrailer: {
|
|
64
|
+
nextPage: { label: 'Next page' },
|
|
54
65
|
},
|
|
55
66
|
errors: [
|
|
67
|
+
{
|
|
68
|
+
reason: 'beyond_result_window',
|
|
69
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
70
|
+
when: 'page × size exceeds the 10,000 results INSPIRE serves for one query.',
|
|
71
|
+
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
|
+
severity: 'notice',
|
|
73
|
+
},
|
|
56
74
|
{
|
|
57
75
|
reason: 'invalid_query',
|
|
58
76
|
code: JsonRpcErrorCode.ValidationError,
|
|
@@ -81,40 +99,86 @@ export const exportCitationsTool = tool('cern_inspire_export_citations', {
|
|
|
81
99
|
reason: 'upstream_unreadable',
|
|
82
100
|
code: JsonRpcErrorCode.ServiceUnavailable,
|
|
83
101
|
when: 'The INSPIRE body exceeded the byte ceiling, or was JSON or HTML where citation text was expected.',
|
|
84
|
-
recovery: 'Retry this call in a few seconds; if it fails again,
|
|
102
|
+
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.',
|
|
85
103
|
thrownBy: 'service',
|
|
86
104
|
},
|
|
87
105
|
],
|
|
88
106
|
async handler(input, ctx) {
|
|
89
107
|
ctx.enrich({ truncated: false, shown: 0, cap: input.size });
|
|
108
|
+
if (input.page * input.size > RESULT_WINDOW) {
|
|
109
|
+
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
|
+
}
|
|
90
111
|
const inspire = getInspireService();
|
|
91
|
-
const result = await inspire.exportCitations({
|
|
112
|
+
const result = await inspire.exportCitations({
|
|
113
|
+
query: input.query,
|
|
114
|
+
format: input.format,
|
|
115
|
+
sort: input.sort,
|
|
116
|
+
page: input.page,
|
|
117
|
+
size: input.size,
|
|
118
|
+
}, inspire.beginCall(ctx));
|
|
92
119
|
const shown = result.entries.length;
|
|
93
120
|
ctx.enrich({ shown });
|
|
94
121
|
ctx.log.info('Citation export completed', {
|
|
95
122
|
format: input.format,
|
|
123
|
+
page: input.page,
|
|
96
124
|
shown,
|
|
125
|
+
total: result.total,
|
|
97
126
|
truncated: result.truncated,
|
|
98
127
|
});
|
|
128
|
+
const unchecked = input.page > 1 && result.total === undefined;
|
|
129
|
+
const notices = [];
|
|
99
130
|
if (shown === 0) {
|
|
100
|
-
|
|
131
|
+
notices.push(emptyPageNotice(input, result.total));
|
|
132
|
+
}
|
|
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).");
|
|
101
135
|
}
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
136
|
+
if (result.truncated) {
|
|
137
|
+
const nextPage = input.page + 1;
|
|
138
|
+
const reachable = nextPage * input.size <= RESULT_WINDOW;
|
|
139
|
+
if (reachable)
|
|
140
|
+
ctx.enrich({ nextPage });
|
|
141
|
+
notices.unshift(!reachable
|
|
142
|
+
? '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
|
+
: ''}.`);
|
|
148
|
+
ctx.enrich.truncated({ shown, cap: input.size, guidance: notices.join(' ') });
|
|
108
149
|
}
|
|
109
|
-
|
|
150
|
+
else if (notices.length > 0) {
|
|
151
|
+
ctx.enrich.notice(notices.join(' '));
|
|
152
|
+
}
|
|
153
|
+
return { format: input.format, page: input.page, entries: result.entries };
|
|
110
154
|
},
|
|
111
155
|
format: (result) => {
|
|
112
|
-
const
|
|
156
|
+
const count = result.entries.length;
|
|
157
|
+
const lines = [
|
|
158
|
+
`## INSPIRE citations, page ${result.page} (${result.format}, ${count} ${count === 1 ? 'entry' : 'entries'})`,
|
|
159
|
+
];
|
|
113
160
|
if (result.entries.length > 0) {
|
|
114
|
-
const keys = result.entries.map((e) => (e.texkey ?
|
|
161
|
+
const keys = result.entries.map((e) => (e.texkey ? identifier(e.texkey) : '(no texkey)'));
|
|
115
162
|
lines.push(`**Texkeys:** ${keys.join(', ')}`, '', fenced(result.entries.map((e) => e.text).join('\n\n'), result.format === 'bibtex' ? 'bibtex' : 'latex'));
|
|
116
163
|
}
|
|
117
164
|
return [{ type: 'text', text: lines.join('\n') }];
|
|
118
165
|
},
|
|
119
166
|
});
|
|
167
|
+
/**
|
|
168
|
+
* 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.
|
|
170
|
+
*/
|
|
171
|
+
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
|
+
if (total === undefined || total === 0) {
|
|
176
|
+
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
|
+
}
|
|
178
|
+
const lastPage = Math.ceil(total / input.size);
|
|
179
|
+
if ((input.page - 1) * input.size >= total) {
|
|
180
|
+
return `Page ${input.page} is past the last page (${lastPage}); request a lower page.`;
|
|
181
|
+
}
|
|
182
|
+
return `Page ${input.page} came back empty although INSPIRE counts ${total} matches (${lastPage} pages at this size); retry this call in a few seconds.`;
|
|
183
|
+
}
|
|
120
184
|
//# sourceMappingURL=export-citations.tool.js.map
|
|
@@ -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,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,
|
|
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,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @fileoverview cern_inspire_get_citation_summary — INSPIRE's citation summary
|
|
3
3
|
* (h-index, citation totals and averages, papers per citation bucket, for all
|
|
4
|
-
* citeable and for published papers) for one author
|
|
5
|
-
* literature query, narrowed by document type, subject, and year.
|
|
4
|
+
* citeable and for published papers) and citations per year for one author
|
|
5
|
+
* identifier or any literature query, narrowed by document type, subject, and year.
|
|
6
6
|
* @module mcp-server/tools/definitions/get-citation-summary.tool
|
|
7
7
|
*/
|
|
8
8
|
import { z } from '@cyanheads/mcp-ts-core';
|
|
@@ -100,6 +100,10 @@ export declare const getCitationSummaryTool: import("@cyanheads/mcp-ts-core").To
|
|
|
100
100
|
papers: z.ZodNumber;
|
|
101
101
|
}, z.core.$strip>>;
|
|
102
102
|
}, z.core.$strip>;
|
|
103
|
+
citationsByYear: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
104
|
+
year: z.ZodNumber;
|
|
105
|
+
citations: z.ZodNumber;
|
|
106
|
+
}, z.core.$strip>>>;
|
|
103
107
|
}, z.core.$strip>, readonly [{
|
|
104
108
|
readonly reason: "missing_target";
|
|
105
109
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
@@ -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;AAyFjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwTjC,CAAC"}
|
|
@@ -1,17 +1,31 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @fileoverview cern_inspire_get_citation_summary — INSPIRE's citation summary
|
|
3
3
|
* (h-index, citation totals and averages, papers per citation bucket, for all
|
|
4
|
-
* citeable and for published papers) for one author
|
|
5
|
-
* literature query, narrowed by document type, subject, and year.
|
|
4
|
+
* citeable and for published papers) and citations per year for one author
|
|
5
|
+
* identifier or any literature query, narrowed by document type, subject, and year.
|
|
6
6
|
* @module mcp-server/tools/definitions/get-citation-summary.tool
|
|
7
7
|
*/
|
|
8
8
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
9
9
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
10
10
|
import { authorIdInput, blankAsUnset, documentTypesInput, formatAppliedFilters, subjectsInput, yearFromInput, yearToInput, } from '../inputs.js';
|
|
11
11
|
import { containsOrcid, routeAuthorQuery } from '../../../services/inspire/identifiers.js';
|
|
12
|
-
import { getInspireService } from '../../../services/inspire/inspire-service.js';
|
|
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 { cell, inline } from '../../../utils/render.js';
|
|
14
|
+
import { callerEcho, cell, inline } from '../../../utils/render.js';
|
|
15
|
+
/**
|
|
16
|
+
* Up to this many matched records, a repeat of a cut series may be answered from
|
|
17
|
+
* INSPIRE's cache: measured 2026-10-01/02, 210,258 records were cached and served
|
|
18
|
+
* warm 40 s later and 278,875 counted cold in 24.6 s, while 644,458 and 1,278,435
|
|
19
|
+
* drew a 500 after 30.5 s and cached nothing. Past it the notice says only to narrow.
|
|
20
|
+
*/
|
|
21
|
+
const REPEATABLE_SERIES_RECORDS = 300_000;
|
|
22
|
+
/** The input that sets each filter the per-year series ignores. */
|
|
23
|
+
const IGNORED_FILTER_INPUTS = {
|
|
24
|
+
yearFrom: 'year_from',
|
|
25
|
+
yearTo: 'year_to',
|
|
26
|
+
excludeSelfCitations: 'exclude_self_citations',
|
|
27
|
+
};
|
|
28
|
+
const conjunction = new Intl.ListFormat('en', { type: 'conjunction' });
|
|
15
29
|
const totalsSchema = (scope) => z
|
|
16
30
|
.object({
|
|
17
31
|
papers: z.number().describe(`Number of ${scope} papers.`),
|
|
@@ -53,16 +67,16 @@ function renderBuckets(all, published) {
|
|
|
53
67
|
}
|
|
54
68
|
export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary', {
|
|
55
69
|
title: 'Get INSPIRE citation summary',
|
|
56
|
-
description: 'Compute INSPIRE-HEP\'s citation summary for one author or for any literature query: h-index, citation totals, average citations per paper, and paper counts per citation bucket (0, 1–9, 10–49, 50–99, 100–249, 250–499, 500+), each for all citeable papers and for published papers. Pass exactly one of author (a BAI, ORCID, INSPIRE ID, or author recid — resolve a name with cern_inspire_search_authors first) or query (any INSPIRE literature query: a topic, collaboration, institution, or "a <BAI>"). Document type
|
|
70
|
+
description: 'Compute INSPIRE-HEP\'s citation summary for one author or for any literature query: h-index, citation totals, average citations per paper, and paper counts per citation bucket (0, 1–9, 10–49, 50–99, 100–249, 250–499, 500+), each for all citeable papers and for published papers, plus citations received per year. Pass exactly one of author (a BAI, ORCID, INSPIRE ID, or author recid — resolve a name with cern_inspire_search_authors first) or query (any INSPIRE literature query: a topic, collaboration, institution, or "a <BAI>"). Document type and subject filters narrow every figure. year_from and year_to narrow the summary to papers from those years, and exclude_self_citations recounts it without self-citations; any of them leaves out citations per year, which INSPIRE cannot narrow that way.',
|
|
57
71
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
|
|
58
72
|
input: z.object({
|
|
59
73
|
author: authorIdInput,
|
|
60
|
-
query: blankAsUnset(z.string().trim().max(1000).optional()).describe('An INSPIRE literature query, e.g. "collaboration:atlas", "t neutrino oscillation", "a Edward.Witten.1". 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). Literature queries do not match ORCIDs; pass an ORCID as author. Pass this or author, not both.'),
|
|
61
75
|
document_types: documentTypesInput,
|
|
62
76
|
subjects: subjectsInput,
|
|
63
77
|
year_from: yearFromInput,
|
|
64
78
|
year_to: yearToInput,
|
|
65
|
-
exclude_self_citations: blankAsUnset(z.boolean().default(false)).describe("Count citations without self-citations (INSPIRE's definition), default false."),
|
|
79
|
+
exclude_self_citations: blankAsUnset(z.boolean().default(false)).describe("Count citations without self-citations (INSPIRE's definition), default false. Setting it leaves out citationsByYear, which always includes self-citations."),
|
|
66
80
|
}),
|
|
67
81
|
output: z.object({
|
|
68
82
|
target: z
|
|
@@ -99,17 +113,31 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
|
|
|
99
113
|
published: bucketsSchema('published'),
|
|
100
114
|
})
|
|
101
115
|
.describe('Papers per citation range, for all citeable and for published papers.'),
|
|
116
|
+
citationsByYear: z
|
|
117
|
+
.array(z
|
|
118
|
+
.object({
|
|
119
|
+
year: z.number().describe("Year of the citing records' earliest date."),
|
|
120
|
+
citations: z
|
|
121
|
+
.number()
|
|
122
|
+
.describe('Citations the matched records received from records of that year.'),
|
|
123
|
+
})
|
|
124
|
+
.describe('Citations received in one year.'))
|
|
125
|
+
.optional()
|
|
126
|
+
.describe("Citations per year in ascending order, each counted in the year of the citing record's earliest date, self-citations included, over every matched record (citeable or not), so the sum can exceed all.citations. A year without citations has no row, and the current year counts citations to date. Empty when nothing matched or no matched record is cited; omitted when year_from, year_to, or exclude_self_citations is set, when INSPIRE did not return the series, or when the query matches more than about 150,000 records, which INSPIRE cannot count in time, unless INSPIRE answers within about 2 s (a series it has cached)."),
|
|
102
127
|
}),
|
|
103
128
|
enrichment: {
|
|
104
129
|
effectiveQuery: z.string().describe('The literature query sent to INSPIRE.'),
|
|
105
130
|
appliedFilters: z
|
|
106
131
|
.string()
|
|
107
132
|
.describe('Filters applied, e.g. "document_types=published; years=2012–2015; exclude_self_citations=true", or "none".'),
|
|
108
|
-
notice: z
|
|
133
|
+
notice: z
|
|
134
|
+
.string()
|
|
135
|
+
.optional()
|
|
136
|
+
.describe('Guidance when no citeable paper matched, or when citations per year were left out or could not be read.'),
|
|
109
137
|
},
|
|
110
138
|
enrichmentTrailer: {
|
|
111
|
-
// The
|
|
112
|
-
effectiveQuery: { render: (query) => `Query: ${
|
|
139
|
+
// The framework prints an echo unescaped; callerEcho() flattens it to one line and keeps it sendable as written.
|
|
140
|
+
effectiveQuery: { render: (query) => `Query: ${callerEcho(query)}` },
|
|
113
141
|
appliedFilters: { label: 'Applied filters' },
|
|
114
142
|
},
|
|
115
143
|
errors: [
|
|
@@ -203,11 +231,11 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
|
|
|
203
231
|
if (input.author) {
|
|
204
232
|
const route = routeAuthorQuery(input.author);
|
|
205
233
|
if (route.matchedAs === 'name') {
|
|
206
|
-
throw ctx.fail('author_not_identifier', `author "${
|
|
234
|
+
throw ctx.fail('author_not_identifier', `author "${callerEcho(input.author)}" is not a BAI, ORCID, INSPIRE ID, or author recid.`, { author: input.author });
|
|
207
235
|
}
|
|
208
236
|
const resolved = await inspire.resolveAuthor(route, call);
|
|
209
237
|
if (!resolved) {
|
|
210
|
-
throw ctx.fail('author_not_found', `No INSPIRE author profile matched "${
|
|
238
|
+
throw ctx.fail('author_not_found', `No INSPIRE author profile matched "${callerEcho(input.author)}" as ${route.matchedAs}.`, { author: input.author, matchedAs: route.matchedAs });
|
|
211
239
|
}
|
|
212
240
|
target = {
|
|
213
241
|
kind: 'author',
|
|
@@ -220,22 +248,40 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
|
|
|
220
248
|
target = { kind: 'query', query: input.query ?? '' };
|
|
221
249
|
}
|
|
222
250
|
ctx.enrich.echo(target.query);
|
|
223
|
-
const summary = await inspire.getCitationSummary({ query: target.query, excludeSelfCitations: input.exclude_self_citations, ...filters }, call);
|
|
251
|
+
const { summary, series } = await inspire.getCitationSummary({ query: target.query, excludeSelfCitations: input.exclude_self_citations, ...filters }, call);
|
|
224
252
|
ctx.log.info('Citation summary computed', {
|
|
225
253
|
kind: target.kind,
|
|
226
254
|
matchedRecords: summary.matchedRecords,
|
|
227
255
|
citeablePapers: summary.citeablePapers,
|
|
256
|
+
citationsByYear: series.status,
|
|
228
257
|
});
|
|
258
|
+
const notices = [];
|
|
229
259
|
if (summary.citeablePapers === 0) {
|
|
230
|
-
|
|
231
|
-
'No citeable papers matched; the summary is all zeros. Check the query with cern_inspire_search_literature first.',
|
|
232
|
-
];
|
|
260
|
+
notices.push('No citeable papers matched; the summary is all zeros. Check the query with cern_inspire_search_literature first.');
|
|
233
261
|
if (input.query && containsOrcid(input.query)) {
|
|
234
262
|
notices.push('Literature queries do not match ORCIDs; pass the ORCID as author instead.');
|
|
235
263
|
}
|
|
236
|
-
ctx.enrich.notice(notices.join(' '));
|
|
237
264
|
}
|
|
238
|
-
|
|
265
|
+
if (series.status === 'skipped') {
|
|
266
|
+
const ignored = conjunction.format(series.ignoredFilters.map((f) => IGNORED_FILTER_INPUTS[f]));
|
|
267
|
+
notices.push(`Citations per year are not included: INSPIRE's per-year series ignores ${ignored}, so it would not match the filtered figures. Call again without ${ignored} for citations per year (all years, self-citations included).`);
|
|
268
|
+
}
|
|
269
|
+
else if (series.status === 'too_broad') {
|
|
270
|
+
const next = summary.matchedRecords <= REPEATABLE_SERIES_RECORDS
|
|
271
|
+
? 'Repeat this call in about 30 s, since INSPIRE may finish the count meanwhile and answer from its cache, or narrow the query text, document_types, or subjects'
|
|
272
|
+
: 'Narrow the query text, document_types, or subjects for them';
|
|
273
|
+
notices.push(`Citations per year are not included: this query matches ${summary.matchedRecords.toLocaleString('en-US')} records, and past about ${BROAD_SERIES_RECORDS.toLocaleString('en-US')} INSPIRE takes longer than ${CITATIONS_BY_YEAR_BUDGET_MS / 1000} s to count them. ${next} (year_from and year_to leave citations per year out).`);
|
|
274
|
+
}
|
|
275
|
+
else if (series.status === 'failed') {
|
|
276
|
+
notices.push('Citations per year could not be read from INSPIRE this time; every other figure is complete. Retry this call for them.');
|
|
277
|
+
}
|
|
278
|
+
if (notices.length > 0)
|
|
279
|
+
ctx.enrich.notice(notices.join(' '));
|
|
280
|
+
return {
|
|
281
|
+
target,
|
|
282
|
+
...summary,
|
|
283
|
+
...(series.status === 'read' ? { citationsByYear: series.rows } : {}),
|
|
284
|
+
};
|
|
239
285
|
},
|
|
240
286
|
format: (result) => {
|
|
241
287
|
const t = result.target;
|
|
@@ -244,7 +290,7 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
|
|
|
244
290
|
: undefined;
|
|
245
291
|
const lines = [
|
|
246
292
|
`## INSPIRE citation summary${subject ? ` — ${subject}` : ''}`,
|
|
247
|
-
`**Target kind:** ${t.kind} · **Query:** ${
|
|
293
|
+
`**Target kind:** ${t.kind} · **Query:** ${callerEcho(t.query)}`,
|
|
248
294
|
`**Matched records:** ${result.matchedRecords} · **Citeable papers:** ${result.citeablePapers}`,
|
|
249
295
|
`**h-index:** ${result.hIndex.all} (all citeable) · ${result.hIndex.published} (published)`,
|
|
250
296
|
'',
|
|
@@ -256,6 +302,12 @@ export const getCitationSummaryTool = tool('cern_inspire_get_citation_summary',
|
|
|
256
302
|
if (result.buckets.all.length > 0 || result.buckets.published.length > 0) {
|
|
257
303
|
lines.push('', ...renderBuckets(result.buckets.all, result.buckets.published));
|
|
258
304
|
}
|
|
305
|
+
if (result.citationsByYear?.length === 0) {
|
|
306
|
+
lines.push('', '**Citations per year:** none recorded');
|
|
307
|
+
}
|
|
308
|
+
else if (result.citationsByYear) {
|
|
309
|
+
lines.push('', "**Citations per year** — by the citing record's earliest date, self-citations included, over every matched record (citeable or not):", '', '| Year | Citations |', '|:--|--:|', ...result.citationsByYear.map((row) => `| ${row.year} | ${row.citations} |`));
|
|
310
|
+
}
|
|
259
311
|
return [{ type: 'text', text: lines.join('\n') }];
|
|
260
312
|
},
|
|
261
313
|
});
|
|
@@ -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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"}
|
|
@@ -11,6 +11,7 @@ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
|
11
11
|
/** The `get_paper` dossier — the tool's output and the literature resource's body. */
|
|
12
12
|
export declare const paperDossierSchema: z.ZodObject<{
|
|
13
13
|
recid: z.ZodString;
|
|
14
|
+
mergedFrom: z.ZodOptional<z.ZodString>;
|
|
14
15
|
resolvedAs: z.ZodEnum<{
|
|
15
16
|
arxiv: "arxiv";
|
|
16
17
|
doi: "doi";
|
|
@@ -71,16 +72,23 @@ export declare const paperDossierSchema: z.ZodObject<{
|
|
|
71
72
|
citingQuery: z.ZodString;
|
|
72
73
|
referencesQuery: z.ZodString;
|
|
73
74
|
hepdata: z.ZodObject<{
|
|
74
|
-
status: z.ZodEnum<{
|
|
75
|
-
available: "available";
|
|
76
|
-
lookup_failed: "lookup_failed";
|
|
77
|
-
none: "none";
|
|
78
|
-
}>;
|
|
79
75
|
inspireDataRecid: z.ZodOptional<z.ZodString>;
|
|
80
76
|
recordDoi: z.ZodOptional<z.ZodString>;
|
|
81
77
|
latestVersion: z.ZodOptional<z.ZodNumber>;
|
|
82
78
|
tableCount: z.ZodOptional<z.ZodNumber>;
|
|
83
79
|
hepdataUrl: z.ZodOptional<z.ZodString>;
|
|
80
|
+
status: z.ZodEnum<{
|
|
81
|
+
available: "available";
|
|
82
|
+
lookup_failed: "lookup_failed";
|
|
83
|
+
none: "none";
|
|
84
|
+
}>;
|
|
85
|
+
otherRecords: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
86
|
+
inspireDataRecid: z.ZodOptional<z.ZodString>;
|
|
87
|
+
recordDoi: z.ZodOptional<z.ZodString>;
|
|
88
|
+
latestVersion: z.ZodOptional<z.ZodNumber>;
|
|
89
|
+
tableCount: z.ZodOptional<z.ZodNumber>;
|
|
90
|
+
hepdataUrl: z.ZodOptional<z.ZodString>;
|
|
91
|
+
}, z.core.$strip>>>;
|
|
84
92
|
}, z.core.$strip>;
|
|
85
93
|
}, z.core.$strip>;
|
|
86
94
|
export type PaperDossierOutput = z.infer<typeof paperDossierSchema>;
|
|
@@ -89,6 +97,7 @@ export declare const getPaperTool: import("@cyanheads/mcp-ts-core").ToolDefiniti
|
|
|
89
97
|
max_authors: z.ZodPreprocess<z.ZodDefault<z.ZodNumber>, unknown>;
|
|
90
98
|
}, z.core.$strip>, z.ZodObject<{
|
|
91
99
|
recid: z.ZodString;
|
|
100
|
+
mergedFrom: z.ZodOptional<z.ZodString>;
|
|
92
101
|
resolvedAs: z.ZodEnum<{
|
|
93
102
|
arxiv: "arxiv";
|
|
94
103
|
doi: "doi";
|
|
@@ -149,16 +158,23 @@ export declare const getPaperTool: import("@cyanheads/mcp-ts-core").ToolDefiniti
|
|
|
149
158
|
citingQuery: z.ZodString;
|
|
150
159
|
referencesQuery: z.ZodString;
|
|
151
160
|
hepdata: z.ZodObject<{
|
|
152
|
-
status: z.ZodEnum<{
|
|
153
|
-
available: "available";
|
|
154
|
-
lookup_failed: "lookup_failed";
|
|
155
|
-
none: "none";
|
|
156
|
-
}>;
|
|
157
161
|
inspireDataRecid: z.ZodOptional<z.ZodString>;
|
|
158
162
|
recordDoi: z.ZodOptional<z.ZodString>;
|
|
159
163
|
latestVersion: z.ZodOptional<z.ZodNumber>;
|
|
160
164
|
tableCount: z.ZodOptional<z.ZodNumber>;
|
|
161
165
|
hepdataUrl: z.ZodOptional<z.ZodString>;
|
|
166
|
+
status: z.ZodEnum<{
|
|
167
|
+
available: "available";
|
|
168
|
+
lookup_failed: "lookup_failed";
|
|
169
|
+
none: "none";
|
|
170
|
+
}>;
|
|
171
|
+
otherRecords: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
172
|
+
inspireDataRecid: z.ZodOptional<z.ZodString>;
|
|
173
|
+
recordDoi: z.ZodOptional<z.ZodString>;
|
|
174
|
+
latestVersion: z.ZodOptional<z.ZodNumber>;
|
|
175
|
+
tableCount: z.ZodOptional<z.ZodNumber>;
|
|
176
|
+
hepdataUrl: z.ZodOptional<z.ZodString>;
|
|
177
|
+
}, z.core.$strip>>>;
|
|
162
178
|
}, z.core.$strip>;
|
|
163
179
|
}, z.core.$strip>, readonly [{
|
|
164
180
|
readonly reason: "paper_not_found";
|
|
@@ -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;
|
|
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"}
|