@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.
Files changed (71) hide show
  1. package/AGENTS.md +11 -8
  2. package/CLAUDE.md +11 -8
  3. package/README.md +60 -33
  4. package/changelog/0.1.x/0.1.2.md +29 -0
  5. package/dist/index.js +1 -1
  6. package/dist/index.js.map +1 -1
  7. package/dist/mcp-server/resources/definitions/index.d.ts +13 -5
  8. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  9. package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts +13 -5
  10. package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts.map +1 -1
  11. package/dist/mcp-server/resources/definitions/inspire-literature.resource.js +1 -1
  12. package/dist/mcp-server/resources/definitions/inspire-literature.resource.js.map +1 -1
  13. package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts +10 -1
  14. package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts.map +1 -1
  15. package/dist/mcp-server/tools/definitions/export-citations.tool.js +83 -19
  16. package/dist/mcp-server/tools/definitions/export-citations.tool.js.map +1 -1
  17. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts +6 -2
  18. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts.map +1 -1
  19. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js +71 -19
  20. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js.map +1 -1
  21. package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts +26 -10
  22. package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts.map +1 -1
  23. package/dist/mcp-server/tools/definitions/get-paper.tool.js +107 -40
  24. package/dist/mcp-server/tools/definitions/get-paper.tool.js.map +1 -1
  25. package/dist/mcp-server/tools/definitions/index.d.ts +30 -9
  26. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  27. package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -1
  28. package/dist/mcp-server/tools/definitions/list-reference.tool.js +27 -8
  29. package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -1
  30. package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts.map +1 -1
  31. package/dist/mcp-server/tools/definitions/search-authors.tool.js +9 -9
  32. package/dist/mcp-server/tools/definitions/search-authors.tool.js.map +1 -1
  33. package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts.map +1 -1
  34. package/dist/mcp-server/tools/definitions/search-experiments.tool.js +6 -3
  35. package/dist/mcp-server/tools/definitions/search-experiments.tool.js.map +1 -1
  36. package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts +2 -2
  37. package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts.map +1 -1
  38. package/dist/mcp-server/tools/definitions/search-hepdata.tool.js +14 -12
  39. package/dist/mcp-server/tools/definitions/search-hepdata.tool.js.map +1 -1
  40. package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts +1 -1
  41. package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts.map +1 -1
  42. package/dist/mcp-server/tools/definitions/search-literature.tool.js +22 -11
  43. package/dist/mcp-server/tools/definitions/search-literature.tool.js.map +1 -1
  44. package/dist/mcp-server/tools/inputs.d.ts +17 -5
  45. package/dist/mcp-server/tools/inputs.d.ts.map +1 -1
  46. package/dist/mcp-server/tools/inputs.js +29 -10
  47. package/dist/mcp-server/tools/inputs.js.map +1 -1
  48. package/dist/services/inspire/identifiers.d.ts +17 -6
  49. package/dist/services/inspire/identifiers.d.ts.map +1 -1
  50. package/dist/services/inspire/identifiers.js +28 -7
  51. package/dist/services/inspire/identifiers.js.map +1 -1
  52. package/dist/services/inspire/inspire-service.d.ts +78 -18
  53. package/dist/services/inspire/inspire-service.d.ts.map +1 -1
  54. package/dist/services/inspire/inspire-service.js +293 -52
  55. package/dist/services/inspire/inspire-service.js.map +1 -1
  56. package/dist/services/inspire/markup-to-text.d.ts +32 -0
  57. package/dist/services/inspire/markup-to-text.d.ts.map +1 -0
  58. package/dist/services/inspire/markup-to-text.js +783 -0
  59. package/dist/services/inspire/markup-to-text.js.map +1 -0
  60. package/dist/services/inspire/normalize.d.ts +23 -6
  61. package/dist/services/inspire/normalize.d.ts.map +1 -1
  62. package/dist/services/inspire/normalize.js +94 -21
  63. package/dist/services/inspire/normalize.js.map +1 -1
  64. package/dist/services/inspire/types.d.ts +73 -5
  65. package/dist/services/inspire/types.d.ts.map +1 -1
  66. package/dist/utils/render.d.ts +34 -5
  67. package/dist/utils/render.d.ts.map +1 -1
  68. package/dist/utils/render.js +69 -16
  69. package/dist/utils/render.js.map +1 -1
  70. package/package.json +1 -1
  71. 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, inline } from '../../../utils/render.js';
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
- size: blankAsUnset(z.number().int().min(1).max(MAX_ENTRIES).default(10)).describe('Most entries to return (1–50, default 10).'),
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 matched than size.'),
48
- shown: z.number().describe('Number of entries returned.'),
49
- cap: z.number().describe('The size cap applied.'),
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 export was capped.'),
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, retry cern_inspire_export_citations with a smaller size.',
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({ query: input.query, format: input.format, sort: input.sort, size: input.size }, inspire.beginCall(ctx));
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
- ctx.enrich.notice(`No INSPIRE literature matched "${inline(input.query)}"; find the papers with cern_inspire_search_literature, then export by recid ("recid:N or recid:M").`);
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
- else if (result.truncated) {
103
- ctx.enrich.truncated({
104
- shown,
105
- cap: input.size,
106
- guidance: `More papers matched than size; raise size (max ${MAX_ENTRIES}), narrow the query, or export by recid.`,
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
- return { format: input.format, entries: result.entries };
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 lines = [`## INSPIRE citations (${result.format}, ${result.entries.length} entries)`];
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 ? inline(e.texkey) : '(no 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":"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"}
1
+ {"version":3,"file":"export-citations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/export-citations.tool.ts"],"names":[],"mappings":"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"}
@@ -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 identifier or any
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;AAoEjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8PjC,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 identifier or any
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, subject, and year filters narrow every figure; exclude_self_citations recounts without self-citations.',
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.string().optional().describe('Guidance when no citeable paper matched.'),
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 caller's query reaches the content[] trailer; inline() keeps a newline in it from forging structure.
112
- effectiveQuery: { render: (query) => `Query: ${inline(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 "${inline(input.author)}" is not a BAI, ORCID, INSPIRE ID, or author recid.`, { author: input.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 "${inline(input.author)}" as ${route.matchedAs}.`, { author: input.author, matchedAs: route.matchedAs });
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
- const notices = [
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
- return { target, ...summary };
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:** ${inline(t.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":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,yBAAyB,GAAG,OAAO,CAAC;AAE1C,mEAAmE;AACnE,MAAM,qBAAqB,GAAG;IAC5B,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,SAAS;IACjB,oBAAoB,EAAE,wBAAwB;CACQ,CAAC;AAEzD,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;AAEvE,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE,CACrC,CAAC;KACE,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,KAAK,UAAU,CAAC;IACzD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,KAAK,UAAU,CAAC;IACnE,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sBAAsB,KAAK,2CAA2C,CAAC;CACpF,CAAC;KACD,QAAQ,CAAC,eAAe,KAAK,UAAU,CAAC,CAAC;AAE9C,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,EAAE,CACtC,CAAC;KACE,KAAK,CACJ,CAAC;KACE,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACrF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CAC/E,CAAC;KACD,QAAQ,CAAC,sBAAsB,CAAC,CACpC;KACA,QAAQ,CAAC,mCAAmC,KAAK,UAAU,CAAC,CAAC;AAKlE,uEAAuE;AACvE,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D,SAAS,YAAY,CAAC,KAAa,EAAE,CAAS;IAC5C,MAAM,GAAG,GACP,CAAC,CAAC,gBAAgB,KAAK,SAAS;QAC9B,CAAC,CAAC,2BAA2B;QAC7B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC1C,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,CAAC;AAChE,CAAC;AAED,yFAAyF;AACzF,SAAS,aAAa,CAAC,GAAY,EAAE,SAAkB;IACrD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO;QACL,6DAA6D;QAC7D,eAAe;QACf,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACtB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,MAAM,CAAC;YACrD,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,MAAM,CAAC;YAC3D,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1D,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,mCAAmC,EAAE;IAC9E,KAAK,EAAE,8BAA8B;IACrC,WAAW,EACT,iyBAAiyB;IACnyB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAClE,+WAA+W,CAChX;QACD,cAAc,EAAE,kBAAkB;QAClC,QAAQ,EAAE,aAAa;QACvB,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,WAAW;QACpB,sBAAsB,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CACvE,4JAA4J,CAC7J;KACF,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC;aACN,MAAM,CAAC;YACN,IAAI,EAAE,CAAC;iBACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;iBACzB,QAAQ,CAAC,8EAA8E,CAAC;YAC3F,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2EAA2E,CAAC;YACxF,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2DAA2D,CAAC;YACxE,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,2EAA2E,CAAC;SACzF,CAAC;aACD,QAAQ,CAAC,0BAA0B,CAAC;QACvC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QAC7F,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QACjF,MAAM,EAAE,CAAC;aACN,MAAM,CAAC;YACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;SACjE,CAAC;aACD,QAAQ,CAAC,oDAAoD,CAAC;QACjE,GAAG,EAAE,YAAY,CAAC,UAAU,CAAC;QAC7B,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC;QACpC,OAAO,EAAE,CAAC;aACP,MAAM,CAAC;YACN,GAAG,EAAE,aAAa,CAAC,UAAU,CAAC;YAC9B,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC;SACtC,CAAC;aACD,QAAQ,CAAC,uEAAuE,CAAC;QACpF,eAAe,EAAE,CAAC;aACf,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACvE,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,mEAAmE,CAAC;SACjF,CAAC;aACD,QAAQ,CAAC,iCAAiC,CAAC,CAC/C;aACA,QAAQ,EAAE;aACV,QAAQ,CACP,4mBAA4mB,CAC7mB;KACJ,CAAC;IACF,UAAU,EAAE;QACV,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAC5E,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,CACP,4GAA4G,CAC7G;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,yGAAyG,CAC1G;KACJ;IACD,iBAAiB,EAAE;QACjB,iHAAiH;QACjH,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE;QACpE,cAAc,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE;KAC7C;IACD,MAAM,EAAE;QACN;YACE,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,iDAAiD;YACvD,QAAQ,EACN,qJAAqJ;YACvJ,QAAQ,EAAE,QAAQ;SACnB;QACD;YACE,MAAM,EAAE,uBAAuB;YAC/B,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,oEAAoE;YAC1E,QAAQ,EACN,mGAAmG;YACrG,QAAQ,EAAE,QAAQ;SACnB;QACD;YACE,MAAM,EAAE,kBAAkB;YAC1B,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,mDAAmD;YACzD,QAAQ,EACN,qGAAqG;YACvG,QAAQ,EAAE,QAAQ;SACnB;QACD;YACE,MAAM,EAAE,oBAAoB;YAC5B,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,kCAAkC;YACxC,QAAQ,EACN,kHAAkH;YACpH,QAAQ,EAAE,QAAQ;SACnB;QACD;YACE,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,uDAAuD;YAC7D,QAAQ,EACN,oIAAoI;YACtI,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,gBAAgB,CAAC,WAAW;YAClC,IAAI,EAAE,mDAAmD;YACzD,QAAQ,EACN,+IAA+I;YACjJ,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,gBAAgB,CAAC,WAAW;YAClC,IAAI,EAAE,qGAAqG;YAC3G,QAAQ,EACN,6MAA6M;YAC/M,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,MAAM,EAAE,qBAAqB;YAC7B,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;YACzC,IAAI,EAAE,oGAAoG;YAC1G,QAAQ,EACN,mKAAmK;YACrK,QAAQ,EAAE,SAAS;SACpB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,OAAO,GAAiB;YAC5B,aAAa,EAAE,KAAK,CAAC,cAAc;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,SAAS;YACzB,MAAM,EAAE,KAAK,CAAC,OAAO;SACtB,CAAC;QACF,GAAG,CAAC,MAAM,CAAC;YACT,cAAc,EAAE,oBAAoB,CAAC;gBACnC,GAAG,OAAO;gBACV,oBAAoB,EAAE,KAAK,CAAC,sBAAsB;aACnD,CAAC;SACH,CAAC,CAAC;QACH,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAEnD,IACE,KAAK,CAAC,SAAS,KAAK,SAAS;YAC7B,KAAK,CAAC,OAAO,KAAK,SAAS;YAC3B,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,EAC/B,CAAC;YACD,MAAM,GAAG,CAAC,IAAI,CACZ,oBAAoB,EACpB,cAAc,KAAK,CAAC,SAAS,4BAA4B,KAAK,CAAC,OAAO,IAAI,CAC3E,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,GAAG,CAAC,IAAI,CACZ,gBAAgB,EAChB,KAAK,CAAC,MAAM;gBACV,CAAC,CAAC,qDAAqD;gBACvD,CAAC,CAAC,uDAAuD,CAC5D,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,MAKH,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;gBAC/B,MAAM,GAAG,CAAC,IAAI,CACZ,uBAAuB,EACvB,WAAW,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,qDAAqD,EACxF,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CACzB,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,GAAG,CAAC,IAAI,CACZ,kBAAkB,EAClB,sCAAsC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC,SAAS,GAAG,EACxF,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CACrD,CAAC;YACJ,CAAC;YACD,MAAM,GAAG;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ,CAAC,KAAK;gBAC3B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,KAAK,EAAE,iBAAiB,QAAQ,CAAC,KAAK,EAAE;aACzC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACvD,CAAC;QACD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE9B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAC1D,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,CAAC,sBAAsB,EAAE,GAAG,OAAO,EAAE,EACvF,IAAI,CACL,CAAC;QACF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE;YACxC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,eAAe,EAAE,MAAM,CAAC,MAAM;SAC/B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CACV,kHAAkH,CACnH,CAAC;YACF,IAAI,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAChC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAC3D,CAAC;YACF,OAAO,CAAC,IAAI,CACV,0EAA0E,OAAO,oEAAoE,OAAO,+DAA+D,CAC5N,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACzC,MAAM,IAAI,GACR,OAAO,CAAC,cAAc,IAAI,yBAAyB;gBACjD,CAAC,CAAC,+JAA+J;gBACjK,CAAC,CAAC,6DAA6D,CAAC;YACpE,OAAO,CAAC,IAAI,CACV,2DAA2D,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,OAAO,CAAC,4BAA4B,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,8BAA8B,2BAA2B,GAAG,IAAI,qBAAqB,IAAI,wDAAwD,CACnU,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CACV,wHAAwH,CACzH,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7D,OAAO;YACL,MAAM;YACN,GAAG,OAAO;YACV,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,MAAM,OAAO,GACX,CAAC,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;YACvD,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAClH,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,KAAK,GAAG;YACZ,8BAA8B,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9D,oBAAoB,CAAC,CAAC,IAAI,iBAAiB,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YAChE,wBAAwB,MAAM,CAAC,cAAc,2BAA2B,MAAM,CAAC,cAAc,EAAE;YAC/F,gBAAgB,MAAM,CAAC,MAAM,CAAC,GAAG,qBAAqB,MAAM,CAAC,MAAM,CAAC,SAAS,cAAc;YAC3F,EAAE;YACF,oDAAoD;YACpD,mBAAmB;YACnB,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC;YACxC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC;SAC5C,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,sIAAsI,EACtI,EAAE,EACF,sBAAsB,EACtB,WAAW,EACX,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,SAAS,IAAI,CAAC,CAC7E,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}
@@ -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;AAQjE,sFAAsF;AACtF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuK7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AA4JpE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgGvB,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"}