paper-search-cli 0.3.0 → 0.3.2

package/README.md

@@ -2,13 +2,13 @@
 
 [简体中文](README.zh.md) | English
 
-Paper Search CLI is an agent-facing Skill + CLI package built on a standalone Node.js command line tool for academic literature work. It gives AI agents, terminal users, and scripts one reproducible command layer with agent-friendly JSON output for literature metadata search, journal metrics lookup, PDF discovery/download, and paper body snippet search.
+Paper Search CLI is an agent-facing Skill + CLI package built on a standalone Node.js command line tool for academic literature work. It gives AI agents, terminal users, and scripts one reproducible command layer with agent-friendly JSON output for literature metadata search, citation expansion, journal metrics lookup, PDF discovery/download, and paper body snippet search.
 
 ![Node.js](https://img.shields.io/badge/node.js->=18.0.0-green.svg)
 ![TypeScript](https://img.shields.io/badge/typescript-^5.5.3-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
 ![Platforms](https://img.shields.io/badge/platforms-25-brightgreen.svg)
-![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)
+![Version](https://img.shields.io/badge/version-0.3.2-blue.svg)
 [![LinuxDo](https://img.shields.io/badge/LinuxDo-community-1f6feb)](https://linux.do)
 
 [Quick Start](#quick-start) | [Architecture](#architecture) | [Configuration](#configuration) | [Agent Skill](#agent-skill) | [Supported Platforms](#supported-platforms) | [Commands](#commands) | [Troubleshooting](#troubleshooting)
@@ -18,6 +18,7 @@ Paper Search CLI is an agent-facing Skill + CLI package built on a standalone No
 | Workflow | Primary commands | What it returns |
 | --- | --- | --- |
 | Literature metadata search | `paper-search search`, `paper-search run search_*` | Paper title, authors, year, journal, DOI, PMID/PMCID, arXiv ID, URL, abstract, and source metadata |
+| Citation expansion | `paper-search run get_paper_citations`, `paper-search run get_paper_references` | Citing papers and cited references for a known Semantic Scholar paper ID, DOI, or arXiv ID |
 | Journal metrics lookup | `paper-search journal-metrics`, `paper-search run query_journal_metrics` | Impact factor, 5-year IF, JCR/SSCI quartile, CAS zone, JCI, ESI, warning flags, and rank fields |
 | PDF discovery and download | `paper-search download`, `paper-search run download_with_fallback` | Verified PDF download paths through native sources, open access, configured entitlement, and Sci-Hub fallback when enabled |
 | Body snippet search | `paper-search run search_semantic_snippets` | Semantic Scholar Open Access body snippets for methods, parameters, and wording clues |
@@ -28,11 +29,11 @@ Paper Search CLI is an agent-facing Skill + CLI package built on a standalone No
 
 | Layer | Responsibility |
 | --- | --- |
-| CLI package body | Executes literature search, journal metrics lookup, PDF discovery/download, body snippet search, and stable JSON output |
+| CLI package body | Executes literature search, citation expansion, journal metrics lookup, PDF discovery/download, body snippet search, and stable JSON output |
 | Bundled Skill | Ships `skills/paper-search` with agent routing rules and focused references; it does not store API keys, cookies, or account credentials |
-| Friendly Management Layer | Provides `doctor`, `smoke`, `skills`, `config`, and `tools` around the four main capabilities: `metadata_search`, `journal_metrics`, `pdf_discovery`, and `body_snippet_search`. `doctor` health reports include masked configuration, Capability Profile, platform/source status, and missing or degraded items; `smoke` checks command wiring and live readiness; `skills` syncs the bundled Skill |
+| Friendly Management Layer | Provides `doctor`, `smoke`, `skills`, `config`, and `tools` around the five main capabilities: `metadata_search`, `citation_expansion`, `journal_metrics`, `pdf_discovery`, and `body_snippet_search`. `doctor` health reports include masked configuration, Capability Profile, platform/source status, and missing or degraded items; `smoke` checks command wiring and live readiness; `skills` syncs the bundled Skill |
 
-The four main capabilities are executed by the CLI package body and reported by the management layer. The Capability Profile also reports `entitled_access` so users can see whether publisher API keys, database keys, TDM tokens, or institutional entitlements are configured. Missing or degraded configuration for one workflow does not make unrelated workflows unavailable.
+The five main capabilities are executed by the CLI package body and reported by the management layer. The Capability Profile also reports `entitled_access` so users can see whether publisher API keys, database keys, TDM tokens, or institutional entitlements are configured. Missing or degraded configuration for one workflow does not make unrelated workflows unavailable.
 
 ## Quick Start
 
@@ -44,13 +45,14 @@ paper-search setup
 paper-search doctor --pretty
 ```
 
-Try the four main workflows:
+Try the five main workflows:
 
 ```bash
 paper-search search "machine learning clinical prediction" --platform crossref --max-results 3 --pretty
+paper-search run get_paper_citations --arg doi="10.1038/nature12373" --arg limit=5 --pretty
 paper-search journal-metrics "Nature" "BMJ" --pretty
 paper-search download 10.48550/arxiv.1201.0490 --platform arxiv --save-path ./downloads
-paper-search run search_semantic_snippets --arg query="propensity score matching" --arg maxResults=3 --pretty
+paper-search run search_semantic_snippets --arg query="propensity score matching" --arg limit=3 --pretty
 ```
 
 Useful checks:
@@ -87,7 +89,7 @@ The quick group table helps choose a source family. The capability matrix below
 | --- | --- | --- | --- | --- | --- | --- |
 | Crossref | ✅ Yes | ❌ No | ❌ No | ✅ Yes | ❌ None | Default broad metadata source |
 | OpenAlex | ✅ Yes | 🟡 Conditional | ❌ No | ✅ Yes | ❌ None | Free metadata; OA links can help PDF fallback |
-| Semantic Scholar | ✅ Yes | 🟡 Conditional | ✅ Body snippets | ✅ Yes | 🟡 Optional; snippets require `SEMANTIC_SCHOLAR_API_KEY` | Good for AI/CS and body snippet clues |
+| Semantic Scholar | ✅ Yes | 🟡 Conditional | ✅ Body snippets | ✅ Yes | 🟡 Optional; snippets require `SEMANTIC_SCHOLAR_API_KEY` | Good for AI/CS, citation expansion, and body snippet clues |
 | Google Scholar | ✅ Yes | ❌ No | ❌ No | ✅ Yes | ❌ None | Broad discovery through page parsing |
 
 #### Journal Metrics
@@ -205,7 +207,7 @@ Useful key dashboards:
 
 ## Agent Skill
 
-The npm package ships a bundled agent Skill at `skills/paper-search/SKILL.md`. Terminal users can use the CLI directly; AI agent workflows should install or sync the Skill so the agent can route the four main workflows correctly.
+The npm package ships a bundled agent Skill at `skills/paper-search/SKILL.md`. Terminal users can use the CLI directly; AI agent workflows should install or sync the Skill so the agent can route the five main workflows correctly.
 
 ```bash
 paper-search setup --install-skills agents

package/README.zh.md

@@ -2,13 +2,13 @@
 
 简体中文 | [English](README.md)
 
-Paper Search CLI 是一个面向 AI agent 的 Skill + CLI 包，基于独立的 Node.js 命令行工具构建，用于学术文献工作。它为 AI agent、终端用户和脚本提供一个可复现的命令层，并通过 agent 友好的 JSON 输出覆盖文献元数据检索、期刊指标检索、PDF 获取/下载和论文正文片段检索。
+Paper Search CLI 是一个面向 AI agent 的 Skill + CLI 包，基于独立的 Node.js 命令行工具构建，用于学术文献工作。它为 AI agent、终端用户和脚本提供一个可复现的命令层，并通过 agent 友好的 JSON 输出覆盖文献元数据检索、施引/参考文献扩展、期刊指标检索、PDF 获取/下载和论文正文片段检索。
 
 ![Node.js](https://img.shields.io/badge/node.js->=18.0.0-green.svg)
 ![TypeScript](https://img.shields.io/badge/typescript-^5.5.3-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
 ![Platforms](https://img.shields.io/badge/platforms-25-brightgreen.svg)
-![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)
+![Version](https://img.shields.io/badge/version-0.3.2-blue.svg)
 [![LinuxDo](https://img.shields.io/badge/LinuxDo-community-1f6feb)](https://linux.do)
 
 [快速开始](#快速开始) | [架构说明](#架构说明) | [配置](#配置) | [Agent Skill](#agent-skill) | [支持平台](#支持平台) | [命令](#命令) | [排障](#排障)
@@ -18,6 +18,7 @@ Paper Search CLI 是一个面向 AI agent 的 Skill + CLI 包，基于独立的
 | 功能 | 主要命令 | 返回内容 |
 | --- | --- | --- |
 | 文献元数据检索 | `paper-search search`, `paper-search run search_*` | 题名、作者、年份、期刊、DOI、PMID/PMCID、arXiv ID、URL、摘要和来源元数据 |
+| 引文扩展 | `paper-search run get_paper_citations`, `paper-search run get_paper_references` | 已知 Semantic Scholar paper ID、DOI 或 arXiv ID 对应论文的施引文献和参考文献 |
 | 期刊指标检索 | `paper-search journal-metrics`, `paper-search run query_journal_metrics` | 影响因子、5 年 IF、JCR/SSCI 分区、中科院分区、JCI、ESI、预警和等级字段 |
 | PDF 获取和下载 | `paper-search download`, `paper-search run download_with_fallback` | 通过原生来源、开放获取、已配置权限来源和启用时的 Sci-Hub fallback 获取 PDF |
 | 正文片段检索 | `paper-search run search_semantic_snippets` | Semantic Scholar Open Access 正文片段，用于查方法、参数和写法线索 |
@@ -28,11 +29,11 @@ Paper Search CLI 是一个面向 AI agent 的 Skill + CLI 包，基于独立的
 
 | 层 | 负责什么 |
 | --- | --- |
-| CLI 本体 | 执行文献检索、期刊指标检索、PDF 获取/下载、正文片段检索和稳定 JSON 输出 |
+| CLI 本体 | 执行文献检索、引文扩展、期刊指标检索、PDF 获取/下载、正文片段检索和稳定 JSON 输出 |
 | Bundled Skill | 随包发布 `skills/paper-search`，提供 agent 路由规则和 focused references；不保存密钥、cookie 或账号信息 |
-| Friendly Management Layer | 围绕四个主要能力 `metadata_search`、`journal_metrics`、`pdf_discovery`、`body_snippet_search` 提供 `doctor`、`smoke`、`skills`、`config`、`tools`。`doctor` 健康报告包含脱敏配置、Capability Profile、平台/来源状态、缺失项和降级项；`smoke` 检查命令入口连通性和 live 可用性；`skills` 负责同步随包发布的 Skill |
+| Friendly Management Layer | 围绕五个主要能力 `metadata_search`、`citation_expansion`、`journal_metrics`、`pdf_discovery`、`body_snippet_search` 提供 `doctor`、`smoke`、`skills`、`config`、`tools`。`doctor` 健康报告包含脱敏配置、Capability Profile、平台/来源状态、缺失项和降级项；`smoke` 检查命令入口连通性和 live 可用性；`skills` 负责同步随包发布的 Skill |
 
-四个主要能力由 CLI 本体执行，由管理层报告和检查。Capability Profile 也会报告 `entitled_access`，让用户看到出版商 API key、数据库 key、TDM token 或机构权限是否已配置。某一个能力缺少配置或降级，不会导致其他独立能力不可用。
+五个主要能力由 CLI 本体执行，由管理层报告和检查。Capability Profile 也会报告 `entitled_access`，让用户看到出版商 API key、数据库 key、TDM token 或机构权限是否已配置。某一个能力缺少配置或降级，不会导致其他独立能力不可用。
 
 ## 快速开始
 
@@ -44,13 +45,14 @@ paper-search setup
 paper-search doctor --pretty
 ```
 
-尝试四个主要功能：
+尝试五个主要功能：
 
 ```bash
 paper-search search "machine learning clinical prediction" --platform crossref --max-results 3 --pretty
+paper-search run get_paper_citations --arg doi="10.1038/nature12373" --arg limit=5 --pretty
 paper-search journal-metrics "Nature" "BMJ" --pretty
 paper-search download 10.48550/arxiv.1201.0490 --platform arxiv --save-path ./downloads
-paper-search run search_semantic_snippets --arg query="propensity score matching" --arg maxResults=3 --pretty
+paper-search run search_semantic_snippets --arg query="propensity score matching" --arg limit=3 --pretty
 ```
 
 常用检查：
@@ -87,7 +89,7 @@ paper-search skills status --pretty
 | --- | --- | --- | --- | --- | --- | --- |
 | Crossref | ✅ 支持 | ❌ 不支持 | ❌ 不支持 | ✅ 支持 | ❌ 不需要 | 默认广覆盖元数据来源 |
 | OpenAlex | ✅ 支持 | 🟡 条件支持 | ❌ 不支持 | ✅ 支持 | ❌ 不需要 | 免费元数据；记录含 OA 链接时可帮助 PDF fallback |
-| Semantic Scholar | ✅ 支持 | 🟡 条件支持 | ✅ 正文片段 | ✅ 支持 | 🟡 可选；正文片段需要 `SEMANTIC_SCHOLAR_API_KEY` | 适合 AI/CS 和正文片段线索 |
+| Semantic Scholar | ✅ 支持 | 🟡 条件支持 | ✅ 正文片段 | ✅ 支持 | 🟡 可选；正文片段需要 `SEMANTIC_SCHOLAR_API_KEY` | 适合 AI/CS、引文扩展和正文片段线索 |
 | Google Scholar | ✅ 支持 | ❌ 不支持 | ❌ 不支持 | ✅ 支持 | ❌ 不需要 | 基于页面解析的广覆盖发现 |
 
 #### 期刊指标
@@ -205,7 +207,7 @@ paper-search doctor --pretty
 
 ## Agent Skill
 
-npm 包会随包发布 agent Skill，位置是 `skills/paper-search/SKILL.md`。终端用户可以只用 CLI；AI agent 工作流应安装或同步 Skill，让 agent 正确路由四个主要功能。
+npm 包会随包发布 agent Skill，位置是 `skills/paper-search/SKILL.md`。终端用户可以只用 CLI；AI agent 工作流应安装或同步 Skill，让 agent 正确路由五个主要功能。
 
 ```bash
 paper-search setup --install-skills agents

package/dist/capabilities/body-snippet-search/handler.d.ts

@@ -0,0 +1,9 @@
+import type { Searchers } from '../../core/searchers.js';
+import type { SemanticSnippetSearchArgs } from './types.js';
+export declare function handleSemanticSnippets(args: SemanticSnippetSearchArgs, searchers: Searchers): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/capabilities/body-snippet-search/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAa5D,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,SAAS;;;;;GAWjG"}

package/dist/capabilities/body-snippet-search/handler.js

@@ -0,0 +1,17 @@
+import { searchBodySnippets } from './service.js';
+function jsonTextResponse(text) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text
+            }
+        ]
+    };
+}
+export async function handleSemanticSnippets(args, searchers) {
+    const results = await searchBodySnippets(searchers, args);
+    const bodyCount = results.filter(result => result.snippet.snippetKind === 'body').length;
+    return jsonTextResponse(`Found ${results.length} Semantic Scholar snippet(s), including ${bodyCount} body snippet(s).\n\n${JSON.stringify(results, null, 2)}`);
+}
+//# sourceMappingURL=handler.js.map

package/dist/capabilities/body-snippet-search/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI;aACL;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAA+B,EAAE,SAAoB;IAChG,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IAEzF,OAAO,gBAAgB,CACrB,SAAS,OAAO,CAAC,MAAM,2CAA2C,SAAS,wBAAwB,IAAI,CAAC,SAAS,CAC/G,OAAO,EACP,IAAI,EACJ,CAAC,CACF,EAAE,CACJ,CAAC;AACJ,CAAC"}

package/dist/capabilities/body-snippet-search/index.d.ts

@@ -0,0 +1,7 @@
+export { SemanticScholarSearcher } from '../../platforms/SemanticScholarSearcher.js';
+export { handleSemanticSnippets } from './handler.js';
+export { SearchSemanticSnippetsSchema } from './schemas.js';
+export { searchBodySnippets } from './service.js';
+export { BODY_SNIPPET_SEARCH_TOOLS, SEARCH_SEMANTIC_SNIPPETS_TOOL } from './tools.js';
+export type { SemanticSnippetResult, SemanticSnippetSearchArgs } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/body-snippet-search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEtF,YAAY,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}

package/dist/capabilities/body-snippet-search/index.js

@@ -0,0 +1,6 @@
+export { SemanticScholarSearcher } from '../../platforms/SemanticScholarSearcher.js';
+export { handleSemanticSnippets } from './handler.js';
+export { SearchSemanticSnippetsSchema } from './schemas.js';
+export { searchBodySnippets } from './service.js';
+export { BODY_SNIPPET_SEARCH_TOOLS, SEARCH_SEMANTIC_SNIPPETS_TOOL } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/capabilities/body-snippet-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC"}

package/dist/capabilities/body-snippet-search/schemas.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+export declare const SearchSemanticSnippetsSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    year: z.ZodOptional<z.ZodString>;
+    fieldsOfStudy: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    paperIds: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    authors: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    venue: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    minCitationCount: z.ZodOptional<z.ZodNumber>;
+    publicationDateOrYear: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+    authors?: string | string[] | undefined;
+    year?: string | undefined;
+    venue?: string | string[] | undefined;
+    fieldsOfStudy?: string | string[] | undefined;
+    fields?: string | string[] | undefined;
+    paperIds?: string | string[] | undefined;
+    minCitationCount?: number | undefined;
+    publicationDateOrYear?: string | undefined;
+}, {
+    query: string;
+    authors?: string | string[] | undefined;
+    year?: string | undefined;
+    venue?: string | string[] | undefined;
+    fieldsOfStudy?: string | string[] | undefined;
+    limit?: number | undefined;
+    fields?: string | string[] | undefined;
+    paperIds?: string | string[] | undefined;
+    minCitationCount?: number | undefined;
+    publicationDateOrYear?: string | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/capabilities/body-snippet-search/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC"}

package/dist/capabilities/body-snippet-search/schemas.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export const SearchSemanticSnippetsSchema = z
+    .object({
+    query: z.string().min(1),
+    limit: z.number().int().min(1).max(1000).optional().default(5),
+    year: z.string().optional(),
+    fieldsOfStudy: z.union([z.string(), z.array(z.string())]).optional(),
+    paperIds: z.union([z.string(), z.array(z.string())]).optional(),
+    authors: z.union([z.string(), z.array(z.string())]).optional(),
+    venue: z.union([z.string(), z.array(z.string())]).optional(),
+    minCitationCount: z.number().int().min(0).optional(),
+    publicationDateOrYear: z.string().optional(),
+    fields: z.union([z.string(), z.array(z.string())]).optional()
+})
+    .strip();
+//# sourceMappingURL=schemas.js.map

package/dist/capabilities/body-snippet-search/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpD,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC;KACD,KAAK,EAAE,CAAC"}

package/dist/capabilities/body-snippet-search/service.d.ts

@@ -0,0 +1,4 @@
+import type { Searchers } from '../../core/searchers.js';
+import type { SemanticSnippetResult, SemanticSnippetSearchArgs } from './types.js';
+export declare function searchBodySnippets(searchers: Searchers, args: SemanticSnippetSearchArgs): Promise<SemanticSnippetResult[]>;
+//# sourceMappingURL=service.d.ts.map

package/dist/capabilities/body-snippet-search/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEnF,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAElC"}

package/dist/capabilities/body-snippet-search/service.js

@@ -0,0 +1,4 @@
+export async function searchBodySnippets(searchers, args) {
+    return searchers.semantic.searchSnippets(args);
+}
+//# sourceMappingURL=service.js.map

package/dist/capabilities/body-snippet-search/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/service.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAoB,EACpB,IAA+B;IAE/B,OAAO,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/capabilities/body-snippet-search/tools.d.ts

@@ -0,0 +1,187 @@
+export declare const SEARCH_SEMANTIC_SNIPPETS_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            year: {
+                type: string;
+                description: string;
+            };
+            fieldsOfStudy: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+            paperIds: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+            authors: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+            venue: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+            minCitationCount: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            publicationDateOrYear: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const BODY_SNIPPET_SEARCH_TOOLS: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            year: {
+                type: string;
+                description: string;
+            };
+            fieldsOfStudy: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+            paperIds: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+            authors: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+            venue: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+            minCitationCount: {
+                type: string;
+                minimum: number;
+                description: string;
+            };
+            publicationDateOrYear: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                anyOf: ({
+                    type: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                })[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/capabilities/body-snippet-search/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/tools.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CzC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAkC,CAAC"}

package/dist/capabilities/body-snippet-search/tools.js

@@ -0,0 +1,49 @@
+export const SEARCH_SEMANTIC_SNIPPETS_TOOL = {
+    name: 'search_semantic_snippets',
+    description: 'Search Semantic Scholar Open Access snippet index for text excerpts from titles, abstracts, and body text. Requires SEMANTIC_SCHOLAR_API_KEY.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'Natural-language query for text snippets' },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 1000,
+                description: 'Maximum number of snippet results to return. Default: 5'
+            },
+            year: { type: 'string', description: 'Publication year filter, e.g. "2020-2024"' },
+            fieldsOfStudy: {
+                anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+                description: 'Field-of-study filter, e.g. "Medicine" or ["Medicine","Biology"]'
+            },
+            paperIds: {
+                anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+                description: 'Optional paper IDs to restrict results to, comma-separated or array'
+            },
+            authors: {
+                anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+                description: 'Optional author-name filter, comma-separated or array'
+            },
+            venue: {
+                anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+                description: 'Optional venue filter, comma-separated or array'
+            },
+            minCitationCount: {
+                type: 'number',
+                minimum: 0,
+                description: 'Only return snippets from papers with at least this many citations'
+            },
+            publicationDateOrYear: {
+                type: 'string',
+                description: 'Publication date/year range, e.g. "2020-01-01:2024-12-31"'
+            },
+            fields: {
+                anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+                description: 'Optional Semantic Scholar snippet fields to return'
+            }
+        },
+        required: ['query']
+    }
+};
+export const BODY_SNIPPET_SEARCH_TOOLS = [SEARCH_SEMANTIC_SNIPPETS_TOOL];
+//# sourceMappingURL=tools.js.map

package/dist/capabilities/body-snippet-search/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/tools.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,+IAA+I;IACjJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;YAClF,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,yDAAyD;aACvE;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;YAClF,aAAa,EAAE;gBACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;gBACzE,WAAW,EAAE,kEAAkE;aAChF;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;gBACzE,WAAW,EAAE,qEAAqE;aACnF;YACD,OAAO,EAAE;gBACP,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;gBACzE,WAAW,EAAE,uDAAuD;aACrE;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;gBACzE,WAAW,EAAE,iDAAiD;aAC/D;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,oEAAoE;aAClF;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;gBACzE,WAAW,EAAE,oDAAoD;aAClE;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,6BAA6B,CAAC,CAAC"}

package/dist/capabilities/body-snippet-search/types.d.ts

@@ -0,0 +1,14 @@
+export type { SemanticSnippetResult } from '../../platforms/SemanticScholarSearcher.js';
+export interface SemanticSnippetSearchArgs {
+    query: string;
+    limit?: number;
+    year?: string;
+    fieldsOfStudy?: string | string[];
+    paperIds?: string | string[];
+    authors?: string | string[];
+    venue?: string | string[];
+    minCitationCount?: number;
+    publicationDateOrYear?: string;
+    fields?: string | string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/body-snippet-search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAExF,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B"}

package/dist/capabilities/body-snippet-search/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/capabilities/body-snippet-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/capabilities/body-snippet-search/types.ts"],"names":[],"mappings":""}

package/dist/capabilities/citation-expansion/CitationService.d.ts

@@ -0,0 +1,47 @@
+import type { BatchCitationRequest, CitationData } from './types.js';
+export type { BatchCitationRequest, CitationData } from './types.js';
+export declare class CitationService {
+    private client;
+    private cache;
+    private rateLimiter;
+    private apiKey?;
+    constructor(apiKey?: string);
+    /**
+     * Get citation data for a single paper by ID
+     */
+    getCitationData(paperId: string, forceRefresh?: boolean): Promise<CitationData | null>;
+    /**
+     * Get citation data by DOI
+     */
+    getCitationDataByDoi(doi: string, forceRefresh?: boolean): Promise<CitationData | null>;
+    /**
+     * Get citation data by arXiv ID
+     */
+    getCitationDataByArxiv(arxivId: string, forceRefresh?: boolean): Promise<CitationData | null>;
+    /**
+     * Batch lookup citations for multiple papers
+     */
+    batchLookup(requests: BatchCitationRequest[]): Promise<Map<string, CitationData | null>>;
+    /**
+     * Get references for a paper
+     */
+    getReferences(paperId: string, limit?: number): Promise<CitationData[]>;
+    /**
+     * Get citations for a paper
+     */
+    getCitations(paperId: string, limit?: number): Promise<CitationData[]>;
+    /**
+     * Parse Semantic Scholar response to CitationData
+     */
+    private parseCitationData;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): import("../../utils/RequestCache.js").CacheStats;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+}
+export default CitationService;
+//# sourceMappingURL=CitationService.d.ts.map

package/dist/capabilities/citation-expansion/CitationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CitationService.d.ts","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/CitationService.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM;IA0B3B;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAkDnG;;OAEG;IACG,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAUpG;;OAEG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAU1G;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;IAqC9F;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqClF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqCjF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,aAAa;IAIb;;OAEG;IACH,UAAU;CAGX;AAED,eAAe,eAAe,CAAC"}