@cyanheads/cern-inspire-mcp-server 0.1.1
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 +504 -0
- package/CLAUDE.md +504 -0
- package/Dockerfile +177 -0
- package/LICENSE +201 -0
- package/README.md +311 -0
- package/changelog/0.1.x/0.1.0.md +9 -0
- package/changelog/0.1.x/0.1.1.md +22 -0
- package/changelog/template.md +151 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +23 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +106 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +7 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts +110 -0
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.js +69 -0
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.js.map +1 -0
- package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts +65 -0
- package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/export-citations.tool.js +120 -0
- package/dist/mcp-server/tools/definitions/export-citations.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts +159 -0
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js +262 -0
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts +195 -0
- package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-paper.tool.js +356 -0
- package/dist/mcp-server/tools/definitions/get-paper.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +675 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +23 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts +33 -0
- package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-reference.tool.js +312 -0
- package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts +92 -0
- package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-authors.tool.js +298 -0
- package/dist/mcp-server/tools/definitions/search-authors.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts +80 -0
- package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-experiments.tool.js +223 -0
- package/dist/mcp-server/tools/definitions/search-experiments.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.js +225 -0
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts +127 -0
- package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-literature.tool.js +331 -0
- package/dist/mcp-server/tools/definitions/search-literature.tool.js.map +1 -0
- package/dist/mcp-server/tools/inputs.d.ts +80 -0
- package/dist/mcp-server/tools/inputs.d.ts.map +1 -0
- package/dist/mcp-server/tools/inputs.js +100 -0
- package/dist/mcp-server/tools/inputs.js.map +1 -0
- package/dist/services/http/fetch-bounded.d.ts +45 -0
- package/dist/services/http/fetch-bounded.d.ts.map +1 -0
- package/dist/services/http/fetch-bounded.js +79 -0
- package/dist/services/http/fetch-bounded.js.map +1 -0
- package/dist/services/inspire/identifiers.d.ts +55 -0
- package/dist/services/inspire/identifiers.d.ts.map +1 -0
- package/dist/services/inspire/identifiers.js +98 -0
- package/dist/services/inspire/identifiers.js.map +1 -0
- package/dist/services/inspire/inspire-service.d.ts +104 -0
- package/dist/services/inspire/inspire-service.d.ts.map +1 -0
- package/dist/services/inspire/inspire-service.js +525 -0
- package/dist/services/inspire/inspire-service.js.map +1 -0
- package/dist/services/inspire/normalize.d.ts +30 -0
- package/dist/services/inspire/normalize.d.ts.map +1 -0
- package/dist/services/inspire/normalize.js +438 -0
- package/dist/services/inspire/normalize.js.map +1 -0
- package/dist/services/inspire/types.d.ts +505 -0
- package/dist/services/inspire/types.d.ts.map +1 -0
- package/dist/services/inspire/types.js +8 -0
- package/dist/services/inspire/types.js.map +1 -0
- package/dist/services/inspire/vocabulary.d.ts +22 -0
- package/dist/services/inspire/vocabulary.d.ts.map +1 -0
- package/dist/services/inspire/vocabulary.js +68 -0
- package/dist/services/inspire/vocabulary.js.map +1 -0
- package/dist/utils/render.d.ts +40 -0
- package/dist/utils/render.d.ts.map +1 -0
- package/dist/utils/render.js +112 -0
- package/dist/utils/render.js.map +1 -0
- package/package.json +112 -0
- package/server.json +100 -0
|
@@ -0,0 +1,675 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Every tool definition this server registers, collected for `createApp()`.
|
|
3
|
+
* @module mcp-server/tools/definitions
|
|
4
|
+
*/
|
|
5
|
+
export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
6
|
+
query: import("zod").ZodPreprocess<import("zod").ZodString, unknown>;
|
|
7
|
+
limit: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
|
|
8
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
9
|
+
authors: import("zod").ZodArray<import("zod").ZodObject<{
|
|
10
|
+
recid: import("zod").ZodString;
|
|
11
|
+
name: import("zod").ZodString;
|
|
12
|
+
preferredName: import("zod").ZodOptional<import("zod").ZodString>;
|
|
13
|
+
bai: import("zod").ZodOptional<import("zod").ZodString>;
|
|
14
|
+
orcid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
15
|
+
inspireId: import("zod").ZodOptional<import("zod").ZodString>;
|
|
16
|
+
otherIds: import("zod").ZodArray<import("zod").ZodObject<{
|
|
17
|
+
schema: import("zod").ZodString;
|
|
18
|
+
value: import("zod").ZodString;
|
|
19
|
+
}, import("zod/v4/core").$strip>>;
|
|
20
|
+
status: import("zod").ZodOptional<import("zod").ZodString>;
|
|
21
|
+
stub: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
22
|
+
currentPositions: import("zod").ZodArray<import("zod").ZodObject<{
|
|
23
|
+
institution: import("zod").ZodString;
|
|
24
|
+
rank: import("zod").ZodOptional<import("zod").ZodString>;
|
|
25
|
+
startDate: import("zod").ZodOptional<import("zod").ZodString>;
|
|
26
|
+
endDate: import("zod").ZodOptional<import("zod").ZodString>;
|
|
27
|
+
institutionRecid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
28
|
+
}, import("zod/v4/core").$strip>>;
|
|
29
|
+
pastPositions: import("zod").ZodArray<import("zod").ZodObject<{
|
|
30
|
+
institution: import("zod").ZodString;
|
|
31
|
+
rank: import("zod").ZodOptional<import("zod").ZodString>;
|
|
32
|
+
startDate: import("zod").ZodOptional<import("zod").ZodString>;
|
|
33
|
+
endDate: import("zod").ZodOptional<import("zod").ZodString>;
|
|
34
|
+
institutionRecid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
35
|
+
}, import("zod/v4/core").$strip>>;
|
|
36
|
+
arxivCategories: import("zod").ZodArray<import("zod").ZodString>;
|
|
37
|
+
advisors: import("zod").ZodArray<import("zod").ZodObject<{
|
|
38
|
+
name: import("zod").ZodString;
|
|
39
|
+
degreeType: import("zod").ZodOptional<import("zod").ZodString>;
|
|
40
|
+
recid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
41
|
+
}, import("zod/v4/core").$strip>>;
|
|
42
|
+
urls: import("zod").ZodArray<import("zod").ZodObject<{
|
|
43
|
+
url: import("zod").ZodString;
|
|
44
|
+
description: import("zod").ZodOptional<import("zod").ZodString>;
|
|
45
|
+
}, import("zod/v4/core").$strip>>;
|
|
46
|
+
awards: import("zod").ZodArray<import("zod").ZodObject<{
|
|
47
|
+
name: import("zod").ZodString;
|
|
48
|
+
year: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
49
|
+
}, import("zod/v4/core").$strip>>;
|
|
50
|
+
literatureQuery: import("zod").ZodString;
|
|
51
|
+
}, import("zod/v4/core").$strip>>;
|
|
52
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
53
|
+
readonly reason: "invalid_query";
|
|
54
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
55
|
+
readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
|
|
56
|
+
readonly recovery: "Check the name or identifier form against cern_inspire_list_reference topic identifiers, then retry cern_inspire_search_authors.";
|
|
57
|
+
readonly severity: "notice";
|
|
58
|
+
readonly thrownBy: "service";
|
|
59
|
+
}, {
|
|
60
|
+
readonly reason: "inspire_rate_limited";
|
|
61
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
62
|
+
readonly when: "INSPIRE returned 429 after the pacer and retries.";
|
|
63
|
+
readonly recovery: "Wait the retry-after seconds this error states (at least 5), then retry this call; INSPIRE allows 15 requests per 5 seconds from one address.";
|
|
64
|
+
readonly retryable: true;
|
|
65
|
+
readonly thrownBy: "service";
|
|
66
|
+
}, {
|
|
67
|
+
readonly reason: "pacer_shed";
|
|
68
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
69
|
+
readonly when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.";
|
|
70
|
+
readonly recovery: "This server's INSPIRE request queue is saturated; wait the seconds in this error's retryAfter field (about 5 when it is not shown), then retry this call with fewer cern_inspire calls running in parallel.";
|
|
71
|
+
readonly retryable: true;
|
|
72
|
+
readonly thrownBy: "service";
|
|
73
|
+
}, {
|
|
74
|
+
readonly reason: "upstream_unreadable";
|
|
75
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
76
|
+
readonly when: "The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.";
|
|
77
|
+
readonly recovery: "Retry this call in a few seconds; if it fails again, retry cern_inspire_search_authors with a smaller limit.";
|
|
78
|
+
readonly thrownBy: "service";
|
|
79
|
+
}], {
|
|
80
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
81
|
+
readonly truncated: import("zod").ZodBoolean;
|
|
82
|
+
readonly shown: import("zod").ZodNumber;
|
|
83
|
+
readonly cap: import("zod").ZodNumber;
|
|
84
|
+
readonly matchedAs: import("zod").ZodString;
|
|
85
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
86
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
87
|
+
query: import("zod").ZodString;
|
|
88
|
+
sort: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
89
|
+
mostcited: "mostcited";
|
|
90
|
+
mostrecent: "mostrecent";
|
|
91
|
+
relevance: "relevance";
|
|
92
|
+
}>>, unknown>;
|
|
93
|
+
document_types: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
|
|
94
|
+
"activity report": "activity report";
|
|
95
|
+
article: "article";
|
|
96
|
+
book: "book";
|
|
97
|
+
"book chapter": "book chapter";
|
|
98
|
+
"conference paper": "conference paper";
|
|
99
|
+
introductory: "introductory";
|
|
100
|
+
lectures: "lectures";
|
|
101
|
+
note: "note";
|
|
102
|
+
proceedings: "proceedings";
|
|
103
|
+
published: "published";
|
|
104
|
+
report: "report";
|
|
105
|
+
review: "review";
|
|
106
|
+
thesis: "thesis";
|
|
107
|
+
}>>>, unknown>;
|
|
108
|
+
subjects: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
|
|
109
|
+
Accelerators: "Accelerators";
|
|
110
|
+
Astrophysics: "Astrophysics";
|
|
111
|
+
Computing: "Computing";
|
|
112
|
+
"Condensed Matter": "Condensed Matter";
|
|
113
|
+
"Data Analysis and Statistics": "Data Analysis and Statistics";
|
|
114
|
+
"Experiment-HEP": "Experiment-HEP";
|
|
115
|
+
"Experiment-Nucl": "Experiment-Nucl";
|
|
116
|
+
"General Physics": "General Physics";
|
|
117
|
+
"Gravitation and Cosmology": "Gravitation and Cosmology";
|
|
118
|
+
Instrumentation: "Instrumentation";
|
|
119
|
+
Lattice: "Lattice";
|
|
120
|
+
"Math and Math Physics": "Math and Math Physics";
|
|
121
|
+
Other: "Other";
|
|
122
|
+
"Phenomenology-HEP": "Phenomenology-HEP";
|
|
123
|
+
"Quantum Physics": "Quantum Physics";
|
|
124
|
+
"Theory-HEP": "Theory-HEP";
|
|
125
|
+
"Theory-Nucl": "Theory-Nucl";
|
|
126
|
+
Unknown: "Unknown";
|
|
127
|
+
}>>>, unknown>;
|
|
128
|
+
year_from: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodNumber>, unknown>;
|
|
129
|
+
year_to: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodNumber>, unknown>;
|
|
130
|
+
page: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
|
|
131
|
+
size: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
|
|
132
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
133
|
+
papers: import("zod").ZodArray<import("zod").ZodObject<{
|
|
134
|
+
recid: import("zod").ZodString;
|
|
135
|
+
title: import("zod").ZodString;
|
|
136
|
+
firstAuthor: import("zod").ZodOptional<import("zod").ZodObject<{
|
|
137
|
+
name: import("zod").ZodString;
|
|
138
|
+
recid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
139
|
+
}, import("zod/v4/core").$strip>>;
|
|
140
|
+
authorCount: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
141
|
+
collaborations: import("zod").ZodArray<import("zod").ZodString>;
|
|
142
|
+
date: import("zod").ZodOptional<import("zod").ZodString>;
|
|
143
|
+
documentTypes: import("zod").ZodArray<import("zod").ZodString>;
|
|
144
|
+
citationCount: import("zod").ZodNumber;
|
|
145
|
+
citationCountWithoutSelf: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
146
|
+
arxivId: import("zod").ZodOptional<import("zod").ZodString>;
|
|
147
|
+
arxivCategories: import("zod").ZodArray<import("zod").ZodString>;
|
|
148
|
+
doi: import("zod").ZodOptional<import("zod").ZodString>;
|
|
149
|
+
publication: import("zod").ZodOptional<import("zod").ZodString>;
|
|
150
|
+
abstractSnippet: import("zod").ZodOptional<import("zod").ZodString>;
|
|
151
|
+
abstractTruncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
152
|
+
}, import("zod/v4/core").$strip>>;
|
|
153
|
+
page: import("zod").ZodNumber;
|
|
154
|
+
size: import("zod").ZodNumber;
|
|
155
|
+
hasMore: import("zod").ZodBoolean;
|
|
156
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
157
|
+
readonly reason: "beyond_result_window";
|
|
158
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
159
|
+
readonly when: "page × size exceeds the 10,000 results INSPIRE serves for one query.";
|
|
160
|
+
readonly recovery: "Narrow the query with year_from/year_to, document_types, or tighter terms until it matches under 10,000 records, then page again with cern_inspire_search_literature.";
|
|
161
|
+
readonly severity: "notice";
|
|
162
|
+
}, {
|
|
163
|
+
readonly reason: "invalid_year_range";
|
|
164
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
165
|
+
readonly when: "year_from is later than year_to.";
|
|
166
|
+
readonly recovery: "Swap year_from and year_to so the range runs forward, or drop one bound for an open range, then retry this call.";
|
|
167
|
+
readonly severity: "notice";
|
|
168
|
+
}, {
|
|
169
|
+
readonly reason: "invalid_query";
|
|
170
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
171
|
+
readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
|
|
172
|
+
readonly recovery: "Check the query and filters against cern_inspire_list_reference topic search_syntax, then retry cern_inspire_search_literature with corrected values.";
|
|
173
|
+
readonly severity: "notice";
|
|
174
|
+
readonly thrownBy: "service";
|
|
175
|
+
}, {
|
|
176
|
+
readonly reason: "inspire_rate_limited";
|
|
177
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
178
|
+
readonly when: "INSPIRE returned 429 after the pacer and retries.";
|
|
179
|
+
readonly recovery: "Wait the retry-after seconds this error states (at least 5), then retry this call; INSPIRE allows 15 requests per 5 seconds from one address.";
|
|
180
|
+
readonly retryable: true;
|
|
181
|
+
readonly thrownBy: "service";
|
|
182
|
+
}, {
|
|
183
|
+
readonly reason: "pacer_shed";
|
|
184
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
185
|
+
readonly when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.";
|
|
186
|
+
readonly recovery: "This server's INSPIRE request queue is saturated; wait the seconds in this error's retryAfter field (about 5 when it is not shown), then retry this call with fewer cern_inspire calls running in parallel.";
|
|
187
|
+
readonly retryable: true;
|
|
188
|
+
readonly thrownBy: "service";
|
|
189
|
+
}, {
|
|
190
|
+
readonly reason: "upstream_unreadable";
|
|
191
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
192
|
+
readonly when: "The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.";
|
|
193
|
+
readonly recovery: "Retry this call in a few seconds; if it fails again, retry cern_inspire_search_literature with a smaller size.";
|
|
194
|
+
readonly thrownBy: "service";
|
|
195
|
+
}], {
|
|
196
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
197
|
+
readonly truncated: import("zod").ZodBoolean;
|
|
198
|
+
readonly shown: import("zod").ZodNumber;
|
|
199
|
+
readonly cap: import("zod").ZodNumber;
|
|
200
|
+
readonly nextPage: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
201
|
+
readonly appliedFilters: import("zod").ZodString;
|
|
202
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
203
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
204
|
+
paper: import("zod").ZodPreprocess<import("zod").ZodString, unknown>;
|
|
205
|
+
max_authors: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
|
|
206
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
207
|
+
recid: import("zod").ZodString;
|
|
208
|
+
resolvedAs: import("zod").ZodEnum<{
|
|
209
|
+
arxiv: "arxiv";
|
|
210
|
+
doi: "doi";
|
|
211
|
+
recid: "recid";
|
|
212
|
+
}>;
|
|
213
|
+
title: import("zod").ZodString;
|
|
214
|
+
alternateTitles: import("zod").ZodArray<import("zod").ZodString>;
|
|
215
|
+
abstract: import("zod").ZodOptional<import("zod").ZodString>;
|
|
216
|
+
abstractSource: import("zod").ZodOptional<import("zod").ZodString>;
|
|
217
|
+
authorCount: import("zod").ZodNumber;
|
|
218
|
+
authors: import("zod").ZodArray<import("zod").ZodObject<{
|
|
219
|
+
name: import("zod").ZodString;
|
|
220
|
+
recid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
221
|
+
bai: import("zod").ZodOptional<import("zod").ZodString>;
|
|
222
|
+
orcid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
223
|
+
affiliations: import("zod").ZodArray<import("zod").ZodString>;
|
|
224
|
+
}, import("zod/v4/core").$strip>>;
|
|
225
|
+
collaborations: import("zod").ZodArray<import("zod").ZodString>;
|
|
226
|
+
experiments: import("zod").ZodArray<import("zod").ZodObject<{
|
|
227
|
+
name: import("zod").ZodString;
|
|
228
|
+
recid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
229
|
+
}, import("zod/v4/core").$strip>>;
|
|
230
|
+
date: import("zod").ZodOptional<import("zod").ZodString>;
|
|
231
|
+
preprintDate: import("zod").ZodOptional<import("zod").ZodString>;
|
|
232
|
+
publicationDate: import("zod").ZodOptional<import("zod").ZodString>;
|
|
233
|
+
publications: import("zod").ZodArray<import("zod").ZodObject<{
|
|
234
|
+
journal: import("zod").ZodOptional<import("zod").ZodString>;
|
|
235
|
+
volume: import("zod").ZodOptional<import("zod").ZodString>;
|
|
236
|
+
year: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
237
|
+
pages: import("zod").ZodOptional<import("zod").ZodString>;
|
|
238
|
+
articleId: import("zod").ZodOptional<import("zod").ZodString>;
|
|
239
|
+
freetext: import("zod").ZodOptional<import("zod").ZodString>;
|
|
240
|
+
}, import("zod/v4/core").$strip>>;
|
|
241
|
+
arxivId: import("zod").ZodOptional<import("zod").ZodString>;
|
|
242
|
+
arxivCategories: import("zod").ZodArray<import("zod").ZodString>;
|
|
243
|
+
dois: import("zod").ZodArray<import("zod").ZodString>;
|
|
244
|
+
reportNumbers: import("zod").ZodArray<import("zod").ZodString>;
|
|
245
|
+
keywords: import("zod").ZodArray<import("zod").ZodString>;
|
|
246
|
+
subjects: import("zod").ZodArray<import("zod").ZodString>;
|
|
247
|
+
documentTypes: import("zod").ZodArray<import("zod").ZodString>;
|
|
248
|
+
refereed: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
249
|
+
citeable: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
250
|
+
core: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
251
|
+
numberOfPages: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
252
|
+
citationCount: import("zod").ZodNumber;
|
|
253
|
+
citationCountWithoutSelf: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
254
|
+
texkeys: import("zod").ZodArray<import("zod").ZodString>;
|
|
255
|
+
urls: import("zod").ZodArray<import("zod").ZodObject<{
|
|
256
|
+
url: import("zod").ZodString;
|
|
257
|
+
description: import("zod").ZodOptional<import("zod").ZodString>;
|
|
258
|
+
}, import("zod/v4/core").$strip>>;
|
|
259
|
+
licenses: import("zod").ZodArray<import("zod").ZodObject<{
|
|
260
|
+
url: import("zod").ZodString;
|
|
261
|
+
material: import("zod").ZodOptional<import("zod").ZodString>;
|
|
262
|
+
imposing: import("zod").ZodOptional<import("zod").ZodString>;
|
|
263
|
+
}, import("zod/v4/core").$strip>>;
|
|
264
|
+
inspireUrl: import("zod").ZodString;
|
|
265
|
+
citingQuery: import("zod").ZodString;
|
|
266
|
+
referencesQuery: import("zod").ZodString;
|
|
267
|
+
hepdata: import("zod").ZodObject<{
|
|
268
|
+
status: import("zod").ZodEnum<{
|
|
269
|
+
available: "available";
|
|
270
|
+
lookup_failed: "lookup_failed";
|
|
271
|
+
none: "none";
|
|
272
|
+
}>;
|
|
273
|
+
inspireDataRecid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
274
|
+
recordDoi: import("zod").ZodOptional<import("zod").ZodString>;
|
|
275
|
+
latestVersion: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
276
|
+
tableCount: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
277
|
+
hepdataUrl: import("zod").ZodOptional<import("zod").ZodString>;
|
|
278
|
+
}, import("zod/v4/core").$strip>;
|
|
279
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
280
|
+
readonly reason: "paper_not_found";
|
|
281
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
282
|
+
readonly when: "The recid, arXiv ID, or DOI matches no INSPIRE literature record.";
|
|
283
|
+
readonly recovery: "Find the record with cern_inspire_search_literature using title words, an author, or the arXiv number, then call cern_inspire_get_paper with its recid.";
|
|
284
|
+
readonly severity: "notice";
|
|
285
|
+
}, {
|
|
286
|
+
readonly reason: "inspire_rate_limited";
|
|
287
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
288
|
+
readonly when: "INSPIRE returned 429 after the pacer and retries.";
|
|
289
|
+
readonly recovery: "Wait the retry-after seconds this error states (at least 5), then retry this call; INSPIRE allows 15 requests per 5 seconds from one address.";
|
|
290
|
+
readonly retryable: true;
|
|
291
|
+
readonly thrownBy: "service";
|
|
292
|
+
}, {
|
|
293
|
+
readonly reason: "pacer_shed";
|
|
294
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
295
|
+
readonly when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.";
|
|
296
|
+
readonly recovery: "This server's INSPIRE request queue is saturated; wait the seconds in this error's retryAfter field (about 5 when it is not shown), then retry this call with fewer cern_inspire calls running in parallel.";
|
|
297
|
+
readonly retryable: true;
|
|
298
|
+
readonly thrownBy: "service";
|
|
299
|
+
}, {
|
|
300
|
+
readonly reason: "upstream_unreadable";
|
|
301
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
302
|
+
readonly when: "The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.";
|
|
303
|
+
readonly recovery: "Retry this call in a few seconds; if it fails again, read the paper's summary record with cern_inspire_search_literature (query \"recid:N\", \"arxiv:ID\", or \"doi:DOI\").";
|
|
304
|
+
readonly thrownBy: "service";
|
|
305
|
+
}], {
|
|
306
|
+
readonly truncated: import("zod").ZodBoolean;
|
|
307
|
+
readonly shown: import("zod").ZodNumber;
|
|
308
|
+
readonly cap: import("zod").ZodNumber;
|
|
309
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
310
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
311
|
+
query: import("zod").ZodString;
|
|
312
|
+
format: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
313
|
+
bibtex: "bibtex";
|
|
314
|
+
"latex-eu": "latex-eu";
|
|
315
|
+
"latex-us": "latex-us";
|
|
316
|
+
}>>, unknown>;
|
|
317
|
+
sort: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
318
|
+
mostcited: "mostcited";
|
|
319
|
+
mostrecent: "mostrecent";
|
|
320
|
+
relevance: "relevance";
|
|
321
|
+
}>>, unknown>;
|
|
322
|
+
size: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
|
|
323
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
324
|
+
format: import("zod").ZodEnum<{
|
|
325
|
+
bibtex: "bibtex";
|
|
326
|
+
"latex-eu": "latex-eu";
|
|
327
|
+
"latex-us": "latex-us";
|
|
328
|
+
}>;
|
|
329
|
+
entries: import("zod").ZodArray<import("zod").ZodObject<{
|
|
330
|
+
texkey: import("zod").ZodString;
|
|
331
|
+
text: import("zod").ZodString;
|
|
332
|
+
}, import("zod/v4/core").$strip>>;
|
|
333
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
334
|
+
readonly reason: "invalid_query";
|
|
335
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
336
|
+
readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
|
|
337
|
+
readonly recovery: "Check the query against cern_inspire_list_reference topic search_syntax, then retry cern_inspire_export_citations with the corrected query.";
|
|
338
|
+
readonly severity: "notice";
|
|
339
|
+
readonly thrownBy: "service";
|
|
340
|
+
}, {
|
|
341
|
+
readonly reason: "inspire_rate_limited";
|
|
342
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
343
|
+
readonly when: "INSPIRE returned 429 after the pacer and retries.";
|
|
344
|
+
readonly recovery: "Wait the retry-after seconds this error states (at least 5), then retry this call; INSPIRE allows 15 requests per 5 seconds from one address.";
|
|
345
|
+
readonly retryable: true;
|
|
346
|
+
readonly thrownBy: "service";
|
|
347
|
+
}, {
|
|
348
|
+
readonly reason: "pacer_shed";
|
|
349
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
350
|
+
readonly when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.";
|
|
351
|
+
readonly recovery: "This server's INSPIRE request queue is saturated; wait the seconds in this error's retryAfter field (about 5 when it is not shown), then retry this call with fewer cern_inspire calls running in parallel.";
|
|
352
|
+
readonly retryable: true;
|
|
353
|
+
readonly thrownBy: "service";
|
|
354
|
+
}, {
|
|
355
|
+
readonly reason: "upstream_unreadable";
|
|
356
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
357
|
+
readonly when: "The INSPIRE body exceeded the byte ceiling, or was JSON or HTML where citation text was expected.";
|
|
358
|
+
readonly recovery: "Retry this call in a few seconds; if it fails again, retry cern_inspire_export_citations with a smaller size.";
|
|
359
|
+
readonly thrownBy: "service";
|
|
360
|
+
}], {
|
|
361
|
+
readonly truncated: import("zod").ZodBoolean;
|
|
362
|
+
readonly shown: import("zod").ZodNumber;
|
|
363
|
+
readonly cap: import("zod").ZodNumber;
|
|
364
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
365
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
366
|
+
author: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
|
|
367
|
+
query: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
|
|
368
|
+
document_types: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
|
|
369
|
+
"activity report": "activity report";
|
|
370
|
+
article: "article";
|
|
371
|
+
book: "book";
|
|
372
|
+
"book chapter": "book chapter";
|
|
373
|
+
"conference paper": "conference paper";
|
|
374
|
+
introductory: "introductory";
|
|
375
|
+
lectures: "lectures";
|
|
376
|
+
note: "note";
|
|
377
|
+
proceedings: "proceedings";
|
|
378
|
+
published: "published";
|
|
379
|
+
report: "report";
|
|
380
|
+
review: "review";
|
|
381
|
+
thesis: "thesis";
|
|
382
|
+
}>>>, unknown>;
|
|
383
|
+
subjects: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
|
|
384
|
+
Accelerators: "Accelerators";
|
|
385
|
+
Astrophysics: "Astrophysics";
|
|
386
|
+
Computing: "Computing";
|
|
387
|
+
"Condensed Matter": "Condensed Matter";
|
|
388
|
+
"Data Analysis and Statistics": "Data Analysis and Statistics";
|
|
389
|
+
"Experiment-HEP": "Experiment-HEP";
|
|
390
|
+
"Experiment-Nucl": "Experiment-Nucl";
|
|
391
|
+
"General Physics": "General Physics";
|
|
392
|
+
"Gravitation and Cosmology": "Gravitation and Cosmology";
|
|
393
|
+
Instrumentation: "Instrumentation";
|
|
394
|
+
Lattice: "Lattice";
|
|
395
|
+
"Math and Math Physics": "Math and Math Physics";
|
|
396
|
+
Other: "Other";
|
|
397
|
+
"Phenomenology-HEP": "Phenomenology-HEP";
|
|
398
|
+
"Quantum Physics": "Quantum Physics";
|
|
399
|
+
"Theory-HEP": "Theory-HEP";
|
|
400
|
+
"Theory-Nucl": "Theory-Nucl";
|
|
401
|
+
Unknown: "Unknown";
|
|
402
|
+
}>>>, unknown>;
|
|
403
|
+
year_from: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodNumber>, unknown>;
|
|
404
|
+
year_to: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodNumber>, unknown>;
|
|
405
|
+
exclude_self_citations: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodBoolean>, unknown>;
|
|
406
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
407
|
+
target: import("zod").ZodObject<{
|
|
408
|
+
kind: import("zod").ZodEnum<{
|
|
409
|
+
author: "author";
|
|
410
|
+
query: "query";
|
|
411
|
+
}>;
|
|
412
|
+
authorRecid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
413
|
+
authorName: import("zod").ZodOptional<import("zod").ZodString>;
|
|
414
|
+
query: import("zod").ZodString;
|
|
415
|
+
}, import("zod/v4/core").$strip>;
|
|
416
|
+
matchedRecords: import("zod").ZodNumber;
|
|
417
|
+
citeablePapers: import("zod").ZodNumber;
|
|
418
|
+
hIndex: import("zod").ZodObject<{
|
|
419
|
+
all: import("zod").ZodNumber;
|
|
420
|
+
published: import("zod").ZodNumber;
|
|
421
|
+
}, import("zod/v4/core").$strip>;
|
|
422
|
+
all: import("zod").ZodObject<{
|
|
423
|
+
papers: import("zod").ZodNumber;
|
|
424
|
+
citations: import("zod").ZodNumber;
|
|
425
|
+
averageCitations: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
426
|
+
}, import("zod/v4/core").$strip>;
|
|
427
|
+
published: import("zod").ZodObject<{
|
|
428
|
+
papers: import("zod").ZodNumber;
|
|
429
|
+
citations: import("zod").ZodNumber;
|
|
430
|
+
averageCitations: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
431
|
+
}, import("zod/v4/core").$strip>;
|
|
432
|
+
buckets: import("zod").ZodObject<{
|
|
433
|
+
all: import("zod").ZodArray<import("zod").ZodObject<{
|
|
434
|
+
range: import("zod").ZodEnum<{
|
|
435
|
+
0: "0";
|
|
436
|
+
"100\u2013249": "100–249";
|
|
437
|
+
"10\u201349": "10–49";
|
|
438
|
+
"1\u20139": "1–9";
|
|
439
|
+
"250\u2013499": "250–499";
|
|
440
|
+
"500+": "500+";
|
|
441
|
+
"50\u201399": "50–99";
|
|
442
|
+
}>;
|
|
443
|
+
papers: import("zod").ZodNumber;
|
|
444
|
+
}, import("zod/v4/core").$strip>>;
|
|
445
|
+
published: import("zod").ZodArray<import("zod").ZodObject<{
|
|
446
|
+
range: import("zod").ZodEnum<{
|
|
447
|
+
0: "0";
|
|
448
|
+
"100\u2013249": "100–249";
|
|
449
|
+
"10\u201349": "10–49";
|
|
450
|
+
"1\u20139": "1–9";
|
|
451
|
+
"250\u2013499": "250–499";
|
|
452
|
+
"500+": "500+";
|
|
453
|
+
"50\u201399": "50–99";
|
|
454
|
+
}>;
|
|
455
|
+
papers: import("zod").ZodNumber;
|
|
456
|
+
}, import("zod/v4/core").$strip>>;
|
|
457
|
+
}, import("zod/v4/core").$strip>;
|
|
458
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
459
|
+
readonly reason: "missing_target";
|
|
460
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
461
|
+
readonly when: "Neither or both of author and query were given.";
|
|
462
|
+
readonly recovery: "Pass exactly one of author (a BAI, ORCID, INSPIRE ID, or author recid) or query (an INSPIRE literature query) to cern_inspire_get_citation_summary.";
|
|
463
|
+
readonly severity: "notice";
|
|
464
|
+
}, {
|
|
465
|
+
readonly reason: "author_not_identifier";
|
|
466
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
467
|
+
readonly when: "author is not a BAI, ORCID, INSPIRE ID, or recid — usually a name.";
|
|
468
|
+
readonly recovery: "Resolve the name with cern_inspire_search_authors, then pass the returned bai or recid as author.";
|
|
469
|
+
readonly severity: "notice";
|
|
470
|
+
}, {
|
|
471
|
+
readonly reason: "author_not_found";
|
|
472
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
473
|
+
readonly when: "The author identifier matches no INSPIRE profile.";
|
|
474
|
+
readonly recovery: "Resolve the person with cern_inspire_search_authors, then pass the returned bai or recid as author.";
|
|
475
|
+
readonly severity: "notice";
|
|
476
|
+
}, {
|
|
477
|
+
readonly reason: "invalid_year_range";
|
|
478
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
479
|
+
readonly when: "year_from is later than year_to.";
|
|
480
|
+
readonly recovery: "Swap year_from and year_to so the range runs forward, or drop one bound for an open range, then retry this call.";
|
|
481
|
+
readonly severity: "notice";
|
|
482
|
+
}, {
|
|
483
|
+
readonly reason: "invalid_query";
|
|
484
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
485
|
+
readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
|
|
486
|
+
readonly recovery: "Check the query and filters against cern_inspire_list_reference topic search_syntax, then retry cern_inspire_get_citation_summary.";
|
|
487
|
+
readonly severity: "notice";
|
|
488
|
+
readonly thrownBy: "service";
|
|
489
|
+
}, {
|
|
490
|
+
readonly reason: "inspire_rate_limited";
|
|
491
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
492
|
+
readonly when: "INSPIRE returned 429 after the pacer and retries.";
|
|
493
|
+
readonly recovery: "Wait the retry-after seconds this error states (at least 5), then retry this call; INSPIRE allows 15 requests per 5 seconds from one address.";
|
|
494
|
+
readonly retryable: true;
|
|
495
|
+
readonly thrownBy: "service";
|
|
496
|
+
}, {
|
|
497
|
+
readonly reason: "pacer_shed";
|
|
498
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
499
|
+
readonly when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.";
|
|
500
|
+
readonly recovery: "This server's INSPIRE request queue is saturated; wait the seconds in this error's retryAfter field (about 5 when it is not shown), then retry this call with fewer cern_inspire calls running in parallel.";
|
|
501
|
+
readonly retryable: true;
|
|
502
|
+
readonly thrownBy: "service";
|
|
503
|
+
}, {
|
|
504
|
+
readonly reason: "upstream_unreadable";
|
|
505
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
506
|
+
readonly when: "The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.";
|
|
507
|
+
readonly 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_get_citation_summary.";
|
|
508
|
+
readonly thrownBy: "service";
|
|
509
|
+
}], {
|
|
510
|
+
readonly effectiveQuery: import("zod").ZodString;
|
|
511
|
+
readonly appliedFilters: import("zod").ZodString;
|
|
512
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
513
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
514
|
+
query: import("zod").ZodString;
|
|
515
|
+
limit: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
|
|
516
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
517
|
+
experiments: import("zod").ZodArray<import("zod").ZodObject<{
|
|
518
|
+
recid: import("zod").ZodString;
|
|
519
|
+
legacyName: import("zod").ZodString;
|
|
520
|
+
name: import("zod").ZodOptional<import("zod").ZodString>;
|
|
521
|
+
shortName: import("zod").ZodOptional<import("zod").ZodString>;
|
|
522
|
+
longName: import("zod").ZodOptional<import("zod").ZodString>;
|
|
523
|
+
accelerator: import("zod").ZodOptional<import("zod").ZodString>;
|
|
524
|
+
institutions: import("zod").ZodArray<import("zod").ZodObject<{
|
|
525
|
+
name: import("zod").ZodString;
|
|
526
|
+
recid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
527
|
+
}, import("zod/v4/core").$strip>>;
|
|
528
|
+
collaboration: import("zod").ZodOptional<import("zod").ZodObject<{
|
|
529
|
+
name: import("zod").ZodString;
|
|
530
|
+
subgroups: import("zod").ZodArray<import("zod").ZodString>;
|
|
531
|
+
}, import("zod/v4/core").$strip>>;
|
|
532
|
+
classification: import("zod").ZodArray<import("zod").ZodString>;
|
|
533
|
+
projectTypes: import("zod").ZodArray<import("zod").ZodString>;
|
|
534
|
+
dateProposed: import("zod").ZodOptional<import("zod").ZodString>;
|
|
535
|
+
dateApproved: import("zod").ZodOptional<import("zod").ZodString>;
|
|
536
|
+
dateStarted: import("zod").ZodOptional<import("zod").ZodString>;
|
|
537
|
+
dateCompleted: import("zod").ZodOptional<import("zod").ZodString>;
|
|
538
|
+
ongoing: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
539
|
+
numberOfPapers: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
540
|
+
description: import("zod").ZodOptional<import("zod").ZodString>;
|
|
541
|
+
urls: import("zod").ZodArray<import("zod").ZodObject<{
|
|
542
|
+
url: import("zod").ZodString;
|
|
543
|
+
description: import("zod").ZodOptional<import("zod").ZodString>;
|
|
544
|
+
}, import("zod/v4/core").$strip>>;
|
|
545
|
+
nameVariants: import("zod").ZodArray<import("zod").ZodString>;
|
|
546
|
+
core: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
547
|
+
literatureQuery: import("zod").ZodOptional<import("zod").ZodString>;
|
|
548
|
+
}, import("zod/v4/core").$strip>>;
|
|
549
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
550
|
+
readonly reason: "invalid_query";
|
|
551
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
552
|
+
readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
|
|
553
|
+
readonly recovery: "Retry cern_inspire_search_experiments with a plain experiment, collaboration, or accelerator name.";
|
|
554
|
+
readonly severity: "notice";
|
|
555
|
+
readonly thrownBy: "service";
|
|
556
|
+
}, {
|
|
557
|
+
readonly reason: "inspire_rate_limited";
|
|
558
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
559
|
+
readonly when: "INSPIRE returned 429 after the pacer and retries.";
|
|
560
|
+
readonly recovery: "Wait the retry-after seconds this error states (at least 5), then retry this call; INSPIRE allows 15 requests per 5 seconds from one address.";
|
|
561
|
+
readonly retryable: true;
|
|
562
|
+
readonly thrownBy: "service";
|
|
563
|
+
}, {
|
|
564
|
+
readonly reason: "pacer_shed";
|
|
565
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
566
|
+
readonly when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.";
|
|
567
|
+
readonly recovery: "This server's INSPIRE request queue is saturated; wait the seconds in this error's retryAfter field (about 5 when it is not shown), then retry this call with fewer cern_inspire calls running in parallel.";
|
|
568
|
+
readonly retryable: true;
|
|
569
|
+
readonly thrownBy: "service";
|
|
570
|
+
}, {
|
|
571
|
+
readonly reason: "upstream_unreadable";
|
|
572
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
573
|
+
readonly when: "The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.";
|
|
574
|
+
readonly recovery: "Retry this call in a few seconds; if it fails again, retry cern_inspire_search_experiments with a smaller limit.";
|
|
575
|
+
readonly thrownBy: "service";
|
|
576
|
+
}], {
|
|
577
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
578
|
+
readonly truncated: import("zod").ZodBoolean;
|
|
579
|
+
readonly shown: import("zod").ZodNumber;
|
|
580
|
+
readonly cap: import("zod").ZodNumber;
|
|
581
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
582
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
583
|
+
query: import("zod").ZodString;
|
|
584
|
+
sort: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
585
|
+
mostrecent: "mostrecent";
|
|
586
|
+
relevance: "relevance";
|
|
587
|
+
}>>, unknown>;
|
|
588
|
+
page: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
|
|
589
|
+
size: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
|
|
590
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
591
|
+
records: import("zod").ZodArray<import("zod").ZodObject<{
|
|
592
|
+
inspireDataRecid: import("zod").ZodString;
|
|
593
|
+
title: import("zod").ZodString;
|
|
594
|
+
paperRecids: import("zod").ZodArray<import("zod").ZodString>;
|
|
595
|
+
collaborations: import("zod").ZodArray<import("zod").ZodString>;
|
|
596
|
+
experiments: import("zod").ZodArray<import("zod").ZodString>;
|
|
597
|
+
keywords: import("zod").ZodArray<import("zod").ZodString>;
|
|
598
|
+
abstractSnippet: import("zod").ZodOptional<import("zod").ZodString>;
|
|
599
|
+
abstractTruncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
600
|
+
recordDoi: import("zod").ZodOptional<import("zod").ZodString>;
|
|
601
|
+
hepdataRecid: import("zod").ZodOptional<import("zod").ZodString>;
|
|
602
|
+
latestVersion: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
603
|
+
tableCount: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
604
|
+
hepdataUrl: import("zod").ZodOptional<import("zod").ZodString>;
|
|
605
|
+
created: import("zod").ZodOptional<import("zod").ZodString>;
|
|
606
|
+
citationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
607
|
+
}, import("zod/v4/core").$strip>>;
|
|
608
|
+
page: import("zod").ZodNumber;
|
|
609
|
+
size: import("zod").ZodNumber;
|
|
610
|
+
hasMore: import("zod").ZodBoolean;
|
|
611
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
612
|
+
readonly reason: "beyond_result_window";
|
|
613
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
614
|
+
readonly when: "page × size exceeds the 10,000 results INSPIRE serves for one query.";
|
|
615
|
+
readonly recovery: "Narrow the query with tighter terms, a collaborations.value:<name> clause, or an energy until it matches under 10,000 records, then page again with cern_inspire_search_hepdata.";
|
|
616
|
+
readonly severity: "notice";
|
|
617
|
+
}, {
|
|
618
|
+
readonly reason: "invalid_query";
|
|
619
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
620
|
+
readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
|
|
621
|
+
readonly recovery: "Check the query against cern_inspire_list_reference topic search_syntax, then retry cern_inspire_search_hepdata with corrected values.";
|
|
622
|
+
readonly severity: "notice";
|
|
623
|
+
readonly thrownBy: "service";
|
|
624
|
+
}, {
|
|
625
|
+
readonly reason: "inspire_rate_limited";
|
|
626
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
627
|
+
readonly when: "INSPIRE returned 429 after the pacer and retries.";
|
|
628
|
+
readonly recovery: "Wait the retry-after seconds this error states (at least 5), then retry this call; INSPIRE allows 15 requests per 5 seconds from one address.";
|
|
629
|
+
readonly retryable: true;
|
|
630
|
+
readonly thrownBy: "service";
|
|
631
|
+
}, {
|
|
632
|
+
readonly reason: "pacer_shed";
|
|
633
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
634
|
+
readonly when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.";
|
|
635
|
+
readonly recovery: "This server's INSPIRE request queue is saturated; wait the seconds in this error's retryAfter field (about 5 when it is not shown), then retry this call with fewer cern_inspire calls running in parallel.";
|
|
636
|
+
readonly retryable: true;
|
|
637
|
+
readonly thrownBy: "service";
|
|
638
|
+
}, {
|
|
639
|
+
readonly reason: "upstream_unreadable";
|
|
640
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
641
|
+
readonly when: "The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.";
|
|
642
|
+
readonly recovery: "Retry this call in a few seconds; if it fails again, retry cern_inspire_search_hepdata with a smaller size.";
|
|
643
|
+
readonly thrownBy: "service";
|
|
644
|
+
}], {
|
|
645
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
646
|
+
readonly truncated: import("zod").ZodBoolean;
|
|
647
|
+
readonly shown: import("zod").ZodNumber;
|
|
648
|
+
readonly cap: import("zod").ZodNumber;
|
|
649
|
+
readonly nextPage: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
650
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
651
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
652
|
+
topic: import("zod").ZodEnum<{
|
|
653
|
+
citation_buckets: "citation_buckets";
|
|
654
|
+
document_types: "document_types";
|
|
655
|
+
hepdata: "hepdata";
|
|
656
|
+
identifiers: "identifiers";
|
|
657
|
+
search_syntax: "search_syntax";
|
|
658
|
+
subjects: "subjects";
|
|
659
|
+
}>;
|
|
660
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
661
|
+
topic: import("zod").ZodEnum<{
|
|
662
|
+
citation_buckets: "citation_buckets";
|
|
663
|
+
document_types: "document_types";
|
|
664
|
+
hepdata: "hepdata";
|
|
665
|
+
identifiers: "identifiers";
|
|
666
|
+
search_syntax: "search_syntax";
|
|
667
|
+
subjects: "subjects";
|
|
668
|
+
}>;
|
|
669
|
+
entries: import("zod").ZodArray<import("zod").ZodObject<{
|
|
670
|
+
term: import("zod").ZodString;
|
|
671
|
+
meaning: import("zod").ZodString;
|
|
672
|
+
example: import("zod").ZodOptional<import("zod").ZodString>;
|
|
673
|
+
}, import("zod/v4/core").$strip>>;
|
|
674
|
+
}, import("zod/v4/core").$strip>, undefined, undefined>)[];
|
|
675
|
+
//# sourceMappingURL=index.d.ts.map
|