@cyanheads/pubmed-mcp-server 2.9.9 → 2.10.0

package/AGENTS.md

@@ -1,7 +1,7 @@
 # Agent Protocol
 
 **Server:** @cyanheads/pubmed-mcp-server
-**Version:** 2.9.9
+**Version:** 2.10.0
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.11.0`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 
@@ -246,7 +246,7 @@ src/
       parsing/                          # XML parsers (article, esummary, PMC)
       formatting/                       # Citation formatter (APA, MLA, BibTeX, RIS)
   mcp-server/
-    tools/definitions/                  # 9 tool definitions (*.tool.ts)
+    tools/definitions/                  # 11 tool definitions (*.tool.ts)
     resources/definitions/              # database-info.resource.ts
     prompts/definitions/                # research-plan.prompt.ts
 ```

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # Agent Protocol
 
 **Server:** @cyanheads/pubmed-mcp-server
-**Version:** 2.9.9
+**Version:** 2.10.0
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.11.0`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 
@@ -246,7 +246,7 @@ src/
       parsing/                          # XML parsers (article, esummary, PMC)
       formatting/                       # Citation formatter (APA, MLA, BibTeX, RIS)
   mcp-server/
-    tools/definitions/                  # 9 tool definitions (*.tool.ts)
+    tools/definitions/                  # 11 tool definitions (*.tool.ts)
     resources/definitions/              # database-info.resource.ts
     prompts/definitions/                # research-plan.prompt.ts
 ```

package/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <h1>@cyanheads/pubmed-mcp-server</h1>
   <p><b>Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms via MCP. STDIO or Streamable HTTP.</b>
-  <div>10 Tools • 1 Resource • 1 Prompt</div>
+  <div>11 Tools • 1 Resource • 1 Prompt</div>
   </p>
 </div>
 
@@ -9,7 +9,7 @@
 
 
 
-[![Version](https://img.shields.io/badge/Version-2.9.9-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/pubmed-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/pubmed-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/pubmed-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.14-blueviolet.svg?style=flat-square)](https://bun.sh/)
+[![Version](https://img.shields.io/badge/Version-2.10.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/pubmed-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/pubmed-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/pubmed-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.14-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 
@@ -31,12 +31,13 @@
 
 ## Tools
 
-10 tools for working with PubMed, PubMed Central, and Europe PMC data:
+11 tools for working with PubMed, PubMed Central, and Europe PMC data:
 
 | Tool | Description |
 |:---|:---|
 | `pubmed_search_articles` | Search PubMed with full query syntax, field-specific filters, date ranges, pagination, and optional brief summaries |
 | `pubmed_europepmc_search` | Search Europe PMC for preprints, patents, Agricola, and EPMC-only OA records that don't surface in PubMed. Cursor-based pagination. |
+| `pubmed_europepmc_fetch` | Fetch complete Europe PMC records — including the untruncated abstract — by `source` + `epmcId`, the only identifier many preprint, patent, and Agricola records carry |
 | `pubmed_fetch_articles` | Fetch full article metadata by PMIDs — abstract, authors, journal, MeSH terms, grants |
 | `pubmed_fetch_fulltext` | Fetch full-text articles via a chain: NCBI PMC EFetch → Europe PMC `fullTextXML` → Unpaywall. Accepts PMIDs, PMCIDs, or DOIs. |
 | `pubmed_format_citations` | Generate formatted citations in APA 7th, MLA 9th, BibTeX, RIS, or Vancouver (ICMJE/NLM) |
@@ -86,6 +87,7 @@ Fetch full-text articles via a three-stage chain: NCBI PMC EFetch → Europe PMC
 - Structured unavailable reasons (`not-found`, `no-pmc-fallback-disabled`, `no-epmc-fulltext`, `no-doi`, `no-oa`, `fetch-failed`, `parse-failed`, `service-error`) so callers can retry or explain to users without parsing text
 - Each `unavailable` entry carries `idType` (`pmid` / `pmcid` / `doi`) and `triedTiers` — per-tier outcomes (`not-attempted`, `miss`, `no-fulltext`, `service-error`, …) in execution order, so callers can see which stage failed and why
 - Section filtering by title (case-insensitive match, e.g. `["methods", "results"]`) and configurable max sections apply to PMC output
+- Character budgets keep context size predictable: `maxCharacters` caps body text per article (PMC sections and subsections, or the Unpaywall body), `maxCharactersPerSection` caps a single PMC section, and `overflowMode` picks between `truncate` (fill sections in document order) and `outline` (split the budget evenly so every heading survives with an excerpt). Budgets run after the semantic filters, and a `truncation` object reports per-article and per-section character counts whenever anything was shortened
 - Up to 10 articles per request
 
 ---
@@ -98,6 +100,19 @@ Search Europe PMC (EBI/EMBL-EBI), a broader open-access biomedical corpus than P
 - Default sources `["MED", "PMC", "PPR"]`; pass `sources` to include `PAT` / `AGR`
 - Cursor-based pagination via `cursorMark` (unlike `pubmed_search_articles`, which uses offset) — `*` for the first page, return `nextCursorMark` for the next
 - Output discriminator on `source` plus optional `pmid` / `pmcId` / `doi` cross-walking
+- `abstractSnippet` is capped at 400 characters to keep a page bounded; `abstractTruncated` says whether it was cut, and `pubmed_europepmc_fetch` returns the whole abstract for the records worth reading in full
+- Disabled when `EUROPEPMC_ENABLED=false`; tool is not registered in that case
+
+---
+
+### `pubmed_europepmc_fetch`
+
+Fetch complete Europe PMC records by `source` + `epmcId`, the detail counterpart to `pubmed_europepmc_search`.
+
+- Returns the full, untruncated abstract as display-ready plain text — markup stripped, HTML entities decoded
+- Addressed by the `source` and `epmcId` of a search hit, the only identifier preprint (`PPR`), patent (`PAT`), and Agricola (`AGR`) records reliably carry — `pubmed_fetch_articles` needs a PMID and `pubmed_fetch_fulltext` needs a PMCID, PMID, or DOI
+- Up to 25 records per call, resolved in a single Europe PMC request
+- Pairs unresolved requests back to the caller in `notFound` instead of failing the batch
 - Disabled when `EUROPEPMC_ENABLED=false`; tool is not registered in that case
 
 ---
@@ -355,7 +370,7 @@ All configuration is validated at startup via Zod schemas in `src/config/server-
 
 | Directory | Purpose |
 |:---|:---|
-| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Ten tools across PubMed, PMC, and Europe PMC. |
+| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Eleven tools across PubMed, PMC, and Europe PMC. |
 | `src/mcp-server/resources` | Resource definitions. Database info resource. |
 | `src/mcp-server/prompts` | Prompt definitions. Research plan prompt. |
 | `src/services/ncbi` | NCBI E-utilities service layer — API client, queue, parser, formatter. |

package/dist/index.js

@@ -14,6 +14,7 @@ import { findRelatedTool } from './mcp-server/tools/definitions/find-related.too
 import { formatCitationsTool } from './mcp-server/tools/definitions/format-citations.tool.js';
 import { lookupCitationTool } from './mcp-server/tools/definitions/lookup-citation.tool.js';
 import { lookupMeshTool } from './mcp-server/tools/definitions/lookup-mesh.tool.js';
+import { pubmedEuropepmcFetchTool } from './mcp-server/tools/definitions/pubmed-europepmc-fetch.tool.js';
 import { pubmedEuropepmcSearchTool } from './mcp-server/tools/definitions/pubmed-europepmc-search.tool.js';
 import { searchArticlesTool } from './mcp-server/tools/definitions/search-articles.tool.js';
 import { spellCheckTool } from './mcp-server/tools/definitions/spell-check.tool.js';
@@ -32,7 +33,7 @@ const tools = [
     lookupMeshTool,
     lookupCitationTool,
     convertIdsTool,
-    ...(config.europepmcEnabled ? [pubmedEuropepmcSearchTool] : []),
+    ...(config.europepmcEnabled ? [pubmedEuropepmcSearchTool, pubmedEuropepmcFetchTool] : []),
 ];
 await createApp({
     name: 'pubmed-mcp-server',
@@ -40,7 +41,7 @@ await createApp({
     tools,
     resources: [databaseInfoResource],
     prompts: [researchPlanPrompt],
-    instructions: "Use the pubmed_* tools to search PubMed and PubMed Central, fetch article metadata and full text, format citations, and find related articles via NCBI's E-utilities. Articles are keyed by PMID (integer); PMC full text by PMCID (`PMC` prefix); most also carry a DOI. Typical flow: `pubmed_search_articles` → `pubmed_fetch_articles` → `pubmed_fetch_fulltext`. When PubMed itself comes up empty (preprints, EPMC-only OA), broaden via `pubmed_europepmc_search`. Prefer deterministic resolvers when inputs are structured: `pubmed_lookup_citation` for partial references, `pubmed_convert_ids` to crosswalk IDs. Refine queries with `pubmed_lookup_mesh` and `pubmed_spell_check`.",
+    instructions: "Use the pubmed_* tools to search PubMed and PubMed Central, fetch article metadata and full text, format citations, and find related articles via NCBI's E-utilities. Articles are keyed by PMID (integer); PMC full text by PMCID (`PMC` prefix); most also carry a DOI. Typical flow: `pubmed_search_articles` → `pubmed_fetch_articles` → `pubmed_fetch_fulltext`. When PubMed itself comes up empty (preprints, EPMC-only OA), broaden via `pubmed_europepmc_search`, then `pubmed_europepmc_fetch` with a hit's `source` + `epmcId` for its complete abstract. Prefer deterministic resolvers when inputs are structured: `pubmed_lookup_citation` for partial references, `pubmed_convert_ids` to crosswalk IDs. Refine queries with `pubmed_lookup_mesh` and `pubmed_spell_check`.",
     landing: {
         requireAuth: false,
         tagline: 'Search PubMed, fetch articles, generate citations, explore MeSH terms, and discover related research.',

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yDAAyD,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;AACjC,MAAM,KAAK,GAAG;IACZ,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,cAAc;IACd,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CAChE,CAAC;AAEF,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,mBAAmB;IAC1B,KAAK;IACL,SAAS,EAAE,CAAC,oBAAoB,CAAC;IACjC,OAAO,EAAE,CAAC,kBAAkB,CAAC;IAC7B,YAAY,EACV,iqBAAiqB;IACnqB,OAAO,EAAE;QACP,WAAW,EAAE,KAAK;QAClB,OAAO,EACL,uGAAuG;QACzG,QAAQ,EAAE,gDAAgD;QAC1D,KAAK,EAAE;YACL,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,kCAAkC,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC7E;gBACE,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,8CAA8C;gBACpD,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,KAAK,EAAE,qBAAqB;gBAC5B,IAAI,EAAE,gDAAgD;gBACtD,QAAQ,EAAE,IAAI;aACf;YACD,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,4BAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC9E;QACD,UAAU,EAAE;YACV,YAAY,EAAE,mBAAmB;YACjC,gBAAgB,EAAE,iBAAiB;YACnC,eAAe,EAAE,iBAAiB;SACnC;KACF;IACD,KAAK;QACH,eAAe,EAAE,CAAC;QAClB,oBAAoB,EAAE,CAAC;QACvB,oBAAoB,EAAE,CAAC;QACvB,mBAAmB,EAAE,CAAC;IACxB,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yDAAyD,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+DAA+D,CAAC;AACzG,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;AACjC,MAAM,KAAK,GAAG;IACZ,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,cAAc;IACd,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,yBAAyB,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CAC1F,CAAC;AAEF,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,mBAAmB;IAC1B,KAAK;IACL,SAAS,EAAE,CAAC,oBAAoB,CAAC;IACjC,OAAO,EAAE,CAAC,kBAAkB,CAAC;IAC7B,YAAY,EACV,2vBAA2vB;IAC7vB,OAAO,EAAE;QACP,WAAW,EAAE,KAAK;QAClB,OAAO,EACL,uGAAuG;QACzG,QAAQ,EAAE,gDAAgD;QAC1D,KAAK,EAAE;YACL,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,kCAAkC,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC7E;gBACE,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,8CAA8C;gBACpD,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,KAAK,EAAE,qBAAqB;gBAC5B,IAAI,EAAE,gDAAgD;gBACtD,QAAQ,EAAE,IAAI;aACf;YACD,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,4BAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC9E;QACD,UAAU,EAAE;YACV,YAAY,EAAE,mBAAmB;YACjC,gBAAgB,EAAE,iBAAiB;YACnC,eAAe,EAAE,iBAAiB;SACnC;KACF;IACD,KAAK;QACH,eAAe,EAAE,CAAC;QAClB,oBAAoB,EAAE,CAAC;QACvB,oBAAoB,EAAE,CAAC;QACvB,mBAAmB,EAAE,CAAC;IACxB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/_text.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Text-cutting helper shared by the tool definitions that bound
+ * returned text to a character budget.
+ * @module src/mcp-server/tools/definitions/_text
+ */
+/**
+ * Take at most `limit` UTF-16 code units from `text` without splitting a
+ * surrogate pair.
+ *
+ * `String.prototype.slice` cuts on a code-unit boundary, so a cut landing
+ * between the high and low half of an astral character — emoji, mathematical
+ * alphanumerics, CJK extensions — leaves a lone surrogate. It survives
+ * `JSON.stringify` as `\ud83e` and transports fine, then renders as U+FFFD once
+ * a client decodes it, and the string fails `String.prototype.isWellFormed()`.
+ *
+ * `limit` stays a ceiling: when the boundary would land mid-pair it backs off by
+ * one code unit, so the result can come back one unit short of the allowance.
+ * Callers that report character counts must measure the returned string rather
+ * than assume the allowance was spent exactly. (#93)
+ */
+export declare function sliceCodeUnits(text: string, limit: number): string;
+//# sourceMappingURL=_text.d.ts.map

package/dist/mcp-server/tools/definitions/_text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_text.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlE"}

package/dist/mcp-server/tools/definitions/_text.js

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Text-cutting helper shared by the tool definitions that bound
+ * returned text to a character budget.
+ * @module src/mcp-server/tools/definitions/_text
+ */
+const HIGH_SURROGATE_FIRST = 0xd800;
+const HIGH_SURROGATE_LAST = 0xdbff;
+/**
+ * Take at most `limit` UTF-16 code units from `text` without splitting a
+ * surrogate pair.
+ *
+ * `String.prototype.slice` cuts on a code-unit boundary, so a cut landing
+ * between the high and low half of an astral character — emoji, mathematical
+ * alphanumerics, CJK extensions — leaves a lone surrogate. It survives
+ * `JSON.stringify` as `\ud83e` and transports fine, then renders as U+FFFD once
+ * a client decodes it, and the string fails `String.prototype.isWellFormed()`.
+ *
+ * `limit` stays a ceiling: when the boundary would land mid-pair it backs off by
+ * one code unit, so the result can come back one unit short of the allowance.
+ * Callers that report character counts must measure the returned string rather
+ * than assume the allowance was spent exactly. (#93)
+ */
+export function sliceCodeUnits(text, limit) {
+    if (limit <= 0)
+        return '';
+    if (limit >= text.length)
+        return text;
+    const last = text.charCodeAt(limit - 1);
+    const splitsPair = last >= HIGH_SURROGATE_FIRST && last <= HIGH_SURROGATE_LAST;
+    return text.slice(0, splitsPair ? limit - 1 : limit);
+}
+//# sourceMappingURL=_text.js.map

package/dist/mcp-server/tools/definitions/_text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_text.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa;IACxD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,IAAI,oBAAoB,IAAI,IAAI,IAAI,mBAAmB,CAAC;IAC/E,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC"}

package/dist/mcp-server/tools/definitions/fetch-fulltext.tool.d.ts

@@ -36,6 +36,12 @@ export declare const fetchFulltextTool: import("@cyanheads/mcp-ts-core").ToolDef
     includeReferences: z.ZodDefault<z.ZodBoolean>;
     maxSections: z.ZodOptional<z.ZodNumber>;
     sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxCharacters: z.ZodOptional<z.ZodNumber>;
+    maxCharactersPerSection: z.ZodOptional<z.ZodNumber>;
+    overflowMode: z.ZodDefault<z.ZodEnum<{
+        outline: "outline";
+        truncate: "truncate";
+    }>>;
 }, z.core.$strip>, z.ZodObject<{
     articles: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         source: z.ZodLiteral<"pmc">;
@@ -94,6 +100,7 @@ export declare const fetchFulltextTool: import("@cyanheads/mcp-ts-core").ToolDef
             "html-markdown": "html-markdown";
             "pdf-text": "pdf-text";
         }>;
+        pmcId: z.ZodOptional<z.ZodString>;
         pmid: z.ZodOptional<z.ZodString>;
         pubmedUrl: z.ZodOptional<z.ZodString>;
         doi: z.ZodString;
@@ -116,6 +123,7 @@ export declare const fetchFulltextTool: import("@cyanheads/mcp-ts-core").ToolDef
         }>;
         reason: z.ZodEnum<{
             "fetch-failed": "fetch-failed";
+            "no-body": "no-body";
             "no-doi": "no-doi";
             "no-epmc-fulltext": "no-epmc-fulltext";
             "no-oa": "no-oa";
@@ -133,6 +141,7 @@ export declare const fetchFulltextTool: import("@cyanheads/mcp-ts-core").ToolDef
             outcome: z.ZodEnum<{
                 "fetch-failed": "fetch-failed";
                 miss: "miss";
+                "no-body": "no-body";
                 "no-doi": "no-doi";
                 "no-fulltext": "no-fulltext";
                 "no-oa": "no-oa";
@@ -143,6 +152,32 @@ export declare const fetchFulltextTool: import("@cyanheads/mcp-ts-core").ToolDef
             detail: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    truncation: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<{
+            outline: "outline";
+            truncate: "truncate";
+        }>;
+        maxCharacters: z.ZodOptional<z.ZodNumber>;
+        maxCharactersPerSection: z.ZodOptional<z.ZodNumber>;
+        originalCharacters: z.ZodNumber;
+        returnedCharacters: z.ZodNumber;
+        omittedSections: z.ZodNumber;
+        articles: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                pmc: "pmc";
+                unpaywall: "unpaywall";
+            }>;
+            originalCharacters: z.ZodNumber;
+            returnedCharacters: z.ZodNumber;
+            sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                originalCharacters: z.ZodNumber;
+                returnedCharacters: z.ZodNumber;
+                truncated: z.ZodBoolean;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>, readonly [{
     readonly reason: 'queue_full';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;

package/dist/mcp-server/tools/definitions/fetch-fulltext.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-fulltext.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fetch-fulltext.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAsB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA8T/D;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CA+BT;AAID,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuhB5B,CAAC"}
+{"version":3,"file":"fetch-fulltext.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fetch-fulltext.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAsB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAmoB/D;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CA+BT;AAID,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2rB5B,CAAC"}