@littlebearapps/australian-history-mcp 0.6.0

package/dist/tools/harvest.js

@@ -0,0 +1,426 @@
+/**
+ * Harvest Tools - Bulk download records from PROV, Trove, and data.gov.au
+ */
+import { provClient } from '../clients/prov_client.js';
+import { createTroveClient } from '../clients/trove_client.js';
+import { dataGovAUClient } from '../clients/datagovau_client.js';
+// ============================================================================
+// PROV Harvest
+// ============================================================================
+export const provHarvestSchema = {
+    name: 'prov_harvest',
+    description: `Bulk download records from the PROV (Public Record Office Victoria) collection.
+
+Use this for batch harvesting of:
+- Historical photographs
+- Maps and plans
+- Government files and records
+- Council meeting minutes
+
+Returns paginated results for large datasets.`,
+    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: 'Type of record (e.g., "Photograph or Image", "File", "Volume")',
+                enum: [
+                    'Photograph or Image',
+                    'Map, Plan, or Drawing',
+                    'File',
+                    'Volume',
+                    'Document',
+                    'Card',
+                    'Object',
+                    'Moving Image',
+                    'Sound Recording',
+                ],
+            },
+            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: [],
+    },
+};
+export async function executePROVHarvest(input) {
+    try {
+        if (!input.query && !input.series && !input.agency) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'At least one of query, series, or agency is required',
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        const maxRecords = Math.min(input.maxRecords ?? 100, 1000);
+        const batchSize = 100;
+        let start = input.startFrom ?? 0;
+        const allRecords = [];
+        let totalAvailable = 0;
+        // Harvest in batches
+        while (allRecords.length < maxRecords) {
+            const remaining = maxRecords - allRecords.length;
+            const rows = Math.min(batchSize, remaining);
+            const result = 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,
+                start,
+            });
+            totalAvailable = result.totalResults;
+            allRecords.push(...result.records);
+            // Stop if no more results
+            if (result.records.length < rows) {
+                break;
+            }
+            start += rows;
+        }
+        const hasMore = allRecords.length < totalAvailable;
+        const nextOffset = hasMore ? start.toString() : undefined;
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'prov',
+                        harvested: allRecords.length,
+                        totalAvailable,
+                        hasMore,
+                        nextOffset,
+                        records: allRecords.map((r) => ({
+                            id: r.id,
+                            title: r.title,
+                            series: r.series,
+                            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,
+                        })),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// Trove Harvest
+// ============================================================================
+export const troveHarvestSchema = {
+    name: 'trove_harvest',
+    description: `Bulk download records from Trove (National Library of Australia).
+
+Use this for batch harvesting of:
+- Newspaper articles for a topic/date range
+- Historical images and maps
+- Government publications
+- Research materials
+
+Uses stable cursor-based pagination for reliable harvesting.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search terms',
+            },
+            category: {
+                type: 'string',
+                description: 'Content category',
+                enum: ['all', 'newspaper', 'gazette', 'magazine', 'image', 'book', 'diary', 'music', 'research'],
+                default: 'all',
+            },
+            state: {
+                type: 'string',
+                description: 'Filter by state (newspapers)',
+                enum: ['vic', 'nsw', 'qld', 'sa', 'wa', 'tas', 'nt', 'act', 'national'],
+            },
+            dateFrom: {
+                type: 'string',
+                description: 'Start date (YYYY)',
+            },
+            dateTo: {
+                type: 'string',
+                description: 'End date (YYYY)',
+            },
+            format: {
+                type: 'string',
+                description: 'Format filter (e.g., "Photograph", "Map")',
+            },
+            maxRecords: {
+                type: 'number',
+                description: 'Maximum records to harvest (1-1000)',
+                default: 100,
+            },
+            cursor: {
+                type: 'string',
+                description: 'Pagination cursor from previous harvest',
+            },
+            includeFullText: {
+                type: 'boolean',
+                description: 'Include article text (newspapers only)',
+                default: false,
+            },
+        },
+        required: ['query'],
+    },
+};
+export async function executeTroveHarvest(input) {
+    try {
+        const client = createTroveClient();
+        if (!client.hasApiKey()) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'TROVE_API_KEY not configured',
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        const maxRecords = Math.min(input.maxRecords ?? 100, 1000);
+        const batchSize = 100; // Trove max per request
+        let cursor = input.cursor ?? '*';
+        const allRecords = [];
+        let totalAvailable = 0;
+        // Harvest in batches using bulk harvest mode
+        while (allRecords.length < maxRecords) {
+            const remaining = maxRecords - allRecords.length;
+            const limit = Math.min(batchSize, remaining);
+            const result = await client.search({
+                query: input.query,
+                category: input.category ?? 'all',
+                state: input.state,
+                dateFrom: input.dateFrom,
+                dateTo: input.dateTo,
+                format: input.format,
+                limit,
+                start: cursor,
+                bulkHarvest: true,
+                includeFullText: input.includeFullText,
+            });
+            totalAvailable = result.totalResults;
+            allRecords.push(...result.records);
+            // Stop if no more results or no next cursor
+            if (!result.nextStart || result.records.length < limit) {
+                cursor = result.nextStart ?? '';
+                break;
+            }
+            cursor = result.nextStart;
+        }
+        const hasMore = allRecords.length < totalAvailable;
+        const nextCursor = cursor && hasMore ? cursor : undefined;
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'trove',
+                        harvested: allRecords.length,
+                        totalAvailable,
+                        hasMore,
+                        nextCursor,
+                        records: allRecords.map((r) => {
+                            if ('heading' in r) {
+                                return {
+                                    type: 'article',
+                                    id: r.id,
+                                    heading: r.heading,
+                                    newspaper: r.title,
+                                    date: r.date,
+                                    url: r.troveUrl,
+                                };
+                            }
+                            else {
+                                return {
+                                    type: 'work',
+                                    id: r.id,
+                                    title: r.title,
+                                    format: r.type,
+                                    issued: r.issued,
+                                    url: r.troveUrl,
+                                };
+                            }
+                        }),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// data.gov.au Harvest
+// ============================================================================
+export const dataGovAUHarvestSchema = {
+    name: 'datagovau_harvest',
+    description: `Bulk download dataset metadata from data.gov.au.
+
+Use this for batch harvesting of:
+- Dataset metadata from specific organisations
+- Datasets matching search criteria
+- Datasets with specific formats or tags
+
+Returns paginated results for large datasets.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search keywords',
+            },
+            organization: {
+                type: 'string',
+                description: 'Filter by organisation slug',
+            },
+            format: {
+                type: 'string',
+                description: 'Filter by resource format (e.g., "CSV", "JSON")',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter by tags',
+            },
+            maxRecords: {
+                type: 'number',
+                description: 'Maximum datasets to harvest (1-1000)',
+                default: 100,
+            },
+            startFrom: {
+                type: 'number',
+                description: 'Offset for pagination',
+                default: 0,
+            },
+        },
+        required: [],
+    },
+};
+export async function executeDataGovAUHarvest(input) {
+    try {
+        const maxRecords = Math.min(input.maxRecords ?? 100, 1000);
+        const batchSize = 100;
+        let offset = input.startFrom ?? 0;
+        const allDatasets = [];
+        let totalAvailable = 0;
+        // Harvest in batches
+        while (allDatasets.length < maxRecords) {
+            const remaining = maxRecords - allDatasets.length;
+            const limit = Math.min(batchSize, remaining);
+            const result = await dataGovAUClient.search({
+                query: input.query,
+                organization: input.organization,
+                format: input.format,
+                tags: input.tags,
+                limit,
+                offset,
+                sort: 'metadata_modified desc',
+            });
+            totalAvailable = result.count;
+            allDatasets.push(...result.datasets);
+            // Stop if no more results
+            if (result.datasets.length < limit) {
+                break;
+            }
+            offset += limit;
+        }
+        const hasMore = allDatasets.length < totalAvailable;
+        const nextOffset = hasMore ? offset : undefined;
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        harvested: allDatasets.length,
+                        totalAvailable,
+                        hasMore,
+                        nextOffset,
+                        datasets: allDatasets.map((d) => ({
+                            id: d.id,
+                            name: d.name,
+                            title: d.title,
+                            organization: d.organization?.title,
+                            resourceCount: d.resources?.length ?? 0,
+                            formats: [...new Set((d.resources ?? []).map((r) => r.format))],
+                            license: d.licenseTitle || d.licenseId,
+                            modified: d.metadataModified,
+                            url: `https://data.gov.au/dataset/${d.name}`,
+                        })),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=harvest.js.map

package/dist/tools/harvest.js.map

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

package/dist/tools/prov_images.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PROV IIIF Image Extraction Tool
+ *
+ * Fetches and parses IIIF manifests from PROV to extract
+ * downloadable image URLs in different sizes.
+ */
+import type { MCPToolResponse } from '../types.js';
+export declare const provGetImagesSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            manifestUrl: {
+                type: string;
+                description: string;
+            };
+            pages: {
+                type: string;
+                description: string;
+            };
+            size: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface PROVGetImagesArgs {
+    manifestUrl: string;
+    pages?: string;
+    size?: 'thumbnail' | 'medium' | 'full' | 'all';
+}
+export declare function executePROVGetImages(args: PROVGetImagesArgs): Promise<MCPToolResponse>;
+export {};
+//# sourceMappingURL=prov_images.d.ts.map

package/dist/tools/prov_images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prov_images.d.ts","sourceRoot":"","sources":["../../src/tools/prov_images.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAOnD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;CA4B/B,CAAC;AAMF,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;CAChD;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,eAAe,CAAC,CAgD1B"}

package/dist/tools/prov_images.js

@@ -0,0 +1,87 @@
+/**
+ * PROV IIIF Image Extraction Tool
+ *
+ * Fetches and parses IIIF manifests from PROV to extract
+ * downloadable image URLs in different sizes.
+ */
+import { provClient } from '../clients/prov_client.js';
+// ============================================================================
+// Tool Schema
+// ============================================================================
+export const provGetImagesSchema = {
+    name: 'prov_get_images',
+    description: `Extract image URLs from a PROV digitised record.
+
+Fetches the IIIF manifest and returns downloadable URLs for each page
+in three sizes: thumbnail (200px), medium (800px), and full resolution.
+
+Returns URLs that can be opened directly in a browser or downloaded.
+Use the 'pages' parameter to limit which pages are returned.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            manifestUrl: {
+                type: 'string',
+                description: 'The IIIF manifest URL from a PROV search result (iiifManifest field)',
+            },
+            pages: {
+                type: 'string',
+                description: 'Optional page filter. Examples: "1-5" for pages 1-5, "1,3,7" for specific pages, "1-3,7,10-12" for mixed ranges',
+            },
+            size: {
+                type: 'string',
+                enum: ['thumbnail', 'medium', 'full', 'all'],
+                description: 'Which size URLs to return. Default: "all"',
+            },
+        },
+        required: ['manifestUrl'],
+    },
+};
+export async function executePROVGetImages(args) {
+    try {
+        const result = await provClient.getImages(args.manifestUrl, {
+            pageRange: args.pages,
+        });
+        // Filter to requested size(s)
+        const size = args.size ?? 'all';
+        const images = result.images.map((img) => {
+            if (size === 'all') {
+                return img;
+            }
+            return {
+                page: img.page,
+                label: img.label,
+                url: img[size],
+            };
+        });
+        const output = {
+            source: 'prov',
+            manifestUrl: result.manifestUrl,
+            title: result.title,
+            description: result.description,
+            totalPages: result.totalPages,
+            returnedPages: images.length,
+            size: size,
+            images,
+        };
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        manifestUrl: args.manifestUrl,
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=prov_images.js.map

package/dist/tools/prov_images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prov_images.js","sourceRoot":"","sources":["../../src/tools/prov_images.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;6DAM8C;IAC3D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;aACpF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iHAAiH;aAC/H;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC;gBAC5C,WAAW,EAAE,2CAA2C;aACzD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAYF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE;YAC1D,SAAS,EAAE,IAAI,CAAC,KAAK;SACtB,CAAC,CAAC;QAEH,8BAA8B;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACvC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,OAAO,GAAG,CAAC;YACb,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC;aACf,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG;YACb,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,aAAa,EAAE,MAAM,CAAC,MAAM;YAC5B,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;wBAC/D,WAAW,EAAE,IAAI,CAAC,WAAW;qBAC9B,CAAC;iBACH,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/prov_search.d.ts

@@ -0,0 +1,60 @@
+/**
+ * PROV Search Tool - Search the Public Record Office Victoria collection
+ */
+import type { MCPToolResponse } from '../types.js';
+export declare const provSearchSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            series: {
+                type: string;
+                description: string;
+            };
+            agency: {
+                type: string;
+                description: string;
+            };
+            recordForm: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            dateFrom: {
+                type: string;
+                description: string;
+            };
+            dateTo: {
+                type: string;
+                description: string;
+            };
+            digitisedOnly: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function executePROVSearch(input: {
+    query?: string;
+    series?: string;
+    agency?: string;
+    recordForm?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    digitisedOnly?: boolean;
+    limit?: number;
+}): Promise<MCPToolResponse>;
+//# sourceMappingURL=prov_search.d.ts.map

package/dist/tools/prov_search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prov_search.d.ts","sourceRoot":"","sources":["../../src/tools/prov_search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAC;AAErE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8D5B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgE3B"}