@littlebearapps/australian-history-mcp 0.6.0

package/dist/sources/prov/tools/harvest.js

@@ -0,0 +1,112 @@
+/**
+ * PROV Harvest Tool - Bulk download records from PROV
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { runHarvest } from '../../../core/harvest-runner.js';
+import { provClient } from '../client.js';
+import { PROV_RECORD_FORMS } from '../types.js';
+export const provHarvestTool = {
+    schema: {
+        name: 'prov_harvest',
+        description: 'Bulk download PROV records with pagination.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search text',
+                },
+                series: {
+                    type: 'string',
+                    description: 'VPRS series number',
+                },
+                agency: {
+                    type: 'string',
+                    description: 'VA agency number',
+                },
+                recordForm: {
+                    type: 'string',
+                    description: 'Record type filter',
+                    enum: PROV_RECORD_FORMS,
+                },
+                dateFrom: {
+                    type: 'string',
+                    description: 'Start date (YYYY-MM-DD)',
+                },
+                dateTo: {
+                    type: 'string',
+                    description: 'End date (YYYY-MM-DD)',
+                },
+                digitisedOnly: {
+                    type: 'boolean',
+                    description: 'Only digitised records',
+                    default: false,
+                },
+                maxRecords: {
+                    type: 'number',
+                    description: 'Maximum records to harvest (1-1000)',
+                    default: 100,
+                },
+                startFrom: {
+                    type: 'number',
+                    description: 'Offset for pagination',
+                    default: 0,
+                },
+            },
+            required: [],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        // Validate at least one search parameter
+        if (!input.query && !input.series && !input.agency) {
+            return errorResponse('At least one of query, series, or agency is required');
+        }
+        try {
+            const maxRecords = Math.min(input.maxRecords ?? 100, 1000);
+            const startFrom = input.startFrom ?? 0;
+            // Build query description for response
+            const queryDesc = [
+                input.query && `query="${input.query}"`,
+                input.series && `series=${input.series}`,
+                input.agency && `agency=${input.agency}`,
+            ].filter(Boolean).join(', ');
+            const result = await runHarvest('prov', queryDesc, {
+                maxRecords,
+                batchSize: 100,
+                cursorMode: 'offset',
+                initialCursor: startFrom,
+                fetchBatch: async (offset, limit) => {
+                    const searchResult = await provClient.search({
+                        query: input.query,
+                        series: input.series,
+                        agency: input.agency,
+                        recordForm: input.recordForm,
+                        startDate: input.dateFrom,
+                        endDate: input.dateTo,
+                        digitisedOnly: input.digitisedOnly ?? false,
+                        rows: limit,
+                        start: offset,
+                    });
+                    return {
+                        records: searchResult.records,
+                        total: searchResult.totalResults,
+                        hasMore: offset + searchResult.records.length < searchResult.totalResults,
+                    };
+                },
+            });
+            return successResponse({
+                source: 'prov',
+                harvested: result.totalHarvested,
+                totalAvailable: result.totalAvailable,
+                hasMore: result.hasMore,
+                nextOffset: result.nextCursor?.toString(),
+                records: result.records,
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=harvest.js.map

package/dist/sources/prov/tools/harvest.js.map

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

package/dist/sources/prov/tools/images.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PROV IIIF Image Extraction Tool
+ *
+ * Fetches and parses IIIF manifests from PROV to extract
+ * downloadable image URLs in different sizes.
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const provGetImagesTool: SourceTool;
+//# sourceMappingURL=images.d.ts.map

package/dist/sources/prov/tools/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../../src/sources/prov/tools/images.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI/D,eAAO,MAAM,iBAAiB,EAAE,UAgE/B,CAAC"}

package/dist/sources/prov/tools/images.js

@@ -0,0 +1,67 @@
+/**
+ * PROV IIIF Image Extraction Tool
+ *
+ * Fetches and parses IIIF manifests from PROV to extract
+ * downloadable image URLs in different sizes.
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { provClient } from '../client.js';
+export const provGetImagesTool = {
+    schema: {
+        name: 'prov_get_images',
+        description: 'Extract image URLs from a PROV digitised record via IIIF manifest.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                manifestUrl: {
+                    type: 'string',
+                    description: 'IIIF manifest URL from search result',
+                },
+                pages: {
+                    type: 'string',
+                    description: 'Page filter (e.g., "1-5", "1,3,7")',
+                },
+                size: {
+                    type: 'string',
+                    enum: ['thumbnail', 'medium', 'full', 'all'],
+                    description: 'Which size URLs to return. Default: "all"',
+                },
+            },
+            required: ['manifestUrl'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        try {
+            const result = await provClient.getImages(input.manifestUrl, {
+                pageRange: input.pages,
+            });
+            // Filter to requested size(s)
+            const size = input.size ?? 'all';
+            const images = result.images.map((img) => {
+                if (size === 'all') {
+                    return img;
+                }
+                return {
+                    page: img.page,
+                    label: img.label,
+                    url: img[size],
+                };
+            });
+            return successResponse({
+                source: 'prov',
+                manifestUrl: result.manifestUrl,
+                title: result.title,
+                description: result.description,
+                totalPages: result.totalPages,
+                returnedPages: images.length,
+                size: size,
+                images,
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=images.js.map

package/dist/sources/prov/tools/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../../src/sources/prov/tools/images.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,MAAM,EAAE;QACN,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,oEAAoE;QACjF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oCAAoC;iBAClD;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC;oBAC5C,WAAW,EAAE,2CAA2C;iBACzD;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,KAAK,GAAG,IAIb,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE;gBAC3D,SAAS,EAAE,KAAK,CAAC,KAAK;aACvB,CAAC,CAAC;YAEH,8BAA8B;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACvC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;oBACnB,OAAO,GAAG,CAAC;gBACb,CAAC;gBACD,OAAO;oBACL,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC;iBACf,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,aAAa,EAAE,MAAM,CAAC,MAAM;gBAC5B,IAAI,EAAE,IAAI;gBACV,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/sources/prov/tools/search.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PROV Search Tool - Search the Public Record Office Victoria collection
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const provSearchTool: SourceTool;
+//# sourceMappingURL=search.d.ts.map

package/dist/sources/prov/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/sources/prov/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAK/D,eAAO,MAAM,cAAc,EAAE,UA6G5B,CAAC"}

package/dist/sources/prov/tools/search.js

@@ -0,0 +1,103 @@
+/**
+ * PROV Search Tool - Search the Public Record Office Victoria collection
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { provClient } from '../client.js';
+import { PROV_RECORD_FORMS, PROV_DOCUMENT_CATEGORIES } from '../types.js';
+export const provSearchTool = {
+    schema: {
+        name: 'prov_search',
+        description: 'Search PROV for Victorian state archives: photos, maps, records, council minutes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search text',
+                },
+                series: {
+                    type: 'string',
+                    description: 'VPRS series number',
+                },
+                agency: {
+                    type: 'string',
+                    description: 'VA agency number',
+                },
+                recordForm: {
+                    type: 'string',
+                    description: 'Record type filter',
+                    enum: PROV_RECORD_FORMS,
+                },
+                category: {
+                    type: 'string',
+                    description: 'Document category filter (agency, function, series, consignment, item, image)',
+                    enum: PROV_DOCUMENT_CATEGORIES,
+                },
+                dateFrom: {
+                    type: 'string',
+                    description: 'Start date (YYYY-MM-DD or YYYY)',
+                },
+                dateTo: {
+                    type: 'string',
+                    description: 'End date (YYYY-MM-DD or YYYY)',
+                },
+                digitisedOnly: {
+                    type: 'boolean',
+                    description: 'Only return records with digitised images',
+                    default: false,
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum results to return (1-100)',
+                    default: 20,
+                },
+            },
+            required: [],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        // Validate at least one search parameter
+        if (!input.query && !input.series && !input.agency) {
+            return errorResponse('At least one of query, series, or agency is required');
+        }
+        try {
+            const params = {
+                query: input.query,
+                series: input.series,
+                agency: input.agency,
+                recordForm: input.recordForm,
+                category: input.category,
+                startDate: input.dateFrom,
+                endDate: input.dateTo,
+                digitisedOnly: input.digitisedOnly ?? false,
+                rows: Math.min(input.limit ?? 20, 100),
+            };
+            const result = await provClient.search(params);
+            return successResponse({
+                source: 'prov',
+                totalResults: result.totalResults,
+                returned: result.records.length,
+                records: result.records.map(r => ({
+                    id: r.id,
+                    title: r.title,
+                    description: r.description?.substring(0, 200),
+                    series: r.series,
+                    seriesTitle: r.seriesTitle,
+                    agency: r.agency,
+                    recordForm: r.recordForm,
+                    dateRange: r.startDate && r.endDate
+                        ? `${r.startDate} - ${r.endDate}`
+                        : r.startDate || r.endDate,
+                    digitised: r.digitised,
+                    url: r.url,
+                    iiifManifest: r.iiifManifest,
+                })),
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/sources/prov/tools/search.js.map

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

package/dist/sources/prov/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * PROV (Public Record Office Victoria) Type Definitions
+ *
+ * Types specific to the PROV data source.
+ */
+export interface PROVSearchParams {
+    query?: string;
+    series?: string;
+    agency?: string;
+    category?: PROVDocumentCategory;
+    recordForm?: string;
+    startDate?: string;
+    endDate?: string;
+    digitisedOnly?: boolean;
+    rows?: number;
+    start?: number;
+}
+export interface PROVRecord {
+    id: string;
+    title: string;
+    description?: string;
+    series?: string;
+    seriesTitle?: string;
+    agency?: string;
+    agencyTitle?: string;
+    recordForm?: string;
+    startDate?: string;
+    endDate?: string;
+    iiifManifest?: string;
+    digitised: boolean;
+    url: string;
+}
+export interface PROVSearchResult {
+    totalResults: number;
+    start: number;
+    rows: number;
+    records: PROVRecord[];
+}
+export interface PROVSeries {
+    id: string;
+    title: string;
+    description?: string;
+    agency?: string;
+    agencyTitle?: string;
+    dateRange?: string;
+    accessStatus?: string;
+    itemCount?: number;
+}
+export interface PROVImage {
+    page: number;
+    label: string;
+    thumbnail: string;
+    medium: string;
+    full: string;
+}
+export interface PROVImagesResult {
+    manifestUrl: string;
+    title: string;
+    description?: string;
+    totalPages: number;
+    images: PROVImage[];
+}
+export declare const PROV_RECORD_FORMS: readonly ["Photograph or Image", "Map, Plan, or Drawing", "File", "Volume", "Document", "Card", "Object", "Moving Image", "Sound Recording"];
+export type PROVRecordForm = typeof PROV_RECORD_FORMS[number];
+export declare const PROV_DOCUMENT_CATEGORIES: readonly ["agency", "function", "series", "consignment", "item", "image"];
+export type PROVDocumentCategory = typeof PROV_DOCUMENT_CATEGORIES[number];
+export interface PROVAgency {
+    id: string;
+    title: string;
+    description?: string;
+    dateRange?: string;
+    status?: string;
+    seriesCount?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sources/prov/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sources/prov/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAMD,eAAO,MAAM,iBAAiB,8IAUpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAM9D,eAAO,MAAM,wBAAwB,2EAO3B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAM3E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/sources/prov/types.js

@@ -0,0 +1,31 @@
+/**
+ * PROV (Public Record Office Victoria) Type Definitions
+ *
+ * Types specific to the PROV data source.
+ */
+// ============================================================================
+// Record Form Enum
+// ============================================================================
+export const PROV_RECORD_FORMS = [
+    'Photograph or Image',
+    'Map, Plan, or Drawing',
+    'File',
+    'Volume',
+    'Document',
+    'Card',
+    'Object',
+    'Moving Image',
+    'Sound Recording',
+];
+// ============================================================================
+// Document Category Enum
+// ============================================================================
+export const PROV_DOCUMENT_CATEGORIES = [
+    'agency',
+    'function',
+    'series',
+    'consignment',
+    'item',
+    'image',
+];
+//# sourceMappingURL=types.js.map

package/dist/sources/prov/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sources/prov/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6EH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,qBAAqB;IACrB,uBAAuB;IACvB,MAAM;IACN,QAAQ;IACR,UAAU;IACV,MAAM;IACN,QAAQ;IACR,cAAc;IACd,iBAAiB;CACT,CAAC;AAIX,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,aAAa;IACb,MAAM;IACN,OAAO;CACC,CAAC"}

package/dist/sources/trove/client.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Trove (National Library of Australia) API Client
+ *
+ * The Trove API v3 provides access to the National Library's digitised
+ * collections including newspapers, books, images, maps, and more.
+ *
+ * API Documentation: https://trove.nla.gov.au/about/create-something/using-api/v3/api-technical-guide
+ * API Console: https://troveconsole.herokuapp.com/
+ */
+import { BaseClient } from '../../core/base-client.js';
+import { type TroveSearchParams, type TroveSearchResult, type TroveNewspaperTitle, type TroveTitleDetail, type TroveArticleDetail, type TroveState, type TroveContributor, type TroveMagazineTitle, type TroveWorkDetail, type TrovePerson, type TrovePersonSearchResult, type TroveList, type TroveMagazineTitleDetail, type TroveRecLevel, type TroveIncludeOption } from './types.js';
+export declare class TroveClient extends BaseClient {
+    private readonly apiKey;
+    constructor(apiKey?: string);
+    /**
+     * Search across Trove categories
+     */
+    search(params: TroveSearchParams): Promise<TroveSearchResult>;
+    /**
+     * Get a newspaper article by ID
+     */
+    getNewspaperArticle(articleId: string, includeText?: boolean): Promise<TroveArticleDetail | null>;
+    /**
+     * Get a gazette article by ID
+     */
+    getGazetteArticle(articleId: string, includeText?: boolean): Promise<TroveArticleDetail | null>;
+    /**
+     * List newspaper titles
+     */
+    listNewspaperTitles(state?: TroveState): Promise<TroveNewspaperTitle[]>;
+    /**
+     * List gazette titles
+     */
+    listGazetteTitles(state?: string): Promise<TroveNewspaperTitle[]>;
+    /**
+     * Get details of a specific newspaper/gazette title
+     */
+    getTitleDetails(titleId: string, options?: {
+        includeYears?: boolean;
+        dateRange?: {
+            from: string;
+            to: string;
+        };
+        type?: 'newspaper' | 'gazette';
+    }): Promise<TroveTitleDetail | null>;
+    /**
+     * Check if API key is configured
+     */
+    hasApiKey(): boolean;
+    /**
+     * Get contributor (library/archive) details by NUC code
+     */
+    getContributor(nuc: string): Promise<TroveContributor | null>;
+    /**
+     * List magazine titles
+     */
+    listMagazineTitles(): Promise<TroveMagazineTitle[]>;
+    /**
+     * Get a work by ID (books, images, maps, music, archives)
+     */
+    getWork(workId: string, options?: {
+        reclevel?: TroveRecLevel;
+        include?: TroveIncludeOption[];
+    }): Promise<TroveWorkDetail | null>;
+    /**
+     * Get a user-curated list by ID
+     */
+    getList(listId: string, options?: {
+        include?: ('listitems')[];
+    }): Promise<TroveList | null>;
+    /**
+     * Get a person or organisation by ID
+     */
+    getPerson(personId: string, options?: {
+        reclevel?: TroveRecLevel;
+    }): Promise<TrovePerson | null>;
+    /**
+     * List or search contributors (libraries, archives, institutions)
+     */
+    listContributors(options?: {
+        query?: string;
+        reclevel?: TroveRecLevel;
+    }): Promise<TroveContributor[]>;
+    /**
+     * Get magazine title details with years/issues
+     */
+    getMagazineTitle(titleId: string, options?: {
+        includeYears?: boolean;
+        dateRange?: string;
+    }): Promise<TroveMagazineTitleDetail | null>;
+    /**
+     * Search for people and organisations
+     */
+    searchPeople(query: string, options?: {
+        limit?: number;
+        start?: string;
+        type?: 'Person' | 'Organisation' | 'Family';
+    }): Promise<TrovePersonSearchResult>;
+    private fetchWithAuth;
+    private parseSearchResponse;
+    private parseArticle;
+    private parseArticleDetail;
+    private parseWork;
+    private parseNewspaperTitles;
+    private parseTitleDetail;
+    private extractThumbnail;
+    private parseContributor;
+    private parseMagazineTitles;
+    private parseWorkDetail;
+    private parseHoldings;
+    private extractHoldingUrl;
+    private extractCallNumber;
+    private extractLanguage;
+    private extractBiography;
+    private extractContributorList;
+    private parseLinks;
+    private parseVersions;
+    private extractIdentifier;
+    private parseList;
+    private extractListDate;
+    private parseListItems;
+    private parsePerson;
+    private parseContributorList;
+    private parseMagazineTitleDetail;
+    private parsePersonSearchResponse;
+}
+export declare const troveClient: TroveClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/sources/trove/client.d.ts.map

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