@mantra-ai/core 0.1.6 → 0.2.0

package/dist/sources/semantic-scholar/client.js

@@ -0,0 +1,129 @@
+/**
+ * Typed client for the Semantic Scholar Academic Graph API.
+ *
+ * Unauthenticated: 100 requests per 5 minutes.
+ * Authenticated (x-api-key header): higher limits.
+ *
+ * @see https://api.semanticscholar.org/api-docs/graph
+ */
+const BASE_URL = "https://api.semanticscholar.org/graph/v1";
+const SEARCH_FIELDS = [
+    "paperId",
+    "title",
+    "abstract",
+    "year",
+    "authors",
+    "citationCount",
+    "influentialCitationCount",
+    "venue",
+    "externalIds",
+    "url",
+].join(",");
+const DETAIL_FIELDS = [
+    ...SEARCH_FIELDS.split(","),
+    "referenceCount",
+    "isOpenAccess",
+    "openAccessPdf",
+    "publicationDate",
+    "journal",
+].join(",");
+/** Max retries on 429 / 5xx before giving up. */
+const MAX_RETRIES = 2;
+/** Request timeout in ms. */
+const REQUEST_TIMEOUT_MS = 10_000;
+// ── Helpers ──────────────────────────────────────────────────────────
+function buildHeaders(apiKey) {
+    const headers = {
+        Accept: "application/json",
+    };
+    if (apiKey) {
+        headers["x-api-key"] = apiKey;
+    }
+    return headers;
+}
+async function fetchWithRetry(url, headers) {
+    let lastError;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            const res = await fetch(url, {
+                headers,
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+            // Retry on 429 or 5xx
+            if ((res.status === 429 || res.status >= 500) && attempt < MAX_RETRIES) {
+                // Exponential backoff: 1s, 2s
+                await new Promise((r) => setTimeout(r, 1000 * (attempt + 1)));
+                continue;
+            }
+            return res;
+        }
+        catch (e) {
+            lastError = e;
+            if (attempt < MAX_RETRIES) {
+                await new Promise((r) => setTimeout(r, 1000 * (attempt + 1)));
+                continue;
+            }
+        }
+    }
+    throw lastError ?? new Error("fetchWithRetry exhausted");
+}
+// ── Public API ───────────────────────────────────────────────────────
+/**
+ * Search for papers by keyword query.
+ *
+ * @see https://api.semanticscholar.org/api-docs/graph#tag/Paper-Data/operation/post_graph_get_papers_search
+ */
+export async function searchPapers(query, opts) {
+    const limit = Math.min(opts?.limit ?? 20, 100);
+    const offset = opts?.offset ?? 0;
+    const params = new URLSearchParams({
+        query,
+        fields: SEARCH_FIELDS,
+        limit: String(limit),
+        offset: String(offset),
+    });
+    const url = `${BASE_URL}/paper/search?${params}`;
+    try {
+        const res = await fetchWithRetry(url, buildHeaders(opts?.apiKey));
+        if (!res.ok) {
+            const status = res.status;
+            if (status === 400)
+                return { ok: false, status, reason: "not_found" };
+            if (status === 429)
+                return { ok: false, status, reason: "rate_limited" };
+            return { ok: false, status, reason: "upstream_error" };
+        }
+        const data = (await res.json());
+        return { ok: true, data };
+    }
+    catch {
+        return { ok: false, reason: "network_error" };
+    }
+}
+/**
+ * Get detailed information about a single paper.
+ *
+ * Accepts S2 paper ID, DOI (prefixed with "DOI:"), ArXiv ID ("ARXIV:"), etc.
+ *
+ * @see https://api.semanticscholar.org/api-docs/graph#tag/Paper-Data/operation/post_graph_get_paper
+ */
+export async function getPaperDetails(paperId, opts) {
+    const url = `${BASE_URL}/paper/${encodeURIComponent(paperId)}?fields=${DETAIL_FIELDS}`;
+    try {
+        const res = await fetchWithRetry(url, buildHeaders(opts?.apiKey));
+        if (!res.ok) {
+            const status = res.status;
+            if (status === 404)
+                return { ok: false, status, reason: "not_found" };
+            if (status === 429)
+                return { ok: false, status, reason: "rate_limited" };
+            return { ok: false, status, reason: "upstream_error" };
+        }
+        const data = (await res.json());
+        return { ok: true, data };
+    }
+    catch {
+        return { ok: false, reason: "network_error" };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/sources/semantic-scholar/client.js.map

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

package/dist/sources/semantic-scholar/provider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Semantic Scholar discovery provider.
+ *
+ * Adapts the S2 API client to the DiscoverProvider interface.
+ */
+import type { DiscoverCandidateCore, DiscoverProvider, DiscoverSearchOpts } from "../../discovery/types";
+import { type S2ClientOpts } from "./client";
+export declare class SemanticScholarProvider implements DiscoverProvider {
+    readonly name = "Semantic Scholar";
+    readonly sourceKind: "semantic-scholar";
+    readonly capabilities: readonly ["search"];
+    readonly isLocal = false;
+    private opts;
+    constructor(opts?: S2ClientOpts);
+    search(query: string, opts?: DiscoverSearchOpts): Promise<DiscoverCandidateCore[]>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/sources/semantic-scholar/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/sources/semantic-scholar/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AA0CzE,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,UAAU,EAAG,kBAAkB,CAAU;IAClD,QAAQ,CAAC,YAAY,sBAAuB;IAC5C,QAAQ,CAAC,OAAO,SAAS;IAEzB,OAAO,CAAC,IAAI,CAAe;gBAEf,IAAI,CAAC,EAAE,YAAY;IAIzB,MAAM,CACV,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAkBpC"}

package/dist/sources/semantic-scholar/provider.js

@@ -0,0 +1,63 @@
+/**
+ * Semantic Scholar discovery provider.
+ *
+ * Adapts the S2 API client to the DiscoverProvider interface.
+ */
+import { searchPapers } from "./client";
+/**
+ * Map an S2Paper to a DiscoverCandidateCore.
+ * Handles sparse records gracefully — every field may be null.
+ */
+function s2PaperToCandidate(paper, position) {
+    const doi = paper.externalIds?.DOI ?? null;
+    const authors = paper.authors
+        ?.map((a) => a.name)
+        .filter(Boolean)
+        .join(", ") || null;
+    // Truncate abstract to ~200 chars for snippet
+    let abstractSnippet = null;
+    if (paper.abstract) {
+        abstractSnippet =
+            paper.abstract.length > 200
+                ? paper.abstract.slice(0, 197) + "..."
+                : paper.abstract;
+    }
+    return {
+        doi,
+        title: paper.title,
+        authors,
+        year: paper.year,
+        sources: ["semantic-scholar"],
+        score: position, // position-based; normalizeScore handles conversion to 0–1
+        semanticScholarId: paper.paperId,
+        citationCount: paper.citationCount,
+        influentialCitationCount: paper.influentialCitationCount,
+        abstractSnippet,
+        venue: paper.venue || null,
+        url: paper.url,
+    };
+}
+export class SemanticScholarProvider {
+    name = "Semantic Scholar";
+    sourceKind = "semantic-scholar";
+    capabilities = ["search"];
+    isLocal = false;
+    opts;
+    constructor(opts) {
+        this.opts = opts ?? {};
+    }
+    async search(query, opts) {
+        const limit = opts?.limit ?? 20;
+        const result = await searchPapers(query, {
+            ...this.opts,
+            limit,
+        });
+        if (!result.ok) {
+            // Throw so the registry captures it as a provider error
+            // and the other providers continue working.
+            throw new Error(`Semantic Scholar search failed: ${result.reason}${result.status ? ` (${result.status})` : ""}`);
+        }
+        return result.data.data.map((paper, i) => s2PaperToCandidate(paper, i));
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/sources/semantic-scholar/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/sources/semantic-scholar/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,YAAY,EAAmC,MAAM,UAAU,CAAC;AAEzE;;;GAGG;AACH,SAAS,kBAAkB,CACzB,KAAc,EACd,QAAgB;IAEhB,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,GAAG,IAAI,IAAI,CAAC;IAE3C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO;QAC3B,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACnB,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAEtB,8CAA8C;IAC9C,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,eAAe;YACb,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG;gBACzB,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;gBACtC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,OAAO;QACL,GAAG;QACH,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO;QACP,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,CAAC,kBAAkB,CAAC;QAC7B,KAAK,EAAE,QAAQ,EAAE,2DAA2D;QAC5E,iBAAiB,EAAE,KAAK,CAAC,OAAO;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;QACxD,eAAe;QACf,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,uBAAuB;IACzB,IAAI,GAAG,kBAAkB,CAAC;IAC1B,UAAU,GAAG,kBAA2B,CAAC;IACzC,YAAY,GAAG,CAAC,QAAQ,CAAU,CAAC;IACnC,OAAO,GAAG,KAAK,CAAC;IAEjB,IAAI,CAAe;IAE3B,YAAY,IAAmB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,IAAyB;QAEzB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAEhC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE;YACvC,GAAG,IAAI,CAAC,IAAI;YACZ,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,wDAAwD;YACxD,4CAA4C;YAC5C,MAAM,IAAI,KAAK,CACb,mCAAmC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAChG,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/types/version.d.ts

@@ -397,14 +397,14 @@ export declare const ExpandPaginationSchema: z.ZodOptional<z.ZodObject<{
     limit: z.ZodNumber;
     has_more: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
-    total: number;
-    offset: number;
     limit: number;
+    offset: number;
+    total: number;
     has_more: boolean;
 }, {
-    total: number;
-    offset: number;
     limit: number;
+    offset: number;
+    total: number;
     has_more: boolean;
 }>>;
 export declare const VersionResponseSchema: z.ZodObject<{
@@ -491,14 +491,14 @@ export declare const VersionResponseSchema: z.ZodObject<{
         limit: z.ZodNumber;
         has_more: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     }, {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     }>>;
     assets: z.ZodOptional<z.ZodUnknown>;
@@ -509,14 +509,14 @@ export declare const VersionResponseSchema: z.ZodObject<{
         limit: z.ZodNumber;
         has_more: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     }, {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     }>>;
     work: z.ZodOptional<z.ZodObject<{
@@ -579,15 +579,15 @@ export declare const VersionResponseSchema: z.ZodObject<{
     } | undefined;
     source_id?: string | null | undefined;
     _blocks_pagination?: {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     } | undefined;
     _citations_pagination?: {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     } | undefined;
 }, {
@@ -637,15 +637,15 @@ export declare const VersionResponseSchema: z.ZodObject<{
     } | undefined;
     source_id?: string | null | undefined;
     _blocks_pagination?: {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     } | undefined;
     _citations_pagination?: {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     } | undefined;
 }>;
@@ -904,14 +904,14 @@ export declare const VersionsListResponseSchema: z.ZodObject<{
             limit: z.ZodNumber;
             has_more: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         }, {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         }>>;
         assets: z.ZodOptional<z.ZodUnknown>;
@@ -922,14 +922,14 @@ export declare const VersionsListResponseSchema: z.ZodObject<{
             limit: z.ZodNumber;
             has_more: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         }, {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         }>>;
         work: z.ZodOptional<z.ZodObject<{
@@ -992,15 +992,15 @@ export declare const VersionsListResponseSchema: z.ZodObject<{
         } | undefined;
         source_id?: string | null | undefined;
         _blocks_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
         _citations_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
     }, {
@@ -1050,15 +1050,15 @@ export declare const VersionsListResponseSchema: z.ZodObject<{
         } | undefined;
         source_id?: string | null | undefined;
         _blocks_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
         _citations_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
     }>]>, "many">;
@@ -1153,15 +1153,15 @@ export declare const VersionsListResponseSchema: z.ZodObject<{
         } | undefined;
         source_id?: string | null | undefined;
         _blocks_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
         _citations_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
     })[];
@@ -1256,15 +1256,15 @@ export declare const VersionsListResponseSchema: z.ZodObject<{
         } | undefined;
         source_id?: string | null | undefined;
         _blocks_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
         _citations_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
     })[];
@@ -1280,14 +1280,14 @@ export declare const VersionExpandedDataSchema: z.ZodOptional<z.ZodObject<{
         limit: z.ZodNumber;
         has_more: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     }, {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     }>>;
     assets: z.ZodOptional<z.ZodUnknown>;
@@ -1298,14 +1298,14 @@ export declare const VersionExpandedDataSchema: z.ZodOptional<z.ZodObject<{
         limit: z.ZodNumber;
         has_more: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     }, {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -1315,15 +1315,15 @@ export declare const VersionExpandedDataSchema: z.ZodOptional<z.ZodObject<{
     citations?: unknown;
     assets?: unknown;
     _blocks_pagination?: {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     } | undefined;
     _citations_pagination?: {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     } | undefined;
 }, {
@@ -1333,15 +1333,15 @@ export declare const VersionExpandedDataSchema: z.ZodOptional<z.ZodObject<{
     citations?: unknown;
     assets?: unknown;
     _blocks_pagination?: {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     } | undefined;
     _citations_pagination?: {
-        total: number;
-        offset: number;
         limit: number;
+        offset: number;
+        total: number;
         has_more: boolean;
     } | undefined;
 }>>;
@@ -1527,14 +1527,14 @@ export declare const VersionEnvelopeSuccessSchema: z.ZodObject<{
             limit: z.ZodNumber;
             has_more: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         }, {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         }>>;
         assets: z.ZodOptional<z.ZodUnknown>;
@@ -1545,14 +1545,14 @@ export declare const VersionEnvelopeSuccessSchema: z.ZodObject<{
             limit: z.ZodNumber;
             has_more: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         }, {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         }>>;
     }, "strip", z.ZodTypeAny, {
@@ -1562,15 +1562,15 @@ export declare const VersionEnvelopeSuccessSchema: z.ZodObject<{
         citations?: unknown;
         assets?: unknown;
         _blocks_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
         _citations_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
     }, {
@@ -1580,15 +1580,15 @@ export declare const VersionEnvelopeSuccessSchema: z.ZodObject<{
         citations?: unknown;
         assets?: unknown;
         _blocks_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
         _citations_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
     }>>;
@@ -1643,15 +1643,15 @@ export declare const VersionEnvelopeSuccessSchema: z.ZodObject<{
         citations?: unknown;
         assets?: unknown;
         _blocks_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
         _citations_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
     } | undefined;
@@ -1706,15 +1706,15 @@ export declare const VersionEnvelopeSuccessSchema: z.ZodObject<{
         citations?: unknown;
         assets?: unknown;
         _blocks_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
         _citations_pagination?: {
-            total: number;
-            offset: number;
             limit: number;
+            offset: number;
+            total: number;
             has_more: boolean;
         } | undefined;
     } | undefined;