@project-ava-supernova/core 0.2.71

package/dist/papers/discipline.d.ts

@@ -0,0 +1,19 @@
+import type { PaperDiscipline } from './types.js';
+/**
+ * Map an arXiv category code (e.g. 'cs.AI', 'q-bio.QM', 'physics.gen-ph')
+ * to one of Ava's discipline buckets. Used when arXiv is the source of
+ * truth so the Featured-tab pivots can filter by discipline.
+ */
+export declare function arxivCategoryToDiscipline(category: string): PaperDiscipline;
+/**
+ * Map an OpenAlex top-level concept ("field") name to a discipline.
+ * OpenAlex returns a list of concepts per work; pass the highest-
+ * level (level=0) concept name. Falls back to 'other' on miss.
+ */
+export declare function openalexFieldToDiscipline(field: string | null | undefined): PaperDiscipline;
+/**
+ * Coarse keyword-based fallback when neither arXiv categories nor
+ * OpenAlex concepts are available (e.g. Crossref-only lookups).
+ */
+export declare function inferDisciplineFromText(title: string, abstract?: string): PaperDiscipline;
+//# sourceMappingURL=discipline.d.ts.map

package/dist/papers/discipline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discipline.d.ts","sourceRoot":"","sources":["../../src/papers/discipline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CA8B3E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,CAc3F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAazF"}

package/dist/papers/discipline.js

@@ -0,0 +1,96 @@
+/**
+ * Map an arXiv category code (e.g. 'cs.AI', 'q-bio.QM', 'physics.gen-ph')
+ * to one of Ava's discipline buckets. Used when arXiv is the source of
+ * truth so the Featured-tab pivots can filter by discipline.
+ */
+export function arxivCategoryToDiscipline(category) {
+    const prefix = category.toLowerCase().split('.')[0];
+    switch (prefix) {
+        case 'cs':
+        case 'stat':
+            return 'ai_cs';
+        case 'math':
+            return 'math';
+        case 'physics':
+        case 'astro-ph':
+        case 'cond-mat':
+        case 'gr-qc':
+        case 'hep-ex':
+        case 'hep-lat':
+        case 'hep-ph':
+        case 'hep-th':
+        case 'nucl-ex':
+        case 'nucl-th':
+        case 'quant-ph':
+            return 'physics';
+        case 'q-bio':
+            return 'biology';
+        case 'q-fin':
+        case 'econ':
+            return 'economics';
+        case 'eess':
+            return 'engineering';
+        default:
+            return 'other';
+    }
+}
+/**
+ * Map an OpenAlex top-level concept ("field") name to a discipline.
+ * OpenAlex returns a list of concepts per work; pass the highest-
+ * level (level=0) concept name. Falls back to 'other' on miss.
+ */
+export function openalexFieldToDiscipline(field) {
+    if (!field)
+        return 'other';
+    const f = field.toLowerCase();
+    if (f.includes('computer science') || f.includes('artificial intelligence'))
+        return 'ai_cs';
+    if (f.includes('biology') || f.includes('biochem') || f.includes('genetic'))
+        return 'biology';
+    if (f.includes('medic') || f.includes('clinical') || f.includes('pharmacol') || f.includes('nursing'))
+        return 'medicine';
+    if (f.includes('physics') || f.includes('astronomy'))
+        return 'physics';
+    if (f.includes('chemistry') || f.includes('material'))
+        return 'chemistry';
+    if (f.includes('geology') || f.includes('environmental') || f.includes('earth') || f.includes('atmospheric') || f.includes('oceanography'))
+        return 'earth_sciences';
+    if (f.includes('psychology') || f.includes('sociology') || f.includes('political') || f.includes('anthropology') || f.includes('linguistic'))
+        return 'social_sciences';
+    if (f.includes('econ') || f.includes('finance') || f.includes('business'))
+        return 'economics';
+    if (f.includes('engineering'))
+        return 'engineering';
+    if (f.includes('math'))
+        return 'math';
+    return 'other';
+}
+/**
+ * Coarse keyword-based fallback when neither arXiv categories nor
+ * OpenAlex concepts are available (e.g. Crossref-only lookups).
+ */
+export function inferDisciplineFromText(title, abstract) {
+    const text = `${title} ${abstract ?? ''}`.toLowerCase();
+    if (/\b(neural network|transformer|deep learning|llm|reinforcement learning|computer vision|nlp|machine learning)\b/.test(text))
+        return 'ai_cs';
+    if (/\b(protein|gene|crispr|genome|cell|enzyme|microbi)\b/.test(text))
+        return 'biology';
+    if (/\b(clinical|patient|trial|placebo|disease|cancer|vaccine|epidemiolog)\b/.test(text))
+        return 'medicine';
+    if (/\b(quantum|particle|relativity|gravitational|cosmolog|astrophys)\b/.test(text))
+        return 'physics';
+    if (/\b(catalys|polymer|reaction|molecule|synthesi)\b/.test(text))
+        return 'chemistry';
+    if (/\b(climate|warming|earthquake|geolog|atmospher|ocean)\b/.test(text))
+        return 'earth_sciences';
+    if (/\b(psycholog|behaviour|behavior|social|society|cognitive)\b/.test(text))
+        return 'social_sciences';
+    if (/\b(economic|inflation|monetary|labour market|gdp|trade policy)\b/.test(text))
+        return 'economics';
+    if (/\b(engineering|aerospace|mechanical|civil|structural)\b/.test(text))
+        return 'engineering';
+    if (/\b(theorem|lemma|conjecture|topolog|algebra|combinator)\b/.test(text))
+        return 'math';
+    return 'other';
+}
+//# sourceMappingURL=discipline.js.map

package/dist/papers/discipline.js.map

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

package/dist/papers/index.d.ts

@@ -0,0 +1,10 @@
+export type { Paper, PaperAuthor, PaperSource, PaperDiscipline, PaperSearchQuery, PaperSearchResult, PaperSignal, } from './types.js';
+export { ALL_DISCIPLINES, DISCIPLINE_LABELS } from './types.js';
+export { arxivCategoryToDiscipline, openalexFieldToDiscipline, inferDisciplineFromText, } from './discipline.js';
+export { fetchPaperByArxivId, searchArxiv, arxivPdfUrl, } from './arxiv-client.js';
+export type { ArxivSearchOptions } from './arxiv-client.js';
+export { searchOpenAlex, fetchPaperByOpenAlexId, } from './openalex-client.js';
+export { fetchPaperByDoi } from './crossref-client.js';
+export { fetchPaper, parseIdentifier } from './paper-fetcher.js';
+export type { FetchPaperInput } from './paper-fetcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/papers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/papers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EACL,cAAc,EACd,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/papers/index.js

@@ -0,0 +1,7 @@
+export { ALL_DISCIPLINES, DISCIPLINE_LABELS } from './types.js';
+export { arxivCategoryToDiscipline, openalexFieldToDiscipline, inferDisciplineFromText, } from './discipline.js';
+export { fetchPaperByArxivId, searchArxiv, arxivPdfUrl, } from './arxiv-client.js';
+export { searchOpenAlex, fetchPaperByOpenAlexId, } from './openalex-client.js';
+export { fetchPaperByDoi } from './crossref-client.js';
+export { fetchPaper, parseIdentifier } from './paper-fetcher.js';
+//# sourceMappingURL=index.js.map

package/dist/papers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/papers/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/papers/openalex-client.d.ts

@@ -0,0 +1,13 @@
+import type { Paper, PaperSearchQuery, PaperSearchResult } from './types.js';
+export declare function searchOpenAlex(query: PaperSearchQuery, signal?: AbortSignal): Promise<PaperSearchResult>;
+/**
+ * Fetch a single OpenAlex work by ID, DOI, or arXiv ID. Resolves any
+ * of the three identifier types via OpenAlex's flexible /works/{id}
+ * endpoint which accepts `W123`, `doi:10.x/y`, or `mag:NNN` forms.
+ */
+export declare function fetchPaperByOpenAlexId(identifier: {
+    openalex_id?: string;
+    doi?: string;
+    arxiv_id?: string;
+}, signal?: AbortSignal): Promise<Paper | null>;
+//# sourceMappingURL=openalex-client.d.ts.map

package/dist/papers/openalex-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openalex-client.d.ts","sourceRoot":"","sources":["../../src/papers/openalex-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAe,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAuL1F,wBAAsB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwB9G;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACrE,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA4BvB"}

package/dist/papers/openalex-client.js

@@ -0,0 +1,206 @@
+import { openalexFieldToDiscipline } from './discipline.js';
+import { logger } from '../core/logger.js';
+/**
+ * OpenAlex API client. Free, no auth required, but adding a contact
+ * email lifts you into the "polite pool" with much higher rate limits
+ * (100k req/min vs 100k req/day anonymous). Server-side env var only —
+ * never ship the email in client bundles.
+ *
+ * OpenAlex covers ~250M works across every discipline (replaced
+ * Microsoft Academic Graph after MS killed it). Single source for
+ * cross-field search, citations, author networks, journal metadata.
+ *
+ * For arXiv-native AI/ML papers, OpenAlex eventually indexes them
+ * (24-48h lag) so most queries surface them too. The `arxiv-client`
+ * is the parallel path for absolute freshness on AI/ML when needed
+ * — kept separate, used for fetch-by-arxiv-id and direct preprint
+ * search where 24h matters.
+ */
+const OPENALEX_API_BASE = 'https://api.openalex.org';
+/**
+ * Polite-pool email. Set via env var on the server. Empty string ok —
+ * the API still works, just with the lower anonymous rate limit.
+ */
+function politeMailto() {
+    return (typeof process !== 'undefined' && process.env?.OPENALEX_MAILTO) || '';
+}
+/**
+ * OpenAlex returns abstracts as inverted indices ({"word": [positions]})
+ * to avoid licensing-restricted full text. Reconstruct the prose form
+ * by walking positions and slotting words back into a string.
+ */
+function reconstructAbstract(inverted) {
+    if (!inverted)
+        return undefined;
+    const words = [];
+    for (const [word, positions] of Object.entries(inverted)) {
+        for (const pos of positions) {
+            words[pos] = word;
+        }
+    }
+    // Some positions may be undefined if upstream data is sparse — skip them.
+    return words.filter(Boolean).join(' ');
+}
+/**
+ * Strip the URL prefix from an OpenAlex ID. The API returns
+ * `https://openalex.org/W2741809807` but downstream callers want just
+ * the canonical `W2741809807` form.
+ */
+function bareOpenAlexId(id) {
+    if (!id)
+        return undefined;
+    return id.replace(/^https?:\/\/openalex\.org\//, '');
+}
+/**
+ * Strip the URL prefix from a DOI. OpenAlex returns
+ * `https://doi.org/10.xxxx/yyyy` but we store the bare DOI.
+ */
+function bareDoi(doi) {
+    if (!doi)
+        return undefined;
+    return doi.replace(/^https?:\/\/doi\.org\//, '');
+}
+/**
+ * Best-effort arXiv ID extraction from an OpenAlex work. arXiv preprints
+ * have DOIs of the form `10.48550/arXiv.YYMM.NNNNN` which encode the ID.
+ */
+function extractArxivId(work) {
+    const doi = bareDoi(work.doi ?? work.ids?.doi);
+    if (!doi)
+        return undefined;
+    const m = doi.match(/^10\.48550\/arXiv\.(.+)$/i);
+    return m?.[1];
+}
+function workToPaper(work) {
+    const title = work.title?.trim();
+    if (!title)
+        return null;
+    const openalex_id = bareOpenAlexId(work.id);
+    const doi = bareDoi(work.doi ?? work.ids?.doi);
+    const arxiv_id = extractArxivId(work);
+    if (!openalex_id && !doi && !arxiv_id)
+        return null;
+    const authors = (work.authorships ?? [])
+        .filter(a => a.author?.display_name)
+        .map(a => ({
+        name: a.author.display_name,
+        orcid: a.author.orcid,
+        affiliation: a.raw_affiliation_strings?.[0],
+    }));
+    // OpenAlex concepts are scored; pick the top level-0 concept as the
+    // discipline signal. Falls back to keyword inference downstream if
+    // none present.
+    const topConcept = (work.concepts ?? [])
+        .filter(c => c.level === 0)
+        .sort((a, b) => (b.score ?? 0) - (a.score ?? 0))[0];
+    const oa_pdf_url = work.best_oa_location?.pdf_url
+        ?? work.primary_location?.pdf_url
+        ?? undefined;
+    const primary_url = work.primary_location?.landing_page_url
+        ?? (doi ? `https://doi.org/${doi}` : undefined)
+        ?? (arxiv_id ? `https://arxiv.org/abs/${arxiv_id}` : undefined);
+    return {
+        doi,
+        arxiv_id,
+        openalex_id,
+        title,
+        authors,
+        abstract: reconstructAbstract(work.abstract_inverted_index),
+        year: work.publication_year,
+        primary_url,
+        oa_pdf_url,
+        discipline: openalexFieldToDiscipline(topConcept?.display_name),
+        source: 'openalex',
+        citation_count: work.cited_by_count,
+        retracted: work.is_retracted,
+    };
+}
+function buildSearchUrl(q) {
+    const params = new URLSearchParams();
+    params.set('search', q.q);
+    const filters = [];
+    if (q.yearMin)
+        filters.push(`from_publication_date:${q.yearMin}-01-01`);
+    if (q.yearMax)
+        filters.push(`to_publication_date:${q.yearMax}-12-31`);
+    if (filters.length > 0)
+        params.set('filter', filters.join(','));
+    if (q.sort === 'date')
+        params.set('sort', 'publication_date:desc');
+    else if (q.sort === 'cited')
+        params.set('sort', 'cited_by_count:desc');
+    // 'relevance' is default — no sort param
+    params.set('per_page', String(Math.min(q.perPage ?? 25, 100)));
+    params.set('page', String(Math.max(q.page ?? 1, 1)));
+    const mailto = politeMailto();
+    if (mailto)
+        params.set('mailto', mailto);
+    return `${OPENALEX_API_BASE}/works?${params.toString()}`;
+}
+export async function searchOpenAlex(query, signal) {
+    const url = buildSearchUrl(query);
+    try {
+        const res = await fetch(url, { signal });
+        if (!res.ok) {
+            logger.warn(`[openalex] search failed ${res.status} for "${query.q}"`);
+            return { papers: [], total: 0, page: query.page ?? 1, perPage: query.perPage ?? 25 };
+        }
+        const data = await res.json();
+        const papers = [];
+        for (const work of data.results ?? []) {
+            const paper = workToPaper(work);
+            if (paper)
+                papers.push(paper);
+        }
+        return {
+            papers,
+            total: data.meta?.count ?? papers.length,
+            page: data.meta?.page ?? query.page ?? 1,
+            perPage: data.meta?.per_page ?? query.perPage ?? 25,
+        };
+    }
+    catch (err) {
+        logger.warn(`[openalex] search error for "${query.q}": ${err instanceof Error ? err.message : String(err)}`);
+        return { papers: [], total: 0, page: query.page ?? 1, perPage: query.perPage ?? 25 };
+    }
+}
+/**
+ * Fetch a single OpenAlex work by ID, DOI, or arXiv ID. Resolves any
+ * of the three identifier types via OpenAlex's flexible /works/{id}
+ * endpoint which accepts `W123`, `doi:10.x/y`, or `mag:NNN` forms.
+ */
+export async function fetchPaperByOpenAlexId(identifier, signal) {
+    let path;
+    if (identifier.openalex_id) {
+        path = `/works/${identifier.openalex_id}`;
+    }
+    else if (identifier.doi) {
+        path = `/works/doi:${identifier.doi}`;
+    }
+    else if (identifier.arxiv_id) {
+        // OpenAlex indexes arXiv preprints under their DOI form
+        path = `/works/doi:10.48550/arXiv.${identifier.arxiv_id}`;
+    }
+    else {
+        return null;
+    }
+    const params = new URLSearchParams();
+    const mailto = politeMailto();
+    if (mailto)
+        params.set('mailto', mailto);
+    const url = `${OPENALEX_API_BASE}${path}${params.toString() ? `?${params.toString()}` : ''}`;
+    try {
+        const res = await fetch(url, { signal });
+        if (!res.ok) {
+            logger.warn(`[openalex] fetch failed ${res.status} for ${JSON.stringify(identifier)}`);
+            return null;
+        }
+        const work = await res.json();
+        return workToPaper(work);
+    }
+    catch (err) {
+        logger.warn(`[openalex] fetch error: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+//# sourceMappingURL=openalex-client.js.map

package/dist/papers/openalex-client.js.map

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

package/dist/papers/paper-fetcher.d.ts

@@ -0,0 +1,37 @@
+import type { Paper } from './types.js';
+/**
+ * Unified paper fetcher. Resolves a free-form identifier (arXiv ID,
+ * DOI, OpenAlex ID, or arXiv abstract URL) to a normalised `Paper`,
+ * trying each source in priority order. Returns null when no upstream
+ * can produce a row — the caller surfaces that as "not found".
+ *
+ * Priority for resolution:
+ *   1. arXiv if the identifier is an arxiv_id or an arxiv URL — fastest,
+ *      always has a deterministic full-text PDF URL.
+ *   2. OpenAlex for everything else — broadest cross-discipline coverage.
+ *   3. Crossref as the final fallback for DOIs that OpenAlex hasn't
+ *      indexed (rare, but happens for very recent journal DOIs).
+ */
+export interface FetchPaperInput {
+    /**
+     * Free-form identifier. Examples:
+     *   - '2310.06825'           (arXiv ID, no version)
+     *   - '2310.06825v2'         (arXiv ID with version — version stripped)
+     *   - 'https://arxiv.org/abs/2310.06825'
+     *   - '10.1038/nature12373'  (DOI)
+     *   - 'doi:10.1038/nature12373'
+     *   - 'https://doi.org/10.1038/nature12373'
+     *   - 'W2741809807'          (OpenAlex ID)
+     *   - 'https://openalex.org/W2741809807'
+     */
+    identifier: string;
+}
+interface ParsedIdentifier {
+    arxiv_id?: string;
+    doi?: string;
+    openalex_id?: string;
+}
+export declare function parseIdentifier(input: string): ParsedIdentifier;
+export declare function fetchPaper(input: FetchPaperInput, signal?: AbortSignal): Promise<Paper | null>;
+export {};
+//# sourceMappingURL=paper-fetcher.d.ts.map

package/dist/papers/paper-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paper-fetcher.d.ts","sourceRoot":"","sources":["../../src/papers/paper-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKxC;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;OAUG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAwBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CA6B/D;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAqBpG"}

package/dist/papers/paper-fetcher.js

@@ -0,0 +1,75 @@
+import { fetchPaperByArxivId } from './arxiv-client.js';
+import { fetchPaperByOpenAlexId } from './openalex-client.js';
+import { fetchPaperByDoi } from './crossref-client.js';
+/**
+ * Recognise an arxiv ID. Two formats:
+ *   - new-style: 4-digit YYMM + dot + 4-5 digit sequence (+ optional vN)
+ *   - old-style: subject prefix + slash + 7 digits (e.g. 'hep-th/0203074')
+ */
+function looksLikeArxivId(s) {
+    return /^\d{4}\.\d{4,5}(v\d+)?$/.test(s)
+        || /^[a-z-]+\/\d{7}(v\d+)?$/i.test(s);
+}
+function stripArxivVersion(s) {
+    return s.replace(/v\d+$/, '');
+}
+function looksLikeDoi(s) {
+    return /^10\.\d{4,9}\/\S+$/.test(s);
+}
+function looksLikeOpenAlexId(s) {
+    return /^W\d+$/.test(s);
+}
+export function parseIdentifier(input) {
+    const raw = input.trim();
+    // arXiv URL
+    const arxivUrlMatch = raw.match(/arxiv\.org\/(?:abs|pdf)\/([\d.]+(?:v\d+)?|[a-z-]+\/\d{7}(?:v\d+)?)/i);
+    if (arxivUrlMatch)
+        return { arxiv_id: stripArxivVersion(arxivUrlMatch[1]) };
+    // doi.org URL
+    const doiUrlMatch = raw.match(/doi\.org\/(.+)$/i);
+    if (doiUrlMatch)
+        return { doi: doiUrlMatch[1] };
+    // openalex.org URL
+    const openalexUrlMatch = raw.match(/openalex\.org\/(W\d+)/i);
+    if (openalexUrlMatch)
+        return { openalex_id: openalexUrlMatch[1] };
+    // Bare prefix forms
+    const doiPrefixMatch = raw.match(/^doi:(.+)$/i);
+    if (doiPrefixMatch)
+        return { doi: doiPrefixMatch[1] };
+    // Bare identifier forms
+    if (looksLikeArxivId(raw))
+        return { arxiv_id: stripArxivVersion(raw) };
+    if (looksLikeOpenAlexId(raw))
+        return { openalex_id: raw };
+    if (looksLikeDoi(raw))
+        return { doi: raw };
+    // Last-resort: if the string contains any DOI-shaped substring, lift it
+    const doiInside = raw.match(/(10\.\d{4,9}\/\S+)/);
+    if (doiInside)
+        return { doi: doiInside[1] };
+    return {};
+}
+export async function fetchPaper(input, signal) {
+    const ids = parseIdentifier(input.identifier);
+    if (!ids.arxiv_id && !ids.doi && !ids.openalex_id)
+        return null;
+    // Priority 1: arXiv
+    if (ids.arxiv_id) {
+        const arxivPaper = await fetchPaperByArxivId(ids.arxiv_id, signal);
+        if (arxivPaper)
+            return arxivPaper;
+    }
+    // Priority 2: OpenAlex (handles DOI, OpenAlex ID, and arXiv-via-DOI form)
+    const openalexPaper = await fetchPaperByOpenAlexId(ids, signal);
+    if (openalexPaper)
+        return openalexPaper;
+    // Priority 3: Crossref fallback for DOIs OpenAlex didn't index yet
+    if (ids.doi) {
+        const crossrefPaper = await fetchPaperByDoi(ids.doi, signal);
+        if (crossrefPaper)
+            return crossrefPaper;
+    }
+    return null;
+}
+//# sourceMappingURL=paper-fetcher.js.map

package/dist/papers/paper-fetcher.js.map

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

package/dist/papers/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Library → Papers types. These are the Ava-internal canonical shapes
+ * for scientific paper metadata, normalised across arXiv / OpenAlex /
+ * Crossref. Each upstream client returns a `Paper` regardless of source
+ * so callers don't branch on provenance.
+ */
+/** Discipline buckets surfaced as Featured-tab pivots. */
+export type PaperDiscipline = 'ai_cs' | 'biology' | 'medicine' | 'physics' | 'chemistry' | 'earth_sciences' | 'social_sciences' | 'economics' | 'engineering' | 'math' | 'other';
+export declare const ALL_DISCIPLINES: PaperDiscipline[];
+export declare const DISCIPLINE_LABELS: Record<PaperDiscipline, string>;
+export interface PaperAuthor {
+    name: string;
+    orcid?: string;
+    affiliation?: string;
+}
+/** Where this paper was sourced from at fetch time. */
+export type PaperSource = 'arxiv' | 'openalex' | 'crossref';
+/**
+ * Canonical paper shape used everywhere downstream. All upstream
+ * clients normalise to this so the UI and the Tutor's four-layer
+ * prompt don't have to know which API supplied the data.
+ *
+ * At least one of `doi` / `arxiv_id` / `openalex_id` is always set
+ * (the upstream clients fail rather than return identifierless rows).
+ */
+export interface Paper {
+    doi?: string;
+    arxiv_id?: string;
+    openalex_id?: string;
+    title: string;
+    authors: PaperAuthor[];
+    abstract?: string;
+    year?: number;
+    /** Preferred read link — arXiv PDF, OpenAlex landing page, or DOI URL. */
+    primary_url?: string;
+    /** Free / open-access full-text URL when known. */
+    oa_pdf_url?: string;
+    discipline?: PaperDiscipline;
+    /** Where this row came from at fetch time. */
+    source: PaperSource;
+    /** Times-cited count from upstream when available. */
+    citation_count?: number;
+    /** Preprint server tag like 'cs.AI', 'q-bio.QM'. arXiv only. */
+    arxiv_category?: string;
+    /** Whether the upstream marks this as withdrawn / retracted. */
+    retracted?: boolean;
+}
+export interface PaperSearchQuery {
+    q: string;
+    discipline?: PaperDiscipline;
+    /** ISO year. Defaults to no constraint. */
+    yearMin?: number;
+    yearMax?: number;
+    /** Sort key. 'relevance' is upstream default; 'date' = newest first. */
+    sort?: 'relevance' | 'date' | 'cited';
+    /** Page size. Upstream caps apply (OpenAlex 200, arXiv 2000). */
+    perPage?: number;
+    page?: number;
+}
+export interface PaperSearchResult {
+    papers: Paper[];
+    total: number;
+    page: number;
+    perPage: number;
+}
+/**
+ * Trending signals stored in the `paper_signals` table. The
+ * computed_score is a weighted blend tuned in `papers/trending.ts`.
+ */
+export interface PaperSignal {
+    paper_id: string;
+    citation_count: number;
+    citation_velocity_30d: number;
+    hn_score: number;
+    reddit_score: number;
+    social_mentions_7d: number;
+    computed_score: number;
+    last_updated: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/papers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/papers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,SAAS,GACT,UAAU,GACV,SAAS,GACT,WAAW,GACX,gBAAgB,GAChB,iBAAiB,GACjB,WAAW,GACX,aAAa,GACb,MAAM,GACN,OAAO,CAAC;AAEZ,eAAO,MAAM,eAAe,EAAE,eAAe,EAI5C,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAY7D,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,8CAA8C;IAC9C,MAAM,EAAE,WAAW,CAAC;IACpB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IACtC,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/papers/types.js

@@ -0,0 +1,25 @@
+/**
+ * Library → Papers types. These are the Ava-internal canonical shapes
+ * for scientific paper metadata, normalised across arXiv / OpenAlex /
+ * Crossref. Each upstream client returns a `Paper` regardless of source
+ * so callers don't branch on provenance.
+ */
+export const ALL_DISCIPLINES = [
+    'ai_cs', 'biology', 'medicine', 'physics', 'chemistry',
+    'earth_sciences', 'social_sciences', 'economics', 'engineering',
+    'math', 'other',
+];
+export const DISCIPLINE_LABELS = {
+    ai_cs: 'AI & CS',
+    biology: 'Biology',
+    medicine: 'Medicine',
+    physics: 'Physics',
+    chemistry: 'Chemistry',
+    earth_sciences: 'Earth Sciences',
+    social_sciences: 'Social Sciences',
+    economics: 'Economics',
+    engineering: 'Engineering',
+    math: 'Math',
+    other: 'Other',
+};
+//# sourceMappingURL=types.js.map

package/dist/papers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/papers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW;IACtD,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,aAAa;IAC/D,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAoC;IAChE,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACf,CAAC"}