@debriefer/sources 1.0.1

package/dist/archives/europeana.js.map

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

package/dist/archives/internet-archive.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Internet Archive source.
+ *
+ * Queries the Internet Archive advanced search API for books, documents,
+ * and media about a research subject. No authentication required.
+ */
+import { BaseResearchSource, ReliabilityTier, type BaseSourceOptions, type ResearchSubject, type RawFinding } from "@debriefer/core";
+export type InternetArchiveOptions = BaseSourceOptions;
+/**
+ * Research source backed by the Internet Archive advanced search API.
+ *
+ * Searches for books, documents, and media about a subject.
+ * Free, no API key required.
+ */
+export declare class InternetArchiveSource extends BaseResearchSource<ResearchSubject> {
+    readonly name = "Internet Archive";
+    readonly type = "internet-archive";
+    readonly reliabilityTier = ReliabilityTier.ARCHIVE_MIRROR;
+    readonly domain = "archive.org";
+    readonly isFree = true;
+    readonly estimatedCostPerQuery = 0;
+    constructor(options?: InternetArchiveOptions);
+    protected fetchResult(subject: ResearchSubject, signal: AbortSignal): Promise<RawFinding | null>;
+}
+/**
+ * Create an Internet Archive source instance.
+ *
+ * @param options - Source options (rateLimitMs, etc.)
+ * @returns A configured InternetArchiveSource
+ */
+export declare function internetArchive(options?: InternetArchiveOptions): InternetArchiveSource;
+//# sourceMappingURL=internet-archive.d.ts.map

package/dist/archives/internet-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internet-archive.d.ts","sourceRoot":"","sources":["../../src/archives/internet-archive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAcxB,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAA;AAqBtD;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IAC5E,QAAQ,CAAC,IAAI,sBAAqB;IAClC,QAAQ,CAAC,IAAI,sBAAqB;IAClC,QAAQ,CAAC,eAAe,kCAAiC;IACzD,QAAQ,CAAC,MAAM,iBAAgB;IAC/B,QAAQ,CAAC,MAAM,QAAO;IACtB,QAAQ,CAAC,qBAAqB,KAAI;gBAEtB,OAAO,GAAE,sBAA2B;cAIhC,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAgD9B;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,qBAAqB,CAEvF"}

package/dist/archives/internet-archive.js

@@ -0,0 +1,90 @@
+/**
+ * Internet Archive source.
+ *
+ * Queries the Internet Archive advanced search API for books, documents,
+ * and media about a research subject. No authentication required.
+ */
+import { BaseResearchSource, ReliabilityTier, } from "@debriefer/core";
+import { sanitizeSourceText } from "../shared/sanitize-text.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const IA_API_URL = "https://archive.org/advancedsearch.php";
+const IA_DETAILS_BASE = "https://archive.org/details/";
+// ============================================================================
+// InternetArchiveSource
+// ============================================================================
+/**
+ * Research source backed by the Internet Archive advanced search API.
+ *
+ * Searches for books, documents, and media about a subject.
+ * Free, no API key required.
+ */
+export class InternetArchiveSource extends BaseResearchSource {
+    name = "Internet Archive";
+    type = "internet-archive";
+    reliabilityTier = ReliabilityTier.ARCHIVE_MIRROR;
+    domain = "archive.org";
+    isFree = true;
+    estimatedCostPerQuery = 0;
+    constructor(options = {}) {
+        super({ rateLimitMs: 1000, ...options });
+    }
+    async fetchResult(subject, signal) {
+        const url = new URL(IA_API_URL);
+        url.searchParams.set("q", `"${subject.name}" AND (biography OR memoir)`);
+        url.searchParams.append("fl[]", "identifier");
+        url.searchParams.append("fl[]", "title");
+        url.searchParams.append("fl[]", "description");
+        url.searchParams.append("fl[]", "creator");
+        url.searchParams.append("sort[]", "downloads desc");
+        url.searchParams.set("rows", "5");
+        url.searchParams.set("output", "json");
+        const response = await fetch(url.toString(), { signal });
+        if (!response.ok) {
+            throw new Error(`Internet Archive API error: HTTP ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (!data.response?.docs?.length)
+            return null;
+        // Combine title + description from all docs
+        const parts = [];
+        for (const doc of data.response.docs) {
+            if (doc.title)
+                parts.push(doc.title);
+            if (doc.description)
+                parts.push(doc.description);
+        }
+        const text = parts.join("\n\n");
+        if (!text.trim())
+            return null;
+        const sanitized = sanitizeSourceText(text);
+        if (!sanitized)
+            return null;
+        const firstDoc = data.response.docs[0];
+        const resultUrl = firstDoc?.identifier ? `${IA_DETAILS_BASE}${firstDoc.identifier}` : undefined;
+        return {
+            text: sanitized,
+            confidence: -1,
+            costUsd: 0,
+            url: resultUrl,
+            publication: "Internet Archive",
+            metadata: {
+                title: firstDoc?.title ?? "",
+            },
+        };
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create an Internet Archive source instance.
+ *
+ * @param options - Source options (rateLimitMs, etc.)
+ * @returns A configured InternetArchiveSource
+ */
+export function internetArchive(options) {
+    return new InternetArchiveSource(options);
+}
+//# sourceMappingURL=internet-archive.js.map

package/dist/archives/internet-archive.js.map

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

package/dist/archives/trove.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Trove (National Library of Australia) source.
+ *
+ * Queries the Trove API v3 for newspaper articles about a research subject.
+ * Requires a free API key from the National Library of Australia.
+ */
+import { BaseResearchSource, ReliabilityTier, type BaseSourceOptions, type ResearchSubject, type RawFinding } from "@debriefer/core";
+export interface TroveOptions extends BaseSourceOptions {
+    /** Trove API key. Defaults to process.env.TROVE_API_KEY. */
+    apiKey?: string;
+}
+/**
+ * Research source backed by the Trove API (National Library of Australia).
+ *
+ * Searches digitized Australian newspapers for biographical content
+ * about a subject. Requires a free API key.
+ */
+export declare class TroveSource extends BaseResearchSource<ResearchSubject> {
+    readonly name = "Trove";
+    readonly type = "trove";
+    readonly reliabilityTier = ReliabilityTier.ARCHIVAL;
+    readonly domain = "api.trove.nla.gov.au";
+    readonly isFree = true;
+    readonly estimatedCostPerQuery = 0;
+    private apiKey;
+    constructor(options?: TroveOptions);
+    isAvailable(): boolean;
+    protected fetchResult(subject: ResearchSubject, signal: AbortSignal): Promise<RawFinding | null>;
+}
+/**
+ * Create a Trove source instance.
+ *
+ * @param options - Trove-specific options (apiKey, rateLimitMs, etc.)
+ * @returns A configured TroveSource
+ */
+export declare function trove(options?: TroveOptions): TroveSource;
+//# sourceMappingURL=trove.d.ts.map

package/dist/archives/trove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trove.d.ts","sourceRoot":"","sources":["../../src/archives/trove.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAaxB,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AA0BD;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IAClE,QAAQ,CAAC,IAAI,WAAU;IACvB,QAAQ,CAAC,IAAI,WAAU;IACvB,QAAQ,CAAC,eAAe,4BAA2B;IACnD,QAAQ,CAAC,MAAM,0BAAyB;IACxC,QAAQ,CAAC,MAAM,QAAO;IACtB,QAAQ,CAAC,qBAAqB,KAAI;IAElC,OAAO,CAAC,MAAM,CAAoB;gBAEtB,OAAO,GAAE,YAAiB;IAK7B,WAAW,IAAI,OAAO;cAIf,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAmD9B;AAMD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAEzD"}

package/dist/archives/trove.js

@@ -0,0 +1,97 @@
+/**
+ * Trove (National Library of Australia) source.
+ *
+ * Queries the Trove API v3 for newspaper articles about a research subject.
+ * Requires a free API key from the National Library of Australia.
+ */
+import { BaseResearchSource, ReliabilityTier, } from "@debriefer/core";
+import { sanitizeSourceText } from "../shared/sanitize-text.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const TROVE_API_URL = "https://api.trove.nla.gov.au/v3/result";
+// ============================================================================
+// TroveSource
+// ============================================================================
+/**
+ * Research source backed by the Trove API (National Library of Australia).
+ *
+ * Searches digitized Australian newspapers for biographical content
+ * about a subject. Requires a free API key.
+ */
+export class TroveSource extends BaseResearchSource {
+    name = "Trove";
+    type = "trove";
+    reliabilityTier = ReliabilityTier.ARCHIVAL;
+    domain = "api.trove.nla.gov.au";
+    isFree = true;
+    estimatedCostPerQuery = 0;
+    apiKey;
+    constructor(options = {}) {
+        super({ rateLimitMs: 1000, ...options });
+        this.apiKey = options.apiKey ?? process.env.TROVE_API_KEY;
+    }
+    isAvailable() {
+        return Boolean(this.apiKey);
+    }
+    async fetchResult(subject, signal) {
+        if (!this.apiKey)
+            return null;
+        const url = new URL(TROVE_API_URL);
+        url.searchParams.set("key", this.apiKey);
+        url.searchParams.set("q", `"${subject.name}" biography`);
+        url.searchParams.set("category", "newspaper");
+        url.searchParams.set("encoding", "json");
+        url.searchParams.set("n", "5");
+        const response = await fetch(url.toString(), { signal });
+        if (!response.ok) {
+            throw new Error(`Trove API error: HTTP ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        const articles = data.category?.[0]?.records?.article;
+        if (!articles?.length)
+            return null;
+        // Combine heading + cleaned snippet from all articles
+        const parts = [];
+        for (const article of articles) {
+            if (article.heading)
+                parts.push(article.heading);
+            if (article.snippet) {
+                // Strip HTML tags from snippets
+                const cleaned = article.snippet.replace(/<[^>]+>/g, "");
+                if (cleaned.trim())
+                    parts.push(cleaned);
+            }
+        }
+        const text = parts.join("\n\n");
+        if (!text.trim())
+            return null;
+        const sanitized = sanitizeSourceText(text);
+        if (!sanitized)
+            return null;
+        const firstWithUrl = articles.find((a) => a.troveUrl);
+        return {
+            text: sanitized,
+            confidence: -1,
+            costUsd: 0,
+            url: firstWithUrl?.troveUrl,
+            publication: "Trove (National Library of Australia)",
+            metadata: {
+                title: articles[0]?.heading ?? "",
+            },
+        };
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a Trove source instance.
+ *
+ * @param options - Trove-specific options (apiKey, rateLimitMs, etc.)
+ * @returns A configured TroveSource
+ */
+export function trove(options) {
+    return new TroveSource(options);
+}
+//# sourceMappingURL=trove.js.map

package/dist/archives/trove.js.map

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

package/dist/books/google-books.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Google Books API source.
+ *
+ * Searches Google Books for volumes matching the research subject,
+ * extracts text snippets and descriptions, and returns the best
+ * match as a finding.
+ *
+ * Requires a Google Books API key (https://developers.google.com/books).
+ */
+import { BaseResearchSource, ReliabilityTier, type BaseSourceOptions, type ResearchSubject, type RawFinding } from "@debriefer/core";
+export interface GoogleBooksOptions extends BaseSourceOptions {
+    /** Google Books API key. Defaults to process.env.GOOGLE_BOOKS_API_KEY. */
+    apiKey?: string;
+}
+/**
+ * Research source backed by the Google Books API.
+ *
+ * Searches for volumes about a subject, picks the first item with
+ * enough combined text (snippet + description), and returns the
+ * sanitized result.
+ */
+export declare class GoogleBooksSource extends BaseResearchSource<ResearchSubject> {
+    readonly name = "Google Books";
+    readonly type = "google-books";
+    readonly reliabilityTier = ReliabilityTier.SECONDARY_COMPILATION;
+    readonly domain = "www.googleapis.com";
+    readonly isFree = true;
+    readonly estimatedCostPerQuery = 0;
+    private apiKey;
+    constructor(options?: GoogleBooksOptions);
+    isAvailable(): boolean;
+    protected fetchResult(subject: ResearchSubject, signal: AbortSignal): Promise<RawFinding | null>;
+    /**
+     * Extract and combine text from a Google Books volume.
+     *
+     * Combines the text snippet (with HTML tags stripped and entities decoded)
+     * and the description into a single string.
+     */
+    private extractText;
+}
+/**
+ * Create a Google Books API source instance.
+ *
+ * @param options - Google Books-specific options (apiKey, rateLimitMs, etc.)
+ * @returns A configured GoogleBooksSource
+ */
+export declare function googleBooks(options?: GoogleBooksOptions): GoogleBooksSource;
+//# sourceMappingURL=google-books.d.ts.map

package/dist/books/google-books.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-books.d.ts","sourceRoot":"","sources":["../../src/books/google-books.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAcxB,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AA0BD;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IACxE,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,eAAe,yCAAwC;IAChE,QAAQ,CAAC,MAAM,wBAAuB;IACtC,QAAQ,CAAC,MAAM,QAAO;IACtB,QAAQ,CAAC,qBAAqB,KAAI;IAElC,OAAO,CAAC,MAAM,CAAoB;gBAEtB,OAAO,GAAE,kBAAuB;IAKnC,WAAW,IAAI,OAAO;cAIf,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA6C7B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAepB;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAE3E"}

package/dist/books/google-books.js

@@ -0,0 +1,111 @@
+/**
+ * Google Books API source.
+ *
+ * Searches Google Books for volumes matching the research subject,
+ * extracts text snippets and descriptions, and returns the best
+ * match as a finding.
+ *
+ * Requires a Google Books API key (https://developers.google.com/books).
+ */
+import { BaseResearchSource, ReliabilityTier, } from "@debriefer/core";
+import { decodeHtmlEntities } from "../shared/html-utils.js";
+import { sanitizeSourceText } from "../shared/sanitize-text.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const GOOGLE_BOOKS_API_URL = "https://www.googleapis.com/books/v1/volumes";
+// ============================================================================
+// GoogleBooksSource
+// ============================================================================
+/**
+ * Research source backed by the Google Books API.
+ *
+ * Searches for volumes about a subject, picks the first item with
+ * enough combined text (snippet + description), and returns the
+ * sanitized result.
+ */
+export class GoogleBooksSource extends BaseResearchSource {
+    name = "Google Books";
+    type = "google-books";
+    reliabilityTier = ReliabilityTier.SECONDARY_COMPILATION;
+    domain = "www.googleapis.com";
+    isFree = true;
+    estimatedCostPerQuery = 0;
+    apiKey;
+    constructor(options = {}) {
+        super({ rateLimitMs: 1000, ...options });
+        this.apiKey = options.apiKey ?? process.env.GOOGLE_BOOKS_API_KEY;
+    }
+    isAvailable() {
+        return Boolean(this.apiKey);
+    }
+    async fetchResult(subject, signal) {
+        if (!this.apiKey)
+            return null;
+        const query = `"${subject.name}" biography`;
+        const url = new URL(GOOGLE_BOOKS_API_URL);
+        url.searchParams.set("q", query);
+        url.searchParams.set("key", this.apiKey);
+        url.searchParams.set("maxResults", "5");
+        const response = await fetch(url.toString(), { signal });
+        if (!response.ok) {
+            throw new Error(`Google Books API error: HTTP ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (!data.items?.length)
+            return null;
+        // Pick first item with enough combined text
+        for (const item of data.items) {
+            const combined = this.extractText(item);
+            if (combined.length >= 100) {
+                const sanitized = sanitizeSourceText(combined);
+                if (sanitized.length < 50)
+                    continue;
+                return {
+                    text: sanitized,
+                    confidence: -1,
+                    costUsd: 0,
+                    url: item.volumeInfo.infoLink,
+                    publication: "Google Books",
+                    metadata: {
+                        title: item.volumeInfo.title,
+                        authors: item.volumeInfo.authors,
+                        publishedDate: item.volumeInfo.publishedDate,
+                    },
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract and combine text from a Google Books volume.
+     *
+     * Combines the text snippet (with HTML tags stripped and entities decoded)
+     * and the description into a single string.
+     */
+    extractText(item) {
+        const parts = [];
+        if (item.searchInfo?.textSnippet) {
+            // Strip <b> and other HTML tags, then decode entities
+            const stripped = item.searchInfo.textSnippet.replace(/<[^>]+>/g, "");
+            parts.push(decodeHtmlEntities(stripped));
+        }
+        if (item.volumeInfo.description) {
+            parts.push(item.volumeInfo.description);
+        }
+        return parts.join(" ").trim();
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a Google Books API source instance.
+ *
+ * @param options - Google Books-specific options (apiKey, rateLimitMs, etc.)
+ * @returns A configured GoogleBooksSource
+ */
+export function googleBooks(options) {
+    return new GoogleBooksSource(options);
+}
+//# sourceMappingURL=google-books.js.map

package/dist/books/google-books.js.map

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

package/dist/books/open-library.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Open Library search source.
+ *
+ * Queries the Open Library Search API for books matching the research
+ * subject. Returns book metadata (title, authors, publication year)
+ * as a finding. No API key required.
+ *
+ * https://openlibrary.org/dev/docs/api/search
+ */
+import { BaseResearchSource, ReliabilityTier, type BaseSourceOptions, type ResearchSubject, type RawFinding } from "@debriefer/core";
+export type OpenLibraryOptions = BaseSourceOptions;
+/**
+ * Research source backed by the Open Library Search API.
+ *
+ * Searches for books about a subject, picks the first result with
+ * a title, and returns a combined attribution string (including any
+ * available authors and publication year) as the finding text.
+ */
+export declare class OpenLibrarySource extends BaseResearchSource<ResearchSubject> {
+    readonly name = "Open Library";
+    readonly type = "open-library";
+    readonly reliabilityTier = ReliabilityTier.SECONDARY_COMPILATION;
+    readonly domain = "openlibrary.org";
+    readonly isFree = true;
+    readonly estimatedCostPerQuery = 0;
+    constructor(options?: OpenLibraryOptions);
+    isAvailable(): boolean;
+    protected fetchResult(subject: ResearchSubject, signal: AbortSignal): Promise<RawFinding | null>;
+    /**
+     * Build attribution text from an Open Library document.
+     *
+     * Combines title, author names, and publication year into a
+     * human-readable string.
+     */
+    private buildText;
+}
+/**
+ * Create an Open Library source instance.
+ *
+ * @param options - Open Library-specific options (rateLimitMs, etc.)
+ * @returns A configured OpenLibrarySource
+ */
+export declare function openLibrary(options?: OpenLibraryOptions): OpenLibrarySource;
+//# sourceMappingURL=open-library.d.ts.map

package/dist/books/open-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-library.d.ts","sourceRoot":"","sources":["../../src/books/open-library.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAYxB,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAA;AAqBlD;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IACxE,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,eAAe,yCAAwC;IAChE,QAAQ,CAAC,MAAM,qBAAoB;IACnC,QAAQ,CAAC,MAAM,QAAO;IACtB,QAAQ,CAAC,qBAAqB,KAAI;gBAEtB,OAAO,GAAE,kBAAuB;IAInC,WAAW,IAAI,OAAO;cAIf,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAwC7B;;;;;OAKG;IACH,OAAO,CAAC,SAAS;CAiBlB;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAE3E"}

package/dist/books/open-library.js

@@ -0,0 +1,103 @@
+/**
+ * Open Library search source.
+ *
+ * Queries the Open Library Search API for books matching the research
+ * subject. Returns book metadata (title, authors, publication year)
+ * as a finding. No API key required.
+ *
+ * https://openlibrary.org/dev/docs/api/search
+ */
+import { BaseResearchSource, ReliabilityTier, } from "@debriefer/core";
+// ============================================================================
+// Constants
+// ============================================================================
+const OPEN_LIBRARY_SEARCH_URL = "https://openlibrary.org/search.json";
+// ============================================================================
+// OpenLibrarySource
+// ============================================================================
+/**
+ * Research source backed by the Open Library Search API.
+ *
+ * Searches for books about a subject, picks the first result with
+ * a title, and returns a combined attribution string (including any
+ * available authors and publication year) as the finding text.
+ */
+export class OpenLibrarySource extends BaseResearchSource {
+    name = "Open Library";
+    type = "open-library";
+    reliabilityTier = ReliabilityTier.SECONDARY_COMPILATION;
+    domain = "openlibrary.org";
+    isFree = true;
+    estimatedCostPerQuery = 0;
+    constructor(options = {}) {
+        super({ rateLimitMs: 350, ...options });
+    }
+    isAvailable() {
+        return true;
+    }
+    async fetchResult(subject, signal) {
+        const query = `"${subject.name}" biography`;
+        const url = new URL(OPEN_LIBRARY_SEARCH_URL);
+        url.searchParams.set("q", query);
+        url.searchParams.set("limit", "5");
+        const response = await fetch(url.toString(), { signal });
+        if (!response.ok) {
+            throw new Error(`Open Library API error: HTTP ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (!data.docs?.length)
+            return null;
+        // Pick the first doc with a title
+        const doc = data.docs.find((d) => d.title);
+        if (!doc)
+            return null;
+        const text = this.buildText(doc);
+        if (!text)
+            return null;
+        const docUrl = doc.key ? `https://openlibrary.org${doc.key}` : undefined;
+        return {
+            text,
+            confidence: -1,
+            costUsd: 0,
+            url: docUrl,
+            publication: "Open Library",
+            metadata: {
+                title: doc.title,
+                authors: doc.author_name,
+                firstPublishYear: doc.first_publish_year,
+            },
+        };
+    }
+    /**
+     * Build attribution text from an Open Library document.
+     *
+     * Combines title, author names, and publication year into a
+     * human-readable string.
+     */
+    buildText(doc) {
+        const parts = [];
+        if (doc.title) {
+            parts.push(doc.title);
+        }
+        if (doc.author_name?.length) {
+            parts.push(`by ${doc.author_name.join(", ")}`);
+        }
+        if (doc.first_publish_year) {
+            parts.push(`(${doc.first_publish_year})`);
+        }
+        return parts.length > 0 ? parts.join(" ") : null;
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create an Open Library source instance.
+ *
+ * @param options - Open Library-specific options (rateLimitMs, etc.)
+ * @returns A configured OpenLibrarySource
+ */
+export function openLibrary(options) {
+    return new OpenLibrarySource(options);
+}
+//# sourceMappingURL=open-library.js.map

package/dist/books/open-library.js.map

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