@cyanheads/openalex-mcp-server 0.6.20 → 0.6.21

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

@@ -0,0 +1,660 @@
+{
+  "works": {
+    "filter": [
+      "abstract.search",
+      "abstract.search.exact",
+      "apc_list.currency",
+      "apc_list.provenance",
+      "apc_list.value",
+      "apc_list.value_usd",
+      "apc_paid.currency",
+      "apc_paid.provenance",
+      "apc_paid.value",
+      "apc_paid.value_usd",
+      "author.id",
+      "author.orcid",
+      "authors_count",
+      "authorships.affiliations.institution_ids",
+      "authorships.author.id",
+      "authorships.author.orcid",
+      "authorships.countries",
+      "authorships.institutions.continent",
+      "authorships.institutions.country_code",
+      "authorships.institutions.id",
+      "authorships.institutions.is_global_south",
+      "authorships.institutions.lineage",
+      "authorships.institutions.ror",
+      "authorships.institutions.type",
+      "authorships.is_corresponding",
+      "authorships.raw_orcid",
+      "awards.doi",
+      "awards.funder_award_id",
+      "awards.funder_display_name",
+      "awards.funder_id",
+      "awards.id",
+      "best_oa_location.is_accepted",
+      "best_oa_location.is_oa",
+      "best_oa_location.is_published",
+      "best_oa_location.landing_page_url",
+      "best_oa_location.license",
+      "best_oa_location.license_id",
+      "best_oa_location.raw_type",
+      "best_oa_location.source.host_organization",
+      "best_oa_location.source.host_organization_lineage",
+      "best_oa_location.source.id",
+      "best_oa_location.source.is_in_doaj",
+      "best_oa_location.source.is_oa",
+      "best_oa_location.source.issn",
+      "best_oa_location.source.type",
+      "best_oa_location.version",
+      "best_open_version",
+      "biblio.first_page",
+      "biblio.issue",
+      "biblio.last_page",
+      "biblio.volume",
+      "citation_normalized_percentile.is_in_top_10_percent",
+      "citation_normalized_percentile.is_in_top_1_percent",
+      "citation_normalized_percentile.value",
+      "cited_by",
+      "cited_by_count",
+      "cited_by_percentile_year.max",
+      "cited_by_percentile_year.min",
+      "cites",
+      "collection",
+      "concept.id",
+      "concepts.id",
+      "concepts.wikidata",
+      "concepts_count",
+      "corresponding_author_ids",
+      "corresponding_institution_ids",
+      "countries_distinct_count",
+      "created_date",
+      "datasets",
+      "default.search",
+      "default.search.exact",
+      "display_name",
+      "display_name.search",
+      "display_name.search.exact",
+      "doi",
+      "doi_starts_with",
+      "from_created_date",
+      "from_publication_date",
+      "fulltext.search",
+      "fulltext.search.exact",
+      "fulltext_origin",
+      "funders.id",
+      "fwci",
+      "has_abstract",
+      "has_content.grobid_xml",
+      "has_content.pdf",
+      "has_doi",
+      "has_embeddings",
+      "has_fulltext",
+      "has_oa_accepted_or_published_version",
+      "has_oa_submitted_version",
+      "has_old_authors",
+      "has_orcid",
+      "has_pdf_url",
+      "has_pmcid",
+      "has_pmid",
+      "has_raw_affiliation_strings",
+      "has_references",
+      "ids.mag",
+      "ids.openalex",
+      "ids.pmcid",
+      "ids.pmid",
+      "indexed_in",
+      "institution.id",
+      "institution_assertions.country_code",
+      "institution_assertions.id",
+      "institution_assertions.lineage",
+      "institution_assertions.ror",
+      "institution_assertions.type",
+      "institutions.continent",
+      "institutions.country_code",
+      "institutions.id",
+      "institutions.is_global_south",
+      "institutions.ror",
+      "institutions.type",
+      "institutions_distinct_count",
+      "is_corresponding",
+      "is_oa",
+      "is_paratext",
+      "is_retracted",
+      "is_xpac",
+      "journal",
+      "keyword.search",
+      "keywords.id",
+      "language",
+      "locations.is_accepted",
+      "locations.is_oa",
+      "locations.is_published",
+      "locations.landing_page_url",
+      "locations.license",
+      "locations.license_id",
+      "locations.raw_type",
+      "locations.source.has_issn",
+      "locations.source.host_institution_lineage",
+      "locations.source.host_organization",
+      "locations.source.host_organization_lineage",
+      "locations.source.id",
+      "locations.source.is_core",
+      "locations.source.is_in_doaj",
+      "locations.source.is_oa",
+      "locations.source.issn",
+      "locations.source.publisher_lineage",
+      "locations.source.type",
+      "locations.version",
+      "locations_count",
+      "mag",
+      "mag_only",
+      "oa_status",
+      "open_access.any_repository_has_fulltext",
+      "open_access.is_oa",
+      "open_access.oa_status",
+      "openalex",
+      "openalex_id",
+      "pmcid",
+      "pmid",
+      "primary_location.is_accepted",
+      "primary_location.is_oa",
+      "primary_location.is_published",
+      "primary_location.landing_page_url",
+      "primary_location.license",
+      "primary_location.license_id",
+      "primary_location.raw_type",
+      "primary_location.source.has_issn",
+      "primary_location.source.host_institution_lineage",
+      "primary_location.source.host_organization",
+      "primary_location.source.host_organization_lineage",
+      "primary_location.source.id",
+      "primary_location.source.is_core",
+      "primary_location.source.is_in_doaj",
+      "primary_location.source.is_oa",
+      "primary_location.source.issn",
+      "primary_location.source.publisher_lineage",
+      "primary_location.source.type",
+      "primary_location.version",
+      "primary_topic.domain.id",
+      "primary_topic.field.id",
+      "primary_topic.id",
+      "primary_topic.subfield.id",
+      "publication_date",
+      "publication_year",
+      "raw_affiliation_strings",
+      "raw_affiliation_strings.search",
+      "raw_author_name.search",
+      "referenced_works",
+      "referenced_works_count",
+      "related_to",
+      "repository",
+      "semantic.search",
+      "sustainable_development_goals.id",
+      "sustainable_development_goals.score",
+      "title.search",
+      "title.search.exact",
+      "title_and_abstract.search",
+      "title_and_abstract.search.exact",
+      "to_created_date",
+      "to_publication_date",
+      "to_updated_date",
+      "topics.domain.id",
+      "topics.field.id",
+      "topics.id",
+      "topics.subfield.id",
+      "topics_count",
+      "type",
+      "type_crossref",
+      "updated_date",
+      "version"
+    ],
+    "select": [
+      "id",
+      "doi",
+      "title",
+      "display_name",
+      "relevance_score",
+      "publication_year",
+      "publication_date",
+      "ids",
+      "language",
+      "primary_location",
+      "sources",
+      "type",
+      "type_crossref",
+      "indexed_in",
+      "open_access",
+      "authorships",
+      "institution_assertions",
+      "institutions",
+      "countries_distinct_count",
+      "institutions_distinct_count",
+      "corresponding_author_ids",
+      "corresponding_institution_ids",
+      "apc_list",
+      "apc_paid",
+      "fwci",
+      "is_authors_truncated",
+      "has_fulltext",
+      "fulltext_origin",
+      "cited_by_count",
+      "citation_normalized_percentile",
+      "cited_by_percentile_year",
+      "biblio",
+      "is_retracted",
+      "is_paratext",
+      "is_xpac",
+      "primary_topic",
+      "topics",
+      "keywords",
+      "concepts",
+      "mesh",
+      "locations_count",
+      "locations",
+      "best_oa_location",
+      "sustainable_development_goals",
+      "awards",
+      "funders",
+      "datasets",
+      "versions",
+      "has_content",
+      "content_urls",
+      "referenced_works_count",
+      "referenced_works",
+      "related_works",
+      "abstract_inverted_index",
+      "cited_by_api_url",
+      "counts_by_year",
+      "updated_date",
+      "created_date"
+    ]
+  },
+  "authors": {
+    "filter": [
+      "affiliations.institution.country_code",
+      "affiliations.institution.id",
+      "affiliations.institution.lineage",
+      "affiliations.institution.ror",
+      "affiliations.institution.type",
+      "block_key",
+      "cited_by_count",
+      "collection",
+      "concept.id",
+      "concepts.id",
+      "default.search",
+      "display_name",
+      "display_name.search",
+      "from_created_date",
+      "has_orcid",
+      "id",
+      "ids.openalex",
+      "last_known_institutions.continent",
+      "last_known_institutions.country_code",
+      "last_known_institutions.id",
+      "last_known_institutions.is_global_south",
+      "last_known_institutions.lineage",
+      "last_known_institutions.ror",
+      "last_known_institutions.type",
+      "openalex",
+      "openalex_id",
+      "orcid",
+      "parsed_longest_name.first",
+      "parsed_longest_name.last",
+      "parsed_longest_name.middle",
+      "parsed_longest_name.suffix",
+      "scopus",
+      "summary_stats.2yr_mean_citedness",
+      "summary_stats.h_index",
+      "summary_stats.i10_index",
+      "to_created_date",
+      "to_updated_date",
+      "topic_share.id",
+      "topics.id",
+      "works_count",
+      "x_concepts.id"
+    ],
+    "select": [
+      "id",
+      "orcid",
+      "display_name",
+      "raw_author_names",
+      "full_name",
+      "relevance_score",
+      "works_count",
+      "cited_by_count",
+      "summary_stats",
+      "ids",
+      "affiliations",
+      "last_known_institutions",
+      "topics",
+      "topic_share",
+      "x_concepts",
+      "counts_by_year",
+      "display_name_alternatives",
+      "block_key",
+      "works_api_url",
+      "updated_date",
+      "created_date"
+    ]
+  },
+  "sources": {
+    "filter": [
+      "apc_prices.currency",
+      "apc_prices.price",
+      "apc_usd",
+      "cited_by_count",
+      "collection",
+      "concept.id",
+      "concepts.id",
+      "continent",
+      "country_code",
+      "default.search",
+      "display_name",
+      "display_name.search",
+      "first_publication_year",
+      "from_created_date",
+      "has_issn",
+      "host_organization",
+      "host_organization.id",
+      "host_organization_lineage",
+      "ids.mag",
+      "ids.openalex",
+      "is_core",
+      "is_global_south",
+      "is_high_oa_rate",
+      "is_high_oa_rate_since_year",
+      "is_in_doaj",
+      "is_in_doaj_since_year",
+      "is_in_jstage",
+      "is_in_jstage_since_year",
+      "is_oa",
+      "is_ojs",
+      "issn",
+      "issn_l",
+      "last_publication_year",
+      "oa_flip_year",
+      "openalex",
+      "openalex_id",
+      "summary_stats.2yr_mean_citedness",
+      "summary_stats.h_index",
+      "summary_stats.i10_index",
+      "to_created_date",
+      "to_updated_date",
+      "topic_share.id",
+      "topics.id",
+      "type",
+      "works_count",
+      "x_concepts.id"
+    ],
+    "select": [
+      "id",
+      "issn_l",
+      "issn",
+      "display_name",
+      "host_organization",
+      "host_organization_name",
+      "host_organization_lineage",
+      "relevance_score",
+      "works_count",
+      "oa_works_count",
+      "cited_by_count",
+      "summary_stats",
+      "is_oa",
+      "is_in_doaj",
+      "is_in_doaj_since_year",
+      "is_high_oa_rate",
+      "is_high_oa_rate_since_year",
+      "is_in_jstage",
+      "is_in_jstage_since_year",
+      "is_in_scielo",
+      "is_ojs",
+      "is_indexed_in_scopus",
+      "is_core",
+      "oa_flip_year",
+      "first_publication_year",
+      "last_publication_year",
+      "ids",
+      "homepage_url",
+      "apc_prices",
+      "apc_usd",
+      "country",
+      "country_code",
+      "societies",
+      "alternate_titles",
+      "abbreviated_title",
+      "type",
+      "topics",
+      "topic_share",
+      "x_concepts",
+      "counts_by_year",
+      "works_api_url",
+      "updated_date",
+      "created_date"
+    ]
+  },
+  "institutions": {
+    "filter": [
+      "cited_by_count",
+      "collection",
+      "concept.id",
+      "concepts.id",
+      "continent",
+      "country_code",
+      "default.search",
+      "display_name",
+      "display_name.search",
+      "from_created_date",
+      "has_ror",
+      "id",
+      "ids.openalex",
+      "is_global_south",
+      "is_super_system",
+      "lineage",
+      "openalex",
+      "openalex_id",
+      "repositories.host_organization",
+      "repositories.host_organization_lineage",
+      "repositories.id",
+      "roles.id",
+      "ror",
+      "status",
+      "summary_stats.2yr_mean_citedness",
+      "summary_stats.h_index",
+      "summary_stats.i10_index",
+      "topic_share.id",
+      "topics.id",
+      "type",
+      "works_count",
+      "x_concepts.id"
+    ],
+    "select": [
+      "id",
+      "ror",
+      "display_name",
+      "relevance_score",
+      "country_code",
+      "type",
+      "type_id",
+      "lineage",
+      "homepage_url",
+      "image_url",
+      "image_thumbnail_url",
+      "display_name_acronyms",
+      "display_name_alternatives",
+      "repositories",
+      "works_count",
+      "cited_by_count",
+      "summary_stats",
+      "ids",
+      "geo",
+      "international",
+      "associated_institutions",
+      "counts_by_year",
+      "roles",
+      "topics",
+      "topic_share",
+      "x_concepts",
+      "is_super_system",
+      "status",
+      "works_api_url",
+      "updated_date",
+      "created_date"
+    ]
+  },
+  "topics": {
+    "filter": [
+      "cited_by_count",
+      "collection",
+      "default.search",
+      "description.search",
+      "display_name",
+      "display_name.search",
+      "domain.id",
+      "field.id",
+      "from_created_date",
+      "id",
+      "ids.openalex",
+      "keywords.search",
+      "openalex",
+      "subfield.id",
+      "works_count"
+    ],
+    "select": [
+      "id",
+      "display_name",
+      "description",
+      "keywords",
+      "ids",
+      "subfield",
+      "field",
+      "domain",
+      "siblings",
+      "relevance_score",
+      "works_count",
+      "cited_by_count",
+      "works_api_url",
+      "updated_date",
+      "created_date"
+    ]
+  },
+  "keywords": {
+    "filter": [
+      "cited_by_count",
+      "collection",
+      "default.search",
+      "display_name",
+      "display_name.search",
+      "from_created_date",
+      "id",
+      "works_count"
+    ],
+    "select": [
+      "id",
+      "display_name",
+      "relevance_score",
+      "works_count",
+      "cited_by_count",
+      "works_api_url",
+      "updated_date",
+      "created_date"
+    ]
+  },
+  "publishers": {
+    "filter": [
+      "cited_by_count",
+      "collection",
+      "continent",
+      "country_codes",
+      "default.search",
+      "display_name",
+      "display_name.search",
+      "from_created_date",
+      "hierarchy_level",
+      "ids.openalex",
+      "ids.ror",
+      "ids.wikidata",
+      "lineage",
+      "openalex",
+      "openalex_id",
+      "parent_publisher",
+      "roles.id",
+      "ror",
+      "summary_stats.2yr_mean_citedness",
+      "summary_stats.h_index",
+      "summary_stats.i10_index",
+      "wikidata",
+      "works_count"
+    ],
+    "select": [
+      "id",
+      "display_name",
+      "alternate_titles",
+      "hierarchy_level",
+      "parent_publisher",
+      "lineage",
+      "relevance_score",
+      "country_codes",
+      "homepage_url",
+      "image_url",
+      "image_thumbnail_url",
+      "works_count",
+      "cited_by_count",
+      "summary_stats",
+      "ids",
+      "counts_by_year",
+      "roles",
+      "sources_api_url",
+      "updated_date",
+      "created_date"
+    ]
+  },
+  "funders": {
+    "filter": [
+      "awards_count",
+      "cited_by_count",
+      "collection",
+      "continent",
+      "country_code",
+      "default.search",
+      "description.search",
+      "display_name",
+      "display_name.search",
+      "from_created_date",
+      "ids.crossref",
+      "ids.doi",
+      "ids.openalex",
+      "ids.ror",
+      "ids.wikidata",
+      "is_global_south",
+      "openalex",
+      "openalex_id",
+      "roles.id",
+      "ror",
+      "summary_stats.2yr_mean_citedness",
+      "summary_stats.h_index",
+      "summary_stats.i10_index",
+      "wikidata",
+      "works_count"
+    ],
+    "select": [
+      "id",
+      "display_name",
+      "alternate_titles",
+      "country_code",
+      "description",
+      "homepage_url",
+      "image_url",
+      "image_thumbnail_url",
+      "relevance_score",
+      "awards_count",
+      "works_count",
+      "cited_by_count",
+      "summary_stats",
+      "ids",
+      "counts_by_year",
+      "roles",
+      "updated_date",
+      "created_date"
+    ]
+  }
+}

package/dist/services/openalex/field-ranker.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Field name ranking for ranked invalid-field suggestions.
+ *
+ * Blends token-set overlap (split on `.`/`_`) with Jaro-Winkler similarity.
+ * Zero dependencies. Designed for short structured identifiers like OpenAlex
+ * field names — not document-search use cases.
+ *
+ * @module services/openalex/field-ranker
+ */
+/**
+ * Return the top-N candidate field names from `pool` ranked by similarity
+ * to `query`. Results are ordered by score descending.
+ *
+ * @param query - The rejected field name submitted by the caller.
+ * @param pool - All valid field names for this entity_type + context.
+ * @param topN - Maximum number of suggestions to return. Default 5.
+ */
+export declare function rankFields(query: string, pool: string[], topN?: number): string[];
+//# sourceMappingURL=field-ranker.d.ts.map

package/dist/services/openalex/field-ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-ranker.d.ts","sourceRoot":"","sources":["../../../src/services/openalex/field-ranker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoFH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,SAAI,GAAG,MAAM,EAAE,CAS5E"}