@littlebearapps/australian-history-mcp 0.6.0 → 0.6.1

package/dist/tools/harvest.js

@@ -1,426 +0,0 @@
-/**
- * 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

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

package/dist/tools/prov_images.d.ts

@@ -1,38 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,87 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,60 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}