@cyanheads/openalex-mcp-server 0.10.1 → 0.11.0

package/dist/mcp-server/tools/render-entity-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-entity-record.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/render-entity-record.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render-entity-record.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/render-entity-record.ts"],"names":[],"mappings":"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"}

package/dist/services/openalex/field-catalog.json

@@ -512,6 +512,8 @@
             "topics.subfield.id",
             "type",
             "works_count",
+            "works_count_with_children",
+            "works_count_with_children_and_predecessors",
             "x_concepts.id"
         ],
         "select": [
@@ -530,6 +532,8 @@
             "display_name_alternatives",
             "repositories",
             "works_count",
+            "works_count_with_children",
+            "works_count_with_children_and_predecessors",
             "cited_by_count",
             "summary_stats",
             "ids",
@@ -715,5 +719,108 @@
             "updated_date",
             "created_date"
         ]
+    },
+    "awards": {
+        "filter": [
+            "amount",
+            "amount_usd",
+            "amount_usd_basis",
+            "collection",
+            "currency",
+            "default.search",
+            "description.search",
+            "display_name.search",
+            "doi",
+            "end_year",
+            "funded_outputs",
+            "funded_outputs_count",
+            "funder.country_code",
+            "funder.doi",
+            "funder.id",
+            "funder.ror",
+            "funder_award_id",
+            "funder_name",
+            "funder_scheme",
+            "funding_type",
+            "has_parent_award",
+            "has_recipient_country",
+            "id",
+            "institution_awarded.continent",
+            "institution_awarded.country_code",
+            "institution_awarded.id",
+            "institution_awarded.lineage",
+            "institution_awarded.ror",
+            "institution_awarded.type",
+            "lead_investigator.affiliation.country",
+            "lead_investigator.affiliation.name",
+            "lead_investigator.family_name",
+            "lead_investigator.given_name",
+            "lead_investigator.orcid",
+            "parent_awards.funder.id",
+            "parent_awards.id",
+            "parent_awards.relationship",
+            "primary_topic.domain.id",
+            "primary_topic.field.id",
+            "primary_topic.id",
+            "primary_topic.subfield.id",
+            "provenance",
+            "recipient_countries.basis",
+            "recipient_countries.continent",
+            "recipient_countries.country_code",
+            "recipient_regions.code",
+            "recipients.id",
+            "recipients.ror",
+            "research_scope.basis",
+            "research_scope.is_research",
+            "start_year",
+            "sub_awards.funder.id",
+            "sub_awards.id",
+            "sub_awards.relationship",
+            "sub_awards_count",
+            "text.search",
+            "topics.domain.id",
+            "topics.field.id",
+            "topics.id",
+            "topics.subfield.id"
+        ],
+        "select": [
+            "id",
+            "display_name",
+            "description",
+            "funder_award_id",
+            "funder",
+            "funded_outputs",
+            "funded_outputs_count",
+            "parent_awards",
+            "sub_awards",
+            "sub_awards_count",
+            "amount",
+            "currency",
+            "amount_usd",
+            "amount_usd_basis",
+            "recipients",
+            "recipient_countries",
+            "recipient_regions",
+            "research_scope",
+            "funding_type",
+            "funder_scheme",
+            "start_date",
+            "end_date",
+            "start_year",
+            "end_year",
+            "landing_page_url",
+            "doi",
+            "provenance",
+            "lead_investigator",
+            "co_lead_investigator",
+            "investigators",
+            "works_api_url",
+            "primary_topic",
+            "topics",
+            "institution_awarded",
+            "updated_date",
+            "created_date",
+            "relevance_score"
+        ]
     }
 }

package/dist/services/openalex/openalex-service.d.ts

@@ -3,8 +3,19 @@
  * @module services/openalex/openalex-service
  */
 import type { Context } from '@cyanheads/mcp-ts-core';
-import { type AnalyzeParams, type AnalyzeResult, type AutocompleteParams, type AutocompleteRecord, type AutocompleteResult, type EntityRecord, type EntityType, type SearchParams, type SearchResult } from './types.js';
-/** Whether this aggregation keeps count order, ignoring the native unknown-bucket suffix. */
+import { type AnalyzeParams, type AnalyzeResult, type AutocompleteEntityType, type AutocompleteParams, type AutocompleteRecord, type AutocompleteResult, type EntityRecord, type EntityType, type SearchParams, type SearchResult } from './types.js';
+/**
+ * Whether this aggregation keeps count order, ignoring the native unknown-bucket suffix: a
+ * true/false field, which never has more than two groups and whose `cursor=*` OpenAlex answers
+ * with HTTP 400 ("Cannot use cursor pagination when grouping fields that return true or false.").
+ *
+ * A field is boolean when any dotted segment starts with `is_` or `has_` — the segment, not the
+ * leaf, so `has_content.pdf` counts — or when it is one of the unprefixed fields above. That
+ * covered every groupable boolean on every entity type in a live sweep (2026-10-28), and no
+ * groupable field it matches is anything but true/false. The service (whether to send `cursor`)
+ * and `openalex_analyze_trends` (the echoed order and the key-order notice) both read this one
+ * predicate, so they cannot disagree about a field.
+ */
 export declare function isBooleanGroupBy(groupBy: string): boolean;
 /** One upstream filter clause: the canonical key and the value it constrains. */
 type FilterClause = [key: string, value: string];
@@ -128,7 +139,7 @@ export interface IdentifierResolution extends AutocompleteResult {
  * works. Any other type leaves the identifier's own types in place — except `keywords`, under
  * which a bare native-ID shape is a name: keyword IDs are slugs, and `P53` is a keyword.
  */
-export declare function inferIdentifier(query: string, requested?: EntityType): ResolvedIdentifier | undefined;
+export declare function inferIdentifier(query: string, requested?: AutocompleteEntityType): ResolvedIdentifier | undefined;
 /**
  * Shape a singleton entity record like an autocomplete match, so both resolution paths of
  * `openalex_resolve_name` return one result type. `entity_type` is singularized to match what
@@ -152,10 +163,10 @@ export declare function selectRecordKey(entityType: SearchParams['entityType'],
  * Detect a value the `id:` filter would carry — OpenAlex IDs, bare or in any URL spelling
  * `parseOpenAlexUrl()` reads, optionally pipe-joined for OR semantics. When matched, `id` is
  * rewritten to `openalex` (the canonical filter key) and the value is forwarded as written:
- * upstream accepts every one of those spellings, and the space around a `|`. Stricter than any
- * value so a future generic upstream `id:` filter wouldn't be shadowed — only values that read
- * as OpenAlex IDs get redirected. Exported for the timing suite, which runs it on caller-sized
- * values.
+ * upstream accepts every one of those spellings, and the space around a `|`. Awards are the
+ * exception (see `awardIdFilterValue`). Stricter than any value so a future generic upstream
+ * `id:` filter wouldn't be shadowed — only values that read as OpenAlex IDs get redirected.
+ * Exported for the timing suite, which runs it on caller-sized values.
  */
 export declare function isOpenAlexFilterValue(value: string): boolean;
 /**

package/dist/services/openalex/openalex-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openalex-service.d.ts","sourceRoot":"","sources":["../../../src/services/openalex/openalex-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openalex-service.d.ts","sourceRoot":"","sources":["../../../src/services/openalex/openalex-service.ts"],"names":[],"mappings":"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"}

package/dist/services/openalex/openalex-service.js

@@ -10,29 +10,33 @@ import fieldCatalog from './field-catalog.json' with { type: 'json' };
 import { rankFields } from './field-ranker.js';
 import { quoteCallerText, quotedCommaValue, upstreamFilterValue } from './filter-values.js';
 import { normalizeProviderText, normalizeProviderValue } from './provider-text.js';
-import { DEFAULT_SELECT, ENTITY_TYPES, } from './types.js';
+import { AUTOCOMPLETE_ENTITY_TYPES, DEFAULT_SELECT, ENTITY_TYPES, } from './types.js';
 import { redactUrlsInMessage } from './url-redaction.js';
 /**
- * OpenAlex group_by fields that produce only true/false groups and reject
- * cursor pagination (HTTP 400). These fields never have more than two groups,
- * so cursor-based paging is unnecessary and the upstream rejects `cursor=*`.
- */
-const BOOLEAN_GROUP_BY_FIELDS = new Set([
-    'is_retracted',
-    'is_paratext',
-    'is_oa',
-    'has_orcid',
-    'has_doi',
-    'has_raw_affiliation_string',
-    'open_access.is_oa',
-    'apc_paid',
-    'has_fulltext',
+ * True/false group_by fields whose names carry no `is_`/`has_` segment. OpenAlex names every
+ * other boolean field that way, on every entity type.
+ */
+const UNPREFIXED_BOOLEAN_GROUP_BY_FIELDS = new Set([
+    'mag_only',
+    'open_access.any_repository_has_fulltext',
 ]);
-/** Whether this aggregation keeps count order, ignoring the native unknown-bucket suffix. */
+/**
+ * Whether this aggregation keeps count order, ignoring the native unknown-bucket suffix: a
+ * true/false field, which never has more than two groups and whose `cursor=*` OpenAlex answers
+ * with HTTP 400 ("Cannot use cursor pagination when grouping fields that return true or false.").
+ *
+ * A field is boolean when any dotted segment starts with `is_` or `has_` — the segment, not the
+ * leaf, so `has_content.pdf` counts — or when it is one of the unprefixed fields above. That
+ * covered every groupable boolean on every entity type in a live sweep (2026-10-28), and no
+ * groupable field it matches is anything but true/false. The service (whether to send `cursor`)
+ * and `openalex_analyze_trends` (the echoed order and the key-order notice) both read this one
+ * predicate, so they cannot disagree about a field.
+ */
 export function isBooleanGroupBy(groupBy) {
     const suffix = ':include_unknown';
     const baseField = groupBy.endsWith(suffix) ? groupBy.slice(0, -suffix.length) : groupBy;
-    return BOOLEAN_GROUP_BY_FIELDS.has(baseField);
+    return (UNPREFIXED_BOOLEAN_GROUP_BY_FIELDS.has(baseField) ||
+        baseField.split('.').some((segment) => segment.startsWith('is_') || segment.startsWith('has_')));
 }
 /**
  * Build an OpenAlex filter string from ordered key-value clauses.
@@ -277,6 +281,7 @@ export function normalizeId(id) {
 const ENTITY_TYPE_BY_ID_LETTER = {
     A: 'authors',
     F: 'funders',
+    G: 'awards',
     I: 'institutions',
     P: 'publishers',
     S: 'sources',
@@ -284,21 +289,21 @@ const ENTITY_TYPE_BY_ID_LETTER = {
     W: 'works',
 };
 /**
- * Native OpenAlex IDs this server can route. Three letters `OPENALEX_ID_VALUE_PATTERN` accepts
- * as *filter values* are deliberately absent here. `C` (the deprecated Concepts entity) and `G`
- * are not in `ENTITY_TYPES`, so there is no endpoint to fetch one from. `K` is in `ENTITY_TYPES`,
- * but OpenAlex identifies keywords by slug and emits no numeric K-prefixed IDs, so routing that
- * shape addressed nothing — a keyword URL is the keyword identifier. All three fall through to
- * autocomplete rather than being routed to a path that would 404.
+ * Native OpenAlex IDs this server can route. Two letters `OPENALEX_ID_VALUE_PATTERN` accepts as
+ * *filter values* are deliberately absent here. `C` (the deprecated Concepts entity) is not in
+ * `ENTITY_TYPES`, so there is no endpoint to fetch one from. `K` is in `ENTITY_TYPES`, but
+ * OpenAlex identifies keywords by slug and emits no numeric K-prefixed IDs, so routing that shape
+ * addressed nothing — a keyword URL is the keyword identifier. Both fall through to autocomplete
+ * rather than being routed to a path that would 404.
  */
-const ROUTABLE_OPENALEX_ID = /^([AFIPSTW])\d+$/;
+const ROUTABLE_OPENALEX_ID = /^([AFGIPSTW])\d+$/;
 /**
  * A native ID whose letter names the entity type that holds it — every routable letter plus `C`,
  * a concept ID, which names a type this server does not serve. Read case-insensitively: OpenAlex
  * answers a lower-case ID as it does the upper-case one. `V` (a legacy venue ID that still
- * resolves under `/sources/`), `K`, and `G` are absent, so `search()` checks none of them.
+ * resolves under `/sources/`) and `K` are absent, so `search()` checks neither.
  */
-const LETTERED_OPENALEX_ID = /^([ACFIPSTW])\d+$/i;
+const LETTERED_OPENALEX_ID = /^([ACFGIPSTW])\d+$/i;
 /**
  * Refuse a native ID whose letter names a different entity type than the lookup's. No record of
  * one type carries another type's letter and every cross-letter lookup 404s upstream, so the
@@ -703,21 +708,39 @@ function resolveSelect(entityType, select) {
  * to detect OR-joined ID lists.
  */
 const OPENALEX_ID_VALUE_PATTERN = /^[WAISTKPFCG]\d+$/i;
+/** One `id` filter segment as the bare ID it names, or the segment itself when it is no URL. */
+function filterSegmentId(segment) {
+    const trimmed = segment.trim();
+    const fromUrl = parseOpenAlexUrl(trimmed);
+    return fromUrl?.kind === 'native' ? fromUrl.id : trimmed;
+}
 /**
  * Detect a value the `id:` filter would carry — OpenAlex IDs, bare or in any URL spelling
  * `parseOpenAlexUrl()` reads, optionally pipe-joined for OR semantics. When matched, `id` is
  * rewritten to `openalex` (the canonical filter key) and the value is forwarded as written:
- * upstream accepts every one of those spellings, and the space around a `|`. Stricter than any
- * value so a future generic upstream `id:` filter wouldn't be shadowed — only values that read
- * as OpenAlex IDs get redirected. Exported for the timing suite, which runs it on caller-sized
- * values.
+ * upstream accepts every one of those spellings, and the space around a `|`. Awards are the
+ * exception (see `awardIdFilterValue`). Stricter than any value so a future generic upstream
+ * `id:` filter wouldn't be shadowed — only values that read as OpenAlex IDs get redirected.
+ * Exported for the timing suite, which runs it on caller-sized values.
  */
 export function isOpenAlexFilterValue(value) {
-    return value.split('|').every((segment) => {
-        const trimmed = segment.trim();
-        const fromUrl = parseOpenAlexUrl(trimmed);
-        return OPENALEX_ID_VALUE_PATTERN.test(fromUrl?.kind === 'native' ? fromUrl.id : trimmed);
-    });
+    return value
+        .split('|')
+        .every((segment) => OPENALEX_ID_VALUE_PATTERN.test(filterSegmentId(segment)));
+}
+/**
+ * An `id` filter value for awards, which have no `openalex` filter (a 400) and whose `id` filter
+ * matches only the `https://openalex.org/G…` URL — a bare `G…`, in either case, matches nothing
+ * with no error. Each OR segment is rewritten to that URL, its letter upper-cased.
+ */
+function awardIdFilterValue(value) {
+    return value
+        .split('|')
+        .map((segment) => {
+        const id = filterSegmentId(segment);
+        return `https://openalex.org/${id.charAt(0).toUpperCase()}${id.slice(1)}`;
+    })
+        .join('|');
 }
 /**
  * Rewrite one caller-supplied filter key to the upstream OpenAlex name, before the
@@ -733,8 +756,9 @@ export function translateFilterKey(entityType, key) {
 }
 /**
  * Rewrite caller-supplied filter keys to the upstream OpenAlex names. Works-only key map plus
- * a universal `id` → `openalex` rewrite when the value looks like an OpenAlex ID. Values pass
- * through unchanged.
+ * an `id` → `openalex` rewrite when the value looks like an OpenAlex ID, on every type but
+ * awards, whose ID values stay under `id` in the URL form it matches (`awardIdFilterValue`).
+ * Every other value passes through unchanged.
  *
  * Emits clauses rather than a record because an alias and its canonical name are two separate
  * constraints that resolve to one key — `{year: "2020", publication_year: "2024"}` is a request
@@ -745,9 +769,11 @@ export function translateFilterKey(entityType, key) {
  */
 function translateFilters(entityType, filters) {
     const out = [];
-    for (const [rawKey, value] of Object.entries(filters)) {
+    for (const [rawKey, rawValue] of Object.entries(filters)) {
         const aliased = translateFilterKey(entityType, rawKey);
-        const finalKey = aliased === 'id' && isOpenAlexFilterValue(value) ? 'openalex' : aliased;
+        const openAlexIds = aliased === 'id' && isOpenAlexFilterValue(rawValue);
+        const finalKey = openAlexIds && entityType !== 'awards' ? 'openalex' : aliased;
+        const value = openAlexIds && entityType === 'awards' ? awardIdFilterValue(rawValue) : rawValue;
         if (out.some(([key, existing]) => key === finalKey && existing === value))
             continue;
         out.push([finalKey, value]);
@@ -777,7 +803,7 @@ const REQUEST_TIMEOUT_MS = 10_000;
  * the name search reports a timeout without being sent.
  */
 const NAME_FALLBACK_DEADLINE_MS = 45_000;
-const KNOWN_AUTOCOMPLETE_TYPES = new Set(ENTITY_TYPES.map((type) => type.replace(/s$/, '')));
+const KNOWN_AUTOCOMPLETE_TYPES = new Set(AUTOCOMPLETE_ENTITY_TYPES.map((type) => type.replace(/s$/, '')));
 /**
  * `JsonRpcErrorCode` → `{ factory, reason }` for shaping normalized OpenAlex throws.
  * Driven by `httpStatusToErrorCode` so the status-table stays in lockstep with the
@@ -1437,40 +1463,35 @@ class OpenAlexService {
         if (select) {
             queryParams.select = select.join(',');
         }
-        // Sampling overrides per_page — upstream truncates results at per_page even when
-        // sample is larger, which silently drops samples the caller asked for. Aligning the
-        // two means callers get exactly `sample` results in a single page.
+        // `per_page` sizes every page, a sample's included: OpenAlex draws `sample` records and
+        // serves them `per_page` at a time, so a draw larger than one page is walked with `page`.
+        queryParams.per_page = String(params.perPage ?? 25);
         if (params.sample !== undefined) {
             queryParams.sample = String(params.sample);
-            queryParams.per_page = String(params.sample);
             if (params.seed !== undefined)
                 queryParams.seed = params.seed;
         }
-        else {
-            queryParams.per_page = String(params.perPage ?? 25);
-        }
-        // Semantic search doesn't support cursor pagination — OpenAlex answers `search.semantic`
-        // plus a cursor with a 400 — so it walks its candidate set with `page`/`per_page` instead.
-        // Sampling returns one page only, so cursor is mutually exclusive there too. Both
-        // combinations are rejected at the tool layer; the service never sends them together.
-        // The tool also rejects `sample` under semantic mode (OpenAlex ignores it there, and the
-        // population request below would pair `search.semantic` with `cursor=*`) and `sample`
-        // beside `sort` (OpenAlex refuses the pair), so neither reaches this method.
-        if (params.searchMode === 'semantic') {
+        // Semantic search and samples walk with `page` — OpenAlex answers `search.semantic` plus a
+        // cursor with a 400, and pages a seeded draw by number. Every other listing walks by cursor.
+        // The tool rejects `cursor` on either, `sample` under semantic mode (OpenAlex ignores it
+        // there, and the population request below would pair `search.semantic` with `cursor=*`),
+        // `sample` beside `sort` (OpenAlex refuses the pair), and `page` on an unseeded sample or
+        // past the first 10,000 records of one (both 400s upstream), so none reaches this method.
+        if (params.searchMode === 'semantic' || params.sample !== undefined) {
             if (params.page !== undefined)
                 queryParams.page = String(params.page);
         }
-        else if (params.sample === undefined) {
+        else {
             queryParams.cursor = params.cursor ?? '*';
         }
         const searchRequest = this.request(`/${params.entityType}`, queryParams, ctx);
-        // Sampling: OpenAlex returns the sample size in `meta.count`, not the population
-        // matching the filters. The output schema documents `count` as "Total results
-        // matching the query/filters" — issue a parallel per_page=1 lookup without
-        // `sample` to recover the true population and overwrite `count` with it.
+        // Sampling: OpenAlex returns the drawn size, min(sample, population), in `meta.count`, not
+        // the population matching the filters. The output schema documents `count` as "Total
+        // results matching the query/filters" — issue a parallel per_page=1 lookup without the
+        // sample's own parameters to recover the true population and overwrite `count` with it.
         let populationRequest;
         if (params.sample !== undefined) {
-            const { sample: _sample, seed: _seed, ...filterParams } = queryParams;
+            const { sample: _sample, seed: _seed, page: _page, ...filterParams } = queryParams;
             populationRequest = this.request(`/${params.entityType}`, { ...filterParams, per_page: '1', cursor: '*' }, ctx);
         }
         const [data, populationData] = await Promise.all([searchRequest, populationRequest]);
@@ -1518,8 +1539,8 @@ class OpenAlexService {
         if (params.perPage !== undefined) {
             queryParams.per_page = String(params.perPage);
         }
-        // Boolean group_by fields (is_retracted, has_orcid, etc.) only produce
-        // two groups (true/false) and reject cursor pagination with a 400.
+        // Boolean group_by fields (see `isBooleanGroupBy`) only produce two groups (true/false) and
+        // reject cursor pagination with a 400, so they keep count order even under order "key".
         //
         // For all other fields, cursor behaviour follows the sort order:
         //   - count-desc (default): omit cursor on the first page so OpenAlex returns groups