paper-search-cli 0.3.1 → 0.3.2

package/dist/capabilities/citation-expansion/CitationService.js

@@ -0,0 +1,243 @@
+import axios from 'axios';
+import { RequestCache } from '../../utils/RequestCache.js';
+import { RateLimiter } from '../../utils/RateLimiter.js';
+import { ErrorHandler } from '../../utils/ErrorHandler.js';
+import { TIMEOUTS, USER_AGENT } from '../../config/constants.js';
+import { logDebug, logWarn } from '../../utils/Logger.js';
+export class CitationService {
+    client;
+    cache;
+    rateLimiter;
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey || process.env.SEMANTIC_SCHOLAR_API_KEY;
+        this.client = axios.create({
+            baseURL: 'https://api.semanticscholar.org/graph/v1',
+            timeout: TIMEOUTS.DEFAULT,
+            headers: {
+                'Accept': 'application/json',
+                'User-Agent': USER_AGENT,
+                ...(this.apiKey ? { 'x-api-key': this.apiKey } : {})
+            }
+        });
+        // Semantic Scholar rate limits: 100 req/5min (free), 1000 req/5min (paid)
+        const requestsPerMinute = this.apiKey ? 180 : 18;
+        this.rateLimiter = new RateLimiter({
+            requestsPerSecond: requestsPerMinute / 60,
+            burstCapacity: Math.max(3, Math.floor(requestsPerMinute / 20))
+        });
+        this.cache = new RequestCache({
+            maxSize: 500,
+            ttlMs: 86400000 // 24 hours
+        });
+    }
+    /**
+     * Get citation data for a single paper by ID
+     */
+    async getCitationData(paperId, forceRefresh = false) {
+        try {
+            // Check cache first
+            if (!forceRefresh) {
+                const cacheKey = this.cache.generateKey('citation', paperId, {});
+                const cached = this.cache.get(cacheKey);
+                if (cached) {
+                    return cached;
+                }
+            }
+            await this.rateLimiter.waitForPermission();
+            const fields = [
+                'paperId',
+                'title',
+                'citationCount',
+                'referenceCount',
+                'influentialCitationCount',
+                'year',
+                'authors',
+                'venue',
+                'externalIds',
+                'url'
+            ].join(',');
+            const response = await ErrorHandler.retryWithBackoff(() => this.client.get(`/paper/${paperId}`, {
+                params: { fields }
+            }), { context: 'Semantic Scholar citation lookup' });
+            if (response.status !== 200 || !response.data) {
+                return null;
+            }
+            const data = this.parseCitationData(response.data);
+            // Cache the result
+            const cacheKey = this.cache.generateKey('citation', paperId, {});
+            this.cache.set(cacheKey, data);
+            return data;
+        }
+        catch (error) {
+            logWarn(`Error fetching citation data for ${paperId}:`, error.message);
+            return null;
+        }
+    }
+    /**
+     * Get citation data by DOI
+     */
+    async getCitationDataByDoi(doi, forceRefresh = false) {
+        try {
+            const paperId = `DOI:${doi}`;
+            return await this.getCitationData(paperId, forceRefresh);
+        }
+        catch (error) {
+            logWarn(`Error fetching citation data by DOI ${doi}:`, error.message);
+            return null;
+        }
+    }
+    /**
+     * Get citation data by arXiv ID
+     */
+    async getCitationDataByArxiv(arxivId, forceRefresh = false) {
+        try {
+            const paperId = `ARXIV:${arxivId}`;
+            return await this.getCitationData(paperId, forceRefresh);
+        }
+        catch (error) {
+            logWarn(`Error fetching citation data by arXiv ID ${arxivId}:`, error.message);
+            return null;
+        }
+    }
+    /**
+     * Batch lookup citations for multiple papers
+     */
+    async batchLookup(requests) {
+        const results = new Map();
+        for (const request of requests) {
+            let paperId = null;
+            let key;
+            if (request.paperId) {
+                paperId = request.paperId;
+                key = request.paperId;
+            }
+            else if (request.doi) {
+                paperId = `DOI:${request.doi}`;
+                key = request.doi;
+            }
+            else if (request.arxivId) {
+                paperId = `ARXIV:${request.arxivId}`;
+                key = request.arxivId;
+            }
+            else if (request.title) {
+                key = request.title;
+                // Search by title (not implemented in this version)
+                results.set(key, null);
+                continue;
+            }
+            else {
+                continue;
+            }
+            try {
+                const data = await this.getCitationData(paperId);
+                results.set(key, data);
+            }
+            catch (error) {
+                logDebug(`Error in batch lookup for ${key}:`, error);
+                results.set(key, null);
+            }
+        }
+        return results;
+    }
+    /**
+     * Get references for a paper
+     */
+    async getReferences(paperId, limit = 100) {
+        try {
+            await this.rateLimiter.waitForPermission();
+            const fields = [
+                'paperId',
+                'title',
+                'citationCount',
+                'referenceCount',
+                'year',
+                'authors',
+                'venue',
+                'externalIds',
+                'url'
+            ].join(',');
+            const response = await ErrorHandler.retryWithBackoff(() => this.client.get(`/paper/${paperId}/references`, {
+                params: { fields, limit }
+            }), { context: 'Semantic Scholar references lookup' });
+            if (response.status !== 200 || !response.data?.data) {
+                return [];
+            }
+            return response.data.data
+                .map((item) => item.citedPaper)
+                .filter((paper) => paper)
+                .map((paper) => this.parseCitationData(paper));
+        }
+        catch (error) {
+            logWarn(`Error fetching references for ${paperId}:`, error.message);
+            return [];
+        }
+    }
+    /**
+     * Get citations for a paper
+     */
+    async getCitations(paperId, limit = 100) {
+        try {
+            await this.rateLimiter.waitForPermission();
+            const fields = [
+                'paperId',
+                'title',
+                'citationCount',
+                'referenceCount',
+                'year',
+                'authors',
+                'venue',
+                'externalIds',
+                'url'
+            ].join(',');
+            const response = await ErrorHandler.retryWithBackoff(() => this.client.get(`/paper/${paperId}/citations`, {
+                params: { fields, limit }
+            }), { context: 'Semantic Scholar citations lookup' });
+            if (response.status !== 200 || !response.data?.data) {
+                return [];
+            }
+            return response.data.data
+                .map((item) => item.citingPaper)
+                .filter((paper) => paper)
+                .map((paper) => this.parseCitationData(paper));
+        }
+        catch (error) {
+            logWarn(`Error fetching citations for ${paperId}:`, error.message);
+            return [];
+        }
+    }
+    /**
+     * Parse Semantic Scholar response to CitationData
+     */
+    parseCitationData(data) {
+        return {
+            paperId: data.paperId,
+            title: data.title,
+            citationCount: data.citationCount || 0,
+            referenceCount: data.referenceCount || 0,
+            influentialCitationCount: data.influentialCitationCount,
+            year: data.year,
+            authors: data.authors?.map((author) => ({
+                name: author.name,
+                authorId: author.authorId
+            })),
+            venue: data.venue,
+            doi: data.externalIds?.DOI,
+            url: data.url
+        };
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return this.cache.getStats();
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+export default CitationService;
+//# sourceMappingURL=CitationService.js.map

package/dist/capabilities/citation-expansion/CitationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CitationService.js","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/CitationService.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,36 @@
+import type { CitationData } from './types.js';
+export declare function resolveCitationTarget(args: {
+    paperId?: string;
+    doi?: string;
+    arxivId?: string;
+}): string;
+export declare function citationResponse(target: string, relation: 'citations' | 'references', papers: CitationData[]): {
+    target: string;
+    relation: "references" | "citations";
+    provider: string;
+    total: number;
+    papers: CitationData[];
+};
+export declare function handleGetPaperCitations(args: {
+    paperId?: string;
+    doi?: string;
+    arxivId?: string;
+    limit?: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function handleGetPaperReferences(args: {
+    paperId?: string;
+    doi?: string;
+    arxivId?: string;
+    limit?: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa/C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKxG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE;;;;;;EAQ5G;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAMvH;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAMxH"}

package/dist/capabilities/citation-expansion/handler.js

@@ -0,0 +1,44 @@
+import CitationService from './CitationService.js';
+function jsonTextResponse(text) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text
+            }
+        ]
+    };
+}
+export function resolveCitationTarget(args) {
+    if (args.paperId)
+        return args.paperId;
+    if (args.doi)
+        return `DOI:${args.doi}`;
+    if (args.arxivId)
+        return `ARXIV:${args.arxivId}`;
+    throw new Error('Provide paperId, doi, or arxivId');
+}
+export function citationResponse(target, relation, papers) {
+    return {
+        target,
+        relation,
+        provider: 'semantic_scholar',
+        total: papers.length,
+        papers
+    };
+}
+export async function handleGetPaperCitations(args) {
+    const target = resolveCitationTarget(args);
+    const service = new CitationService();
+    const papers = await service.getCitations(target, args.limit);
+    const result = citationResponse(target, 'citations', papers);
+    return jsonTextResponse(`Found ${papers.length} citing paper(s).\n\n${JSON.stringify(result, null, 2)}`);
+}
+export async function handleGetPaperReferences(args) {
+    const target = resolveCitationTarget(args);
+    const service = new CitationService();
+    const papers = await service.getReferences(target, args.limit);
+    const result = citationResponse(target, 'references', papers);
+    return jsonTextResponse(`Found ${papers.length} cited reference(s).\n\n${JSON.stringify(result, null, 2)}`);
+}
+//# sourceMappingURL=handler.js.map

package/dist/capabilities/citation-expansion/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/handler.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,sBAAsB,CAAC;AAGnD,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI;aACL;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAA0D;IAC9F,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC;IACtC,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACvC,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;IACjD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,QAAoC,EAAE,MAAsB;IAC3G,OAAO;QACL,MAAM;QACN,QAAQ;QACR,QAAQ,EAAE,kBAAkB;QAC5B,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAA0E;IACtH,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,gBAAgB,CAAC,SAAS,MAAM,CAAC,MAAM,wBAAwB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAA0E;IACvH,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO,gBAAgB,CAAC,SAAS,MAAM,CAAC,MAAM,2BAA2B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAC9G,CAAC"}

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

@@ -0,0 +1,6 @@
+export { CitationService, default } from './CitationService.js';
+export { citationResponse, handleGetPaperCitations, handleGetPaperReferences, resolveCitationTarget } from './handler.js';
+export { CitationLookupSchema } from './schemas.js';
+export { CITATION_EXPANSION_TOOLS, GET_PAPER_CITATIONS_TOOL, GET_PAPER_REFERENCES_TOOL } from './tools.js';
+export type { BatchCitationRequest, CitationData } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/capabilities/citation-expansion/index.js

@@ -0,0 +1,5 @@
+export { CitationService, default } from './CitationService.js';
+export { citationResponse, handleGetPaperCitations, handleGetPaperReferences, resolveCitationTarget } from './handler.js';
+export { CitationLookupSchema } from './schemas.js';
+export { CITATION_EXPANSION_TOOLS, GET_PAPER_CITATIONS_TOOL, GET_PAPER_REFERENCES_TOOL } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/capabilities/citation-expansion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const CitationLookupSchema: z.ZodEffects<z.ZodObject<{
+    paperId: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    arxivId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    paperId?: string | undefined;
+    doi?: string | undefined;
+    arxivId?: string | undefined;
+}, {
+    paperId?: string | undefined;
+    doi?: string | undefined;
+    arxivId?: string | undefined;
+    limit?: number | undefined;
+}>, {
+    limit: number;
+    paperId?: string | undefined;
+    doi?: string | undefined;
+    arxivId?: string | undefined;
+}, {
+    paperId?: string | undefined;
+    doi?: string | undefined;
+    arxivId?: string | undefined;
+    limit?: number | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC"}

package/dist/capabilities/citation-expansion/schemas.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const CitationLookupSchema = z
+    .object({
+    paperId: z.coerce.string().min(1).optional(),
+    doi: z.coerce.string().min(1).optional(),
+    arxivId: z.coerce.string().min(1).optional(),
+    limit: z.number().int().min(1).max(100).optional().default(100)
+})
+    .strip()
+    .refine(value => Boolean(value.paperId || value.doi || value.arxivId), {
+    message: 'Provide paperId, doi, or arxivId'
+});
+//# sourceMappingURL=schemas.js.map

package/dist/capabilities/citation-expansion/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CAChE,CAAC;KACD,KAAK,EAAE;KACP,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE;IACrE,OAAO,EAAE,kCAAkC;CAC5C,CAAC,CAAC"}

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

@@ -0,0 +1,82 @@
+export declare const GET_PAPER_CITATIONS_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            paperId: {
+                type: string;
+                description: string;
+            };
+            doi: {
+                type: string;
+                description: string;
+            };
+            arxivId: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export declare const GET_PAPER_REFERENCES_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            paperId: {
+                type: string;
+                description: string;
+            };
+            doi: {
+                type: string;
+                description: string;
+            };
+            arxivId: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export declare const CITATION_EXPANSION_TOOLS: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            paperId: {
+                type: string;
+                description: string;
+            };
+            doi: {
+                type: string;
+                description: string;
+            };
+            arxivId: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+}[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/tools.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBpC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBrC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;GAAwD,CAAC"}

package/dist/capabilities/citation-expansion/tools.js

@@ -0,0 +1,48 @@
+const CITATION_LOOKUP_PROPERTIES = {
+    paperId: {
+        type: 'string',
+        description: 'Semantic Scholar paper id or external id such as DOI:10.xxxx/xxxxx'
+    },
+    doi: {
+        type: 'string',
+        description: 'DOI for the target paper; converted to DOI:<doi>'
+    },
+    arxivId: {
+        type: 'string',
+        description: 'arXiv id for the target paper; converted to ARXIV:<id>'
+    }
+};
+export const GET_PAPER_CITATIONS_TOOL = {
+    name: 'get_paper_citations',
+    description: 'Get citing papers for a target paper using Semantic Scholar Graph API. Provide one of paperId, doi, or arxivId.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ...CITATION_LOOKUP_PROPERTIES,
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Maximum number of citing papers to return. Default: 100'
+            }
+        }
+    }
+};
+export const GET_PAPER_REFERENCES_TOOL = {
+    name: 'get_paper_references',
+    description: 'Get cited references for a target paper using Semantic Scholar Graph API. Provide one of paperId, doi, or arxivId.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ...CITATION_LOOKUP_PROPERTIES,
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Maximum number of cited references to return. Default: 100'
+            }
+        }
+    }
+};
+export const CITATION_EXPANSION_TOOLS = [GET_PAPER_CITATIONS_TOOL, GET_PAPER_REFERENCES_TOOL];
+//# sourceMappingURL=tools.js.map

package/dist/capabilities/citation-expansion/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/tools.ts"],"names":[],"mappings":"AAAA,MAAM,0BAA0B,GAAG;IACjC,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oEAAoE;KAClF;IACD,GAAG,EAAE;QACH,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kDAAkD;KAChE;IACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wDAAwD;KACtE;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,iHAAiH;IACnH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,0BAA0B;YAC7B,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,yDAAyD;aACvE;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,oHAAoH;IACtH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,0BAA0B;YAC7B,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,4DAA4D;aAC1E;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,wBAAwB,EAAE,yBAAyB,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+export interface CitationData {
+    paperId: string;
+    title: string;
+    citationCount: number;
+    referenceCount: number;
+    influentialCitationCount?: number;
+    year?: number;
+    authors?: Array<{
+        name: string;
+        authorId?: string;
+    }>;
+    venue?: string;
+    doi?: string;
+    url?: string;
+}
+export interface BatchCitationRequest {
+    paperId?: string;
+    doi?: string;
+    arxivId?: string;
+    title?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/capabilities/citation-expansion/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/capabilities/citation-expansion/types.js

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

package/dist/capabilities/citation-expansion/types.js.map

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

package/dist/capabilities/journal-metrics/JournalMetricsService.d.ts

@@ -0,0 +1,3 @@
+import type { JournalMetricsRow, QueryJournalMetricsOptions } from './types.js';
+export declare function queryJournalMetrics(options: QueryJournalMetricsOptions): Promise<JournalMetricsRow[]>;
+//# sourceMappingURL=JournalMetricsService.d.ts.map

package/dist/capabilities/journal-metrics/JournalMetricsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JournalMetricsService.d.ts","sourceRoot":"","sources":["../../../src/capabilities/journal-metrics/JournalMetricsService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AA0IhF,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuC3G"}