@cyanheads/cern-inspire-mcp-server 0.1.3 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +35 -20
- package/CLAUDE.md +35 -20
- package/Dockerfile +5 -3
- package/README.md +69 -120
- package/changelog/0.2.x/0.2.0.md +35 -0
- package/changelog/0.3.x/0.3.0.md +31 -0
- package/changelog/template.md +10 -3
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/index.d.ts +28 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts +28 -0
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.js +1 -1
- package/dist/mcp-server/resources/definitions/inspire-literature.resource.js.map +1 -1
- package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/export-citations.tool.js +22 -31
- package/dist/mcp-server/tools/definitions/export-citations.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js +11 -13
- package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts +61 -3
- package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-paper.tool.js +136 -40
- package/dist/mcp-server/tools/definitions/get-paper.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +258 -142
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/index.js +2 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-reference.tool.js +20 -10
- package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts +17 -5
- package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-authors.tool.js +69 -25
- package/dist/mcp-server/tools/definitions/search-authors.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts +16 -5
- package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-experiments.tool.js +72 -28
- package/dist/mcp-server/tools/definitions/search-experiments.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts +3 -3
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.js +19 -15
- package/dist/mcp-server/tools/definitions/search-hepdata.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-institutions.tool.d.ts +77 -0
- package/dist/mcp-server/tools/definitions/search-institutions.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-institutions.tool.js +228 -0
- package/dist/mcp-server/tools/definitions/search-institutions.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-literature.tool.js +21 -20
- package/dist/mcp-server/tools/definitions/search-literature.tool.js.map +1 -1
- package/dist/mcp-server/tools/inputs.d.ts +34 -4
- package/dist/mcp-server/tools/inputs.d.ts.map +1 -1
- package/dist/mcp-server/tools/inputs.js +202 -7
- package/dist/mcp-server/tools/inputs.js.map +1 -1
- package/dist/services/http/fetch-bounded.d.ts +1 -1
- package/dist/services/http/fetch-bounded.js +1 -1
- package/dist/services/inspire/identifiers.d.ts +20 -6
- package/dist/services/inspire/identifiers.d.ts.map +1 -1
- package/dist/services/inspire/identifiers.js +30 -9
- package/dist/services/inspire/identifiers.js.map +1 -1
- package/dist/services/inspire/inspire-service.d.ts +27 -10
- package/dist/services/inspire/inspire-service.d.ts.map +1 -1
- package/dist/services/inspire/inspire-service.js +115 -47
- package/dist/services/inspire/inspire-service.js.map +1 -1
- package/dist/services/inspire/normalize.d.ts +10 -2
- package/dist/services/inspire/normalize.d.ts.map +1 -1
- package/dist/services/inspire/normalize.js +84 -1
- package/dist/services/inspire/normalize.js.map +1 -1
- package/dist/services/inspire/types.d.ts +135 -4
- package/dist/services/inspire/types.d.ts.map +1 -1
- package/dist/utils/render.d.ts +6 -4
- package/dist/utils/render.d.ts.map +1 -1
- package/dist/utils/render.js +8 -4
- package/dist/utils/render.js.map +1 -1
- package/package.json +11 -10
- package/server.json +3 -3
- package/skills/cern-inspire-guide/SKILL.md +43 -0
|
@@ -1,13 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @fileoverview cern_inspire_search_experiments — INSPIRE-HEP
|
|
3
|
-
* collaboration, and facility records by name or legacy name:
|
|
4
|
-
* institutions, lifecycle dates, paper count, and the
|
|
5
|
-
* selects each experiment's papers.
|
|
2
|
+
* @fileoverview cern_inspire_search_experiments — one page of INSPIRE-HEP
|
|
3
|
+
* experiment, collaboration, and facility records by name or legacy name:
|
|
4
|
+
* accelerator, host institutions, lifecycle dates, paper count, and the
|
|
5
|
+
* literature query that selects each experiment's papers.
|
|
6
6
|
* @module mcp-server/tools/definitions/search-experiments.tool
|
|
7
7
|
*/
|
|
8
8
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
9
9
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
10
|
-
import { blankAsUnset } from '../inputs.js';
|
|
10
|
+
import { blankAsUnset, moreResultsNotice, pastLastPageNotice, RESULT_WINDOW, } from '../inputs.js';
|
|
11
|
+
import { isRecid } from '../../../services/inspire/identifiers.js';
|
|
11
12
|
import { getInspireService } from '../../../services/inspire/inspire-service.js';
|
|
12
13
|
import { atLineStart, callerEcho, inline, printUrl, quote } from '../../../utils/render.js';
|
|
13
14
|
const MAX_LIMIT = 25;
|
|
@@ -61,7 +62,7 @@ const experimentSchema = z
|
|
|
61
62
|
numberOfPapers: z
|
|
62
63
|
.number()
|
|
63
64
|
.optional()
|
|
64
|
-
.describe("INSPIRE's stored paper count; it can
|
|
65
|
+
.describe("INSPIRE's stored paper count; it can differ from the number of records literatureQuery matches."),
|
|
65
66
|
description: z.string().optional().describe('Description as INSPIRE records it.'),
|
|
66
67
|
urls: z
|
|
67
68
|
.array(z
|
|
@@ -136,7 +137,7 @@ function renderExperiment(e, position) {
|
|
|
136
137
|
}
|
|
137
138
|
export const searchExperimentsTool = tool('cern_inspire_search_experiments', {
|
|
138
139
|
title: 'Search INSPIRE experiments',
|
|
139
|
-
description: "Find experiments, collaborations, and facilities in INSPIRE-HEP (ATLAS, CMS, DUNE, Belle II, …) by name, accelerator, or INSPIRE legacy name (CERN-LHC-CMS); digits alone look up an experiment recid. Each record carries the accelerator, host institutions, collaboration and subgroups, classification, lifecycle dates (proposed, approved, started, completed, ongoing), INSPIRE's paper count, a description, and a literatureQuery to pass to cern_inspire_search_literature or cern_inspire_get_citation_summary for the experiment's papers.",
|
|
140
|
+
description: "Find experiments, collaborations, and facilities in INSPIRE-HEP (ATLAS, CMS, DUNE, Belle II, …) by name, accelerator, or INSPIRE legacy name (CERN-LHC-CMS); digits alone look up an experiment recid. Each record carries the accelerator, host institutions, collaboration and subgroups, classification, lifecycle dates (proposed, approved, started, completed, ongoing), INSPIRE's paper count, a description, and a literatureQuery to pass to cern_inspire_search_literature or cern_inspire_get_citation_summary for the experiment's papers. Returns one page of records; request the next with page and the same limit. Only the first 10,000 results of a query are reachable.",
|
|
140
141
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
|
|
141
142
|
input: z.object({
|
|
142
143
|
query: z
|
|
@@ -145,21 +146,39 @@ export const searchExperimentsTool = tool('cern_inspire_search_experiments', {
|
|
|
145
146
|
.min(1)
|
|
146
147
|
.max(200)
|
|
147
148
|
.describe('Experiment, collaboration, accelerator, or facility name (ATLAS, LHCb, Tevatron), an INSPIRE legacy name (CERN-LHC-CMS), or an experiment recid (digits only).'),
|
|
148
|
-
|
|
149
|
+
page: blankAsUnset(z.number().int().min(1).default(1)).describe('Page number, starting at 1. page × effective limit (after clamping) may not exceed 10,000.'),
|
|
150
|
+
limit: blankAsUnset(z.number().int().min(1).default(5)).describe('Experiments per page (positive integer, default 5; above 25 uses 25).'),
|
|
149
151
|
}),
|
|
150
152
|
output: z.object({
|
|
151
153
|
experiments: z
|
|
152
154
|
.array(experimentSchema)
|
|
153
|
-
.describe('
|
|
155
|
+
.describe('The experiment records on this page, in INSPIRE relevance order.'),
|
|
156
|
+
page: z.number().describe('The page returned.'),
|
|
157
|
+
limit: z.number().describe('The effective limit after clamping: experiments per page.'),
|
|
158
|
+
hasMore: z.boolean().describe('True when INSPIRE has a further page of results.'),
|
|
154
159
|
}),
|
|
155
160
|
enrichment: {
|
|
156
161
|
totalCount: z.number().describe('Total experiment records the query matched.'),
|
|
157
|
-
truncated: z.boolean().describe('True when more
|
|
158
|
-
shown: z.number().describe('Number of records
|
|
162
|
+
truncated: z.boolean().describe('True when more results exist beyond this page.'),
|
|
163
|
+
shown: z.number().describe('Number of records on this page.'),
|
|
159
164
|
cap: z.number().describe('The limit applied.'),
|
|
160
|
-
|
|
165
|
+
nextPage: z
|
|
166
|
+
.number()
|
|
167
|
+
.optional()
|
|
168
|
+
.describe('The page number to request next, with the same limit, when one exists within the 10,000-result window.'),
|
|
169
|
+
notice: z.string().optional().describe('Guidance on an empty or paged result.'),
|
|
170
|
+
},
|
|
171
|
+
enrichmentTrailer: {
|
|
172
|
+
nextPage: { label: 'Next page' },
|
|
161
173
|
},
|
|
162
174
|
errors: [
|
|
175
|
+
{
|
|
176
|
+
reason: 'beyond_result_window',
|
|
177
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
178
|
+
when: 'page × effective limit (after clamping) exceeds the 10,000 results INSPIRE serves for one query.',
|
|
179
|
+
recovery: 'Narrow the query with a more specific name, legacy name, or accelerator until it matches under 10,000 records, then page again with cern_inspire_search_experiments.',
|
|
180
|
+
severity: 'notice',
|
|
181
|
+
},
|
|
163
182
|
{
|
|
164
183
|
reason: 'invalid_query',
|
|
165
184
|
code: JsonRpcErrorCode.ValidationError,
|
|
@@ -188,37 +207,62 @@ export const searchExperimentsTool = tool('cern_inspire_search_experiments', {
|
|
|
188
207
|
reason: 'upstream_unreadable',
|
|
189
208
|
code: JsonRpcErrorCode.ServiceUnavailable,
|
|
190
209
|
when: 'The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.',
|
|
191
|
-
recovery: 'Retry this call in a few seconds; if it fails again,
|
|
210
|
+
recovery: 'Retry this call in a few seconds; if it fails again, INSPIRE is likely serving an error page, so wait a minute before retrying cern_inspire_search_experiments with the same page and limit.',
|
|
192
211
|
thrownBy: 'service',
|
|
193
212
|
},
|
|
194
213
|
],
|
|
195
|
-
async handler(
|
|
214
|
+
async handler(requested, ctx) {
|
|
215
|
+
const input = { ...requested, limit: Math.min(requested.limit, MAX_LIMIT) };
|
|
216
|
+
const reduction = requested.limit > input.limit
|
|
217
|
+
? `limit ${requested.limit} reduced to ${input.limit}.`
|
|
218
|
+
: undefined;
|
|
196
219
|
ctx.enrich({ truncated: false, shown: 0, cap: input.limit });
|
|
197
220
|
ctx.enrich.total(0);
|
|
221
|
+
if (input.page * input.limit > RESULT_WINDOW) {
|
|
222
|
+
throw ctx.fail('beyond_result_window', `page ${input.page} × limit ${input.limit} reaches past the first 10,000 results, which is all INSPIRE serves for one query.`, { page: input.page, limit: input.limit });
|
|
223
|
+
}
|
|
198
224
|
const inspire = getInspireService();
|
|
199
|
-
const result = await inspire.searchExperiments(input.query, input.limit, inspire.beginCall(ctx));
|
|
225
|
+
const result = await inspire.searchExperiments({ query: input.query, page: input.page, size: input.limit }, inspire.beginCall(ctx));
|
|
200
226
|
const shown = result.experiments.length;
|
|
201
227
|
ctx.enrich({ shown });
|
|
202
228
|
ctx.enrich.total(result.total);
|
|
203
|
-
ctx.log.info('Experiment search completed', { total: result.total, shown });
|
|
229
|
+
ctx.log.info('Experiment search completed', { total: result.total, shown, page: input.page });
|
|
230
|
+
const notices = reduction ? [reduction] : [];
|
|
204
231
|
if (shown === 0) {
|
|
205
|
-
|
|
232
|
+
notices.push(result.total > 0
|
|
233
|
+
? pastLastPageNotice(input.page, result.total, input.limit)
|
|
234
|
+
: isRecid(input.query)
|
|
235
|
+
? `No INSPIRE experiment record has recid ${input.query}; search by experiment, collaboration, or accelerator name instead.`
|
|
236
|
+
: `No INSPIRE experiment matched "${callerEcho(input.query)}". Try the collaboration's common name or the accelerator (LHC, Tevatron), or search papers with cern_inspire_search_literature using "collaboration:NAME".`);
|
|
237
|
+
}
|
|
238
|
+
if (result.hasMore) {
|
|
239
|
+
const nextPage = input.page + 1;
|
|
240
|
+
const reachable = nextPage * input.limit <= RESULT_WINDOW;
|
|
241
|
+
if (reachable)
|
|
242
|
+
ctx.enrich({ nextPage });
|
|
243
|
+
notices.unshift(reachable
|
|
244
|
+
? moreResultsNotice(nextPage, 'limit', input.limit)
|
|
245
|
+
: 'INSPIRE serves only the first 10,000 results of a query; narrow it with a more specific name, legacy name, or accelerator to reach the rest.');
|
|
246
|
+
ctx.enrich.truncated({ shown, cap: input.limit, guidance: notices.join(' ') });
|
|
206
247
|
}
|
|
207
|
-
else if (
|
|
208
|
-
ctx.enrich.
|
|
209
|
-
shown,
|
|
210
|
-
cap: input.limit,
|
|
211
|
-
guidance: input.limit < MAX_LIMIT
|
|
212
|
-
? `More experiments matched; raise limit (max ${MAX_LIMIT}) or use a more specific name or legacy name.`
|
|
213
|
-
: 'More experiments matched than the 25 returned; use a more specific name or legacy name.',
|
|
214
|
-
});
|
|
248
|
+
else if (notices.length > 0) {
|
|
249
|
+
ctx.enrich.notice(notices.join(' '));
|
|
215
250
|
}
|
|
216
|
-
return {
|
|
251
|
+
return {
|
|
252
|
+
experiments: result.experiments,
|
|
253
|
+
page: input.page,
|
|
254
|
+
limit: input.limit,
|
|
255
|
+
hasMore: result.hasMore,
|
|
256
|
+
};
|
|
217
257
|
},
|
|
218
258
|
format: (result) => {
|
|
219
|
-
const lines = [
|
|
259
|
+
const lines = [
|
|
260
|
+
`## INSPIRE experiments, page ${result.page}`,
|
|
261
|
+
`**Page:** ${result.page} · **Limit:** ${result.limit} · **Experiments on this page:** ${result.experiments.length} · **More pages:** ${result.hasMore ? 'yes' : 'no'}`,
|
|
262
|
+
];
|
|
263
|
+
const offset = (result.page - 1) * result.limit;
|
|
220
264
|
result.experiments.forEach((experiment, i) => {
|
|
221
|
-
lines.push('', ...renderExperiment(experiment, i + 1));
|
|
265
|
+
lines.push('', ...renderExperiment(experiment, offset + i + 1));
|
|
222
266
|
});
|
|
223
267
|
return [{ type: 'text', text: lines.join('\n') }];
|
|
224
268
|
},
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-experiments.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-experiments.tool.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"search-experiments.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-experiments.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -40,14 +40,14 @@ export declare const searchHepdataTool: import("@cyanheads/mcp-ts-core").ToolDef
|
|
|
40
40
|
}, z.core.$strip>, readonly [{
|
|
41
41
|
readonly reason: "beyond_result_window";
|
|
42
42
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
43
|
-
readonly when: "page × size exceeds the 10,000 results INSPIRE serves for one query.";
|
|
43
|
+
readonly when: "page × effective size (after clamping) exceeds the 10,000 results INSPIRE serves for one query.";
|
|
44
44
|
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.";
|
|
45
45
|
readonly severity: "notice";
|
|
46
46
|
}, {
|
|
47
47
|
readonly reason: "invalid_query";
|
|
48
48
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
49
|
-
readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
|
|
50
|
-
readonly recovery: "
|
|
49
|
+
readonly when: "A recognized field clause has no value, or INSPIRE answered 400 to a parameter value it refuses.";
|
|
50
|
+
readonly recovery: "Give every field a value (for example \"t higgs\"), check cern_inspire_list_reference topic search_syntax, then retry cern_inspire_search_hepdata.";
|
|
51
51
|
readonly severity: "notice";
|
|
52
52
|
readonly thrownBy: "service";
|
|
53
53
|
}, {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-hepdata.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-hepdata.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"search-hepdata.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-hepdata.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA2GjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+K5B,CAAC"}
|
|
@@ -8,11 +8,9 @@
|
|
|
8
8
|
*/
|
|
9
9
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
10
10
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
11
|
-
import { blankAsUnset } from '../inputs.js';
|
|
11
|
+
import { blankAsUnset, hasEmptyQueryField, moreResultsNotice, pastLastPageNotice, RESULT_WINDOW, } from '../inputs.js';
|
|
12
12
|
import { getInspireService } from '../../../services/inspire/inspire-service.js';
|
|
13
13
|
import { callerEcho, identifier, inline, printUrl, quote } from '../../../utils/render.js';
|
|
14
|
-
/** INSPIRE serves at most this many results of one query (`page × size`). */
|
|
15
|
-
const RESULT_WINDOW = 10_000;
|
|
16
14
|
const SORTS = ['relevance', 'mostrecent'];
|
|
17
15
|
const hepdataRecordSchema = z
|
|
18
16
|
.object({
|
|
@@ -100,17 +98,17 @@ export const searchHepdataTool = tool('cern_inspire_search_hepdata', {
|
|
|
100
98
|
.trim()
|
|
101
99
|
.min(1)
|
|
102
100
|
.max(1000)
|
|
103
|
-
.describe('Free text or INSPIRE syntax over HEPData records, e.g. top pair differential cross section 13 TeV; collaborations.value:LHCb; keywords.value:"Inclusive"; or literature.control_number:<recid> for one paper\'s data.
|
|
101
|
+
.describe('Free text or INSPIRE syntax over HEPData records, e.g. top pair differential cross section 13 TeV; collaborations.value:LHCb; keywords.value:"Inclusive"; or literature.control_number:<recid> for one paper\'s data. Empty recognized field clauses such as t: or a:"" are invalid; other syntax is passed to INSPIRE without complete grammar validation. See cern_inspire_list_reference topic search_syntax.'),
|
|
104
102
|
sort: blankAsUnset(z.enum(SORTS).default('relevance')).describe('Result order: relevance (default) or mostrecent.'),
|
|
105
|
-
page: blankAsUnset(z.number().int().min(1).default(1)).describe('Page number, starting at 1. page × size may not exceed 10,000.'),
|
|
106
|
-
size: blankAsUnset(z.number().int().min(1).
|
|
103
|
+
page: blankAsUnset(z.number().int().min(1).default(1)).describe('Page number, starting at 1. page × effective size (after clamping) may not exceed 10,000.'),
|
|
104
|
+
size: blankAsUnset(z.number().int().min(1).default(10)).describe('Records per page (positive integer, default 10; above 50 uses 50).'),
|
|
107
105
|
}),
|
|
108
106
|
output: z.object({
|
|
109
107
|
records: z
|
|
110
108
|
.array(hepdataRecordSchema)
|
|
111
109
|
.describe('The HEPData records on this page, in the requested order.'),
|
|
112
110
|
page: z.number().describe('The page returned.'),
|
|
113
|
-
size: z.number().describe('The page size
|
|
111
|
+
size: z.number().describe('The effective page size after clamping.'),
|
|
114
112
|
hasMore: z.boolean().describe('True when INSPIRE has a further page of results.'),
|
|
115
113
|
}),
|
|
116
114
|
enrichment: {
|
|
@@ -121,7 +119,7 @@ export const searchHepdataTool = tool('cern_inspire_search_hepdata', {
|
|
|
121
119
|
nextPage: z
|
|
122
120
|
.number()
|
|
123
121
|
.optional()
|
|
124
|
-
.describe('The page number to request next, when one exists within the 10,000-result window.'),
|
|
122
|
+
.describe('The page number to request next, with the same size, when one exists within the 10,000-result window.'),
|
|
125
123
|
notice: z.string().optional().describe('Guidance on an empty or paged result.'),
|
|
126
124
|
},
|
|
127
125
|
enrichmentTrailer: {
|
|
@@ -131,15 +129,15 @@ export const searchHepdataTool = tool('cern_inspire_search_hepdata', {
|
|
|
131
129
|
{
|
|
132
130
|
reason: 'beyond_result_window',
|
|
133
131
|
code: JsonRpcErrorCode.ValidationError,
|
|
134
|
-
when: 'page × size exceeds the 10,000 results INSPIRE serves for one query.',
|
|
132
|
+
when: 'page × effective size (after clamping) exceeds the 10,000 results INSPIRE serves for one query.',
|
|
135
133
|
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.',
|
|
136
134
|
severity: 'notice',
|
|
137
135
|
},
|
|
138
136
|
{
|
|
139
137
|
reason: 'invalid_query',
|
|
140
138
|
code: JsonRpcErrorCode.ValidationError,
|
|
141
|
-
when: 'INSPIRE answered 400 to a parameter value it refuses.',
|
|
142
|
-
recovery: '
|
|
139
|
+
when: 'A recognized field clause has no value, or INSPIRE answered 400 to a parameter value it refuses.',
|
|
140
|
+
recovery: 'Give every field a value (for example "t higgs"), check cern_inspire_list_reference topic search_syntax, then retry cern_inspire_search_hepdata.',
|
|
143
141
|
severity: 'notice',
|
|
144
142
|
thrownBy: 'service',
|
|
145
143
|
},
|
|
@@ -167,9 +165,15 @@ export const searchHepdataTool = tool('cern_inspire_search_hepdata', {
|
|
|
167
165
|
thrownBy: 'service',
|
|
168
166
|
},
|
|
169
167
|
],
|
|
170
|
-
async handler(
|
|
168
|
+
async handler(requested, ctx) {
|
|
169
|
+
const input = { ...requested, size: Math.min(requested.size, 50) };
|
|
170
|
+
const reduction = requested.size > input.size ? `size ${requested.size} reduced to ${input.size}.` : undefined;
|
|
171
171
|
ctx.enrich({ truncated: false, shown: 0, cap: input.size });
|
|
172
172
|
ctx.enrich.total(0);
|
|
173
|
+
// The data collection runs INSPIRE's literature query parser, which reads an empty clause as free text.
|
|
174
|
+
if (hasEmptyQueryField(input.query)) {
|
|
175
|
+
throw ctx.fail('invalid_query', 'A recognized INSPIRE field clause has no value; use "t higgs", for example.');
|
|
176
|
+
}
|
|
173
177
|
if (input.page * input.size > RESULT_WINDOW) {
|
|
174
178
|
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 });
|
|
175
179
|
}
|
|
@@ -182,10 +186,10 @@ export const searchHepdataTool = tool('cern_inspire_search_hepdata', {
|
|
|
182
186
|
shown: result.records.length,
|
|
183
187
|
page: input.page,
|
|
184
188
|
});
|
|
185
|
-
const notices = [];
|
|
189
|
+
const notices = reduction ? [reduction] : [];
|
|
186
190
|
if (result.records.length === 0) {
|
|
187
191
|
notices.push(result.total > 0
|
|
188
|
-
?
|
|
192
|
+
? pastLastPageNotice(input.page, result.total, input.size)
|
|
189
193
|
: `No HEPData record matched "${callerEcho(input.query)}". HEPData keywords use phrases like "Inclusive", "Differential Cross Section", and reactions like "P P --> TOP TOPBAR X"; try fewer words or a collaborations.value:NAME clause, or find the paper with cern_inspire_search_literature.`);
|
|
190
194
|
}
|
|
191
195
|
if (result.hasMore) {
|
|
@@ -194,7 +198,7 @@ export const searchHepdataTool = tool('cern_inspire_search_hepdata', {
|
|
|
194
198
|
if (reachable)
|
|
195
199
|
ctx.enrich({ nextPage });
|
|
196
200
|
notices.unshift(reachable
|
|
197
|
-
?
|
|
201
|
+
? moreResultsNotice(nextPage, 'size', input.size)
|
|
198
202
|
: 'INSPIRE serves only the first 10,000 results of a query; narrow it with tighter terms, a collaboration, or an energy to reach the rest.');
|
|
199
203
|
ctx.enrich.truncated({
|
|
200
204
|
shown: result.records.length,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-hepdata.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-hepdata.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,
|
|
1
|
+
{"version":3,"file":"search-hepdata.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-hepdata.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GACd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEpF,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,YAAY,CAAU,CAAC;AAEnD,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CACP,kJAAkJ,CACnJ;IACH,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;SAC3D,QAAQ,CAAC,yEAAyE,CAAC;IACtF,cAAc,EAAE,CAAC;SACd,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;SACjD,QAAQ,CAAC,0BAA0B,CAAC;IACvC,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;SAC7D,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,QAAQ,EAAE,CAAC;SACR,KAAK,CACJ,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC,CACzF;SACA,QAAQ,CAAC,6EAA6E,CAAC;IAC1F,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gRAAgR,CACjR;IACH,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IAC/F,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,kKAAkK,CACnK;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACrF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0MAA0M,CAC3M;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAChF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CAC/F,CAAC;KACD,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AAI5C,SAAS,YAAY,CAAC,CAAsB,EAAE,QAAgB;IAC5D,MAAM,KAAK,GAAG,CAAC,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;IACtE,KAAK,CAAC,IAAI,CACR;QACE,2BAA2B,CAAC,CAAC,gBAAgB,EAAE;QAC/C,CAAC,CAAC,OAAO,IAAI,gBAAgB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;QAChD,CAAC,CAAC,aAAa,KAAK,SAAS,IAAI,kBAAkB,CAAC,CAAC,aAAa,EAAE;KACrE;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,KAAK,CAAC,CACf,CAAC;IACF,KAAK,CAAC,IAAI,CACR,qBAAqB,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CACzG,CAAC;IACF,MAAM,OAAO,GAAG;QACd,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,uBAAuB,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC/F,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,oBAAoB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACvF,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG;QACd,CAAC,CAAC,SAAS,IAAI,mBAAmB,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;QAC3D,CAAC,CAAC,YAAY,IAAI,8BAA8B,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE;QACxE,CAAC,CAAC,aAAa,KAAK,SAAS,IAAI,uBAAuB,CAAC,CAAC,aAAa,EAAE;QACzE,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,eAAe,CAAC,CAAC,UAAU,EAAE;KAC5D,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CACR,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,eAAe,EACnE,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CACzB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,6BAA6B,EAAE;IACnE,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EACT,snBAAsnB;IACxnB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,CACP,kZAAkZ,CACnZ;QACH,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAC7D,kDAAkD,CACnD;QACD,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAC7D,2FAA2F,CAC5F;QACD,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAC9D,oEAAoE,CACrE;KACF,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,mBAAmB,CAAC;aAC1B,QAAQ,CAAC,2DAA2D,CAAC;QACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACpE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;KAClF,CAAC;IACF,UAAU,EAAE;QACV,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QAC3E,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC7D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAClD,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uGAAuG,CACxG;QACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KAChF;IACD,iBAAiB,EAAE;QACjB,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;KACjC;IACD,MAAM,EAAE;QACN;YACE,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,iGAAiG;YACvG,QAAQ,EACN,gLAAgL;YAClL,QAAQ,EAAE,QAAQ;SACnB;QACD;YACE,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,kGAAkG;YACxG,QAAQ,EACN,kJAAkJ;YACpJ,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,yLAAyL;YAC3L,QAAQ,EAAE,SAAS;SACpB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG;QAC1B,MAAM,KAAK,GAAG,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACnE,MAAM,SAAS,GACb,SAAS,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,SAAS,CAAC,IAAI,eAAe,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/F,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEpB,wGAAwG;QACxG,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,GAAG,CAAC,IAAI,CACZ,eAAe,EACf,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;YAC5C,MAAM,GAAG,CAAC,IAAI,CACZ,sBAAsB,EACtB,QAAQ,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,IAAI,oFAAoF,EAC3H,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CACvC,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CACxC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAC5E,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CACvB,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACvC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAa,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CACV,MAAM,CAAC,KAAK,GAAG,CAAC;gBACd,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;gBAC1D,CAAC,CAAC,8BAA8B,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,0OAA0O,CACpS,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YAChC,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,IAAI,IAAI,aAAa,CAAC;YACzD,IAAI,SAAS;gBAAE,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,OAAO,CACb,SAAS;gBACP,CAAC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;gBACjD,CAAC,CAAC,yIAAyI,CAC9I,CAAC;YACF,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBAC5B,GAAG,EAAE,KAAK,CAAC,IAAI;gBACf,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;aAC5B,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG;YACZ,4BAA4B,MAAM,CAAC,IAAI,EAAE;YACzC,aAAa,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,gCAAgC,MAAM,CAAC,OAAO,CAAC,MAAM,sBAAsB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;SAC9J,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QAC/C,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview cern_inspire_search_institutions — one page of INSPIRE-HEP
|
|
3
|
+
* institution records by name words, an exact recorded name (`legacy_ICN`), or
|
|
4
|
+
* recid: the recorded name, hierarchy, types, location, paper count, related
|
|
5
|
+
* records, and the `affid:N` literature query that selects each record's papers.
|
|
6
|
+
* @module mcp-server/tools/definitions/search-institutions.tool
|
|
7
|
+
*/
|
|
8
|
+
import { z } from '@cyanheads/mcp-ts-core';
|
|
9
|
+
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
10
|
+
export declare const searchInstitutionsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
|
|
11
|
+
query: z.ZodString;
|
|
12
|
+
page: z.ZodPreprocess<z.ZodDefault<z.ZodNumber>, unknown>;
|
|
13
|
+
limit: z.ZodPreprocess<z.ZodDefault<z.ZodNumber>, unknown>;
|
|
14
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
15
|
+
institutions: z.ZodArray<z.ZodObject<{
|
|
16
|
+
recid: z.ZodString;
|
|
17
|
+
legacyIcn: z.ZodOptional<z.ZodString>;
|
|
18
|
+
hierarchy: z.ZodArray<z.ZodObject<{
|
|
19
|
+
name: z.ZodOptional<z.ZodString>;
|
|
20
|
+
acronym: z.ZodOptional<z.ZodString>;
|
|
21
|
+
}, z.core.$strip>>;
|
|
22
|
+
institutionTypes: z.ZodArray<z.ZodString>;
|
|
23
|
+
cities: z.ZodArray<z.ZodString>;
|
|
24
|
+
countryCodes: z.ZodArray<z.ZodString>;
|
|
25
|
+
numberOfPapers: z.ZodOptional<z.ZodNumber>;
|
|
26
|
+
relatedRecords: z.ZodArray<z.ZodObject<{
|
|
27
|
+
recid: z.ZodString;
|
|
28
|
+
relation: z.ZodOptional<z.ZodString>;
|
|
29
|
+
}, z.core.$strip>>;
|
|
30
|
+
inactive: z.ZodOptional<z.ZodBoolean>;
|
|
31
|
+
literatureQuery: z.ZodString;
|
|
32
|
+
}, z.core.$strip>>;
|
|
33
|
+
page: z.ZodNumber;
|
|
34
|
+
limit: z.ZodNumber;
|
|
35
|
+
hasMore: z.ZodBoolean;
|
|
36
|
+
}, z.core.$strip>, readonly [{
|
|
37
|
+
readonly reason: "beyond_result_window";
|
|
38
|
+
readonly code: JsonRpcErrorCode.ValidationError;
|
|
39
|
+
readonly when: "page × effective limit (after clamping) exceeds the 10,000 results INSPIRE serves for one query.";
|
|
40
|
+
readonly recovery: "Narrow the query with more name words, the city, or the exact legacy_ICN:\"NAME\" form until it matches under 10,000 records, then page again with cern_inspire_search_institutions.";
|
|
41
|
+
readonly severity: "notice";
|
|
42
|
+
}, {
|
|
43
|
+
readonly reason: "invalid_query";
|
|
44
|
+
readonly code: JsonRpcErrorCode.ValidationError;
|
|
45
|
+
readonly when: "INSPIRE answered 400 to a parameter value it refuses.";
|
|
46
|
+
readonly recovery: "Retry cern_inspire_search_institutions with plain institution name words, or one legacy_ICN:\"NAME\" clause with the name in double quotes.";
|
|
47
|
+
readonly severity: "notice";
|
|
48
|
+
readonly thrownBy: "service";
|
|
49
|
+
}, {
|
|
50
|
+
readonly reason: "inspire_rate_limited";
|
|
51
|
+
readonly code: JsonRpcErrorCode.RateLimited;
|
|
52
|
+
readonly when: "INSPIRE returned 429 after the pacer and retries.";
|
|
53
|
+
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.";
|
|
54
|
+
readonly retryable: true;
|
|
55
|
+
readonly thrownBy: "service";
|
|
56
|
+
}, {
|
|
57
|
+
readonly reason: "pacer_shed";
|
|
58
|
+
readonly code: JsonRpcErrorCode.RateLimited;
|
|
59
|
+
readonly when: "The server's outbound INSPIRE queue could not start the request within the call's remaining budget.";
|
|
60
|
+
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.";
|
|
61
|
+
readonly retryable: true;
|
|
62
|
+
readonly thrownBy: "service";
|
|
63
|
+
}, {
|
|
64
|
+
readonly reason: "upstream_unreadable";
|
|
65
|
+
readonly code: JsonRpcErrorCode.ServiceUnavailable;
|
|
66
|
+
readonly when: "The INSPIRE body exceeded the byte ceiling, was HTML where JSON was expected, or was invalid JSON.";
|
|
67
|
+
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_search_institutions with the same page and limit.";
|
|
68
|
+
readonly thrownBy: "service";
|
|
69
|
+
}], {
|
|
70
|
+
readonly totalCount: z.ZodNumber;
|
|
71
|
+
readonly truncated: z.ZodBoolean;
|
|
72
|
+
readonly shown: z.ZodNumber;
|
|
73
|
+
readonly cap: z.ZodNumber;
|
|
74
|
+
readonly nextPage: z.ZodOptional<z.ZodNumber>;
|
|
75
|
+
readonly notice: z.ZodOptional<z.ZodString>;
|
|
76
|
+
}>;
|
|
77
|
+
//# sourceMappingURL=search-institutions.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-institutions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-institutions.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA0HjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkKjC,CAAC"}
|