@littlebearapps/australian-history-mcp 0.6.0

package/dist/tools/prov_search.js

@@ -0,0 +1,131 @@
+/**
+ * PROV Search Tool - Search the Public Record Office Victoria collection
+ */
+import { provClient } from '../clients/prov_client.js';
+export const provSearchSchema = {
+    name: 'prov_search',
+    description: `Search the Public Record Office Victoria (PROV) collection for Victorian state government archives.
+
+Use this to find:
+- Historical photographs and maps
+- Government records and files
+- Council meeting minutes
+- State agency records
+
+PROV holds records from Victorian state government agencies, local councils, and courts.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search text (e.g., "Melbourne Town Hall", "Fitzroy council")',
+            },
+            series: {
+                type: 'string',
+                description: 'VPRS series number (e.g., "VPRS 515" or "515")',
+            },
+            agency: {
+                type: 'string',
+                description: 'VA agency number (e.g., "VA 473" or "473")',
+            },
+            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 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: [],
+    },
+};
+export async function executePROVSearch(input) {
+    try {
+        // Validate at least one search parameter
+        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 params = {
+            query: input.query,
+            series: input.series,
+            agency: input.agency,
+            recordForm: input.recordForm,
+            startDate: input.dateFrom,
+            endDate: input.dateTo,
+            digitisedOnly: input.digitisedOnly ?? false,
+            rows: Math.min(input.limit ?? 20, 100),
+        };
+        const result = await provClient.search(params);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        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,
+                        })),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=prov_search.js.map

package/dist/tools/prov_search.js.map

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

package/dist/tools/trove_newspaper.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Trove Newspaper Tools - Get article details and list titles
+ */
+import type { MCPToolResponse } from '../types.js';
+export declare const troveNewspaperArticleSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            articleId: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+                enum: string[];
+                default: string;
+            };
+            includeText: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeTroveNewspaperArticle(input: {
+    articleId: string;
+    type?: 'newspaper' | 'gazette';
+    includeText?: boolean;
+}): Promise<MCPToolResponse>;
+export declare const troveListTitlesSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            type: {
+                type: string;
+                description: string;
+                enum: string[];
+                default: string;
+            };
+            state: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+        };
+        required: never[];
+    };
+};
+export declare function executeTroveListTitles(input: {
+    type?: 'newspaper' | 'gazette';
+    state?: string;
+}): Promise<MCPToolResponse>;
+export declare const troveTitleDetailsSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            titleId: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+                enum: string[];
+                default: string;
+            };
+            includeYears: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            dateFrom: {
+                type: string;
+                description: string;
+            };
+            dateTo: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeTroveTitleDetails(input: {
+    titleId: string;
+    type?: 'newspaper' | 'gazette';
+    includeYears?: boolean;
+    dateFrom?: string;
+    dateTo?: string;
+}): Promise<MCPToolResponse>;
+//# sourceMappingURL=trove_newspaper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trove_newspaper.d.ts","sourceRoot":"","sources":["../../src/tools/trove_newspaper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,aAAa,CAAC;AAM/D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;CA8BvC,CAAC;AAEF,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkE3B;AAMD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;CAuBjC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkD3B;AAMD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCnC,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiE3B"}

package/dist/tools/trove_newspaper.js

@@ -0,0 +1,282 @@
+/**
+ * Trove Newspaper Tools - Get article details and list titles
+ */
+import { createTroveClient } from '../clients/trove_client.js';
+// ============================================================================
+// Get Newspaper Article
+// ============================================================================
+export const troveNewspaperArticleSchema = {
+    name: 'trove_newspaper_article',
+    description: `Get the full details of a newspaper or gazette article from Trove.
+
+Use this after searching to retrieve:
+- Complete article text (OCR)
+- PDF link for the original page
+- Correction and tag counts
+- Full metadata`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            articleId: {
+                type: 'string',
+                description: 'The Trove article ID (from search results)',
+            },
+            type: {
+                type: 'string',
+                description: 'Article type',
+                enum: ['newspaper', 'gazette'],
+                default: 'newspaper',
+            },
+            includeText: {
+                type: 'boolean',
+                description: 'Include the full OCR text of the article',
+                default: true,
+            },
+        },
+        required: ['articleId'],
+    },
+};
+export async function executeTroveNewspaperArticle(input) {
+    try {
+        const client = createTroveClient();
+        if (!client.hasApiKey()) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'TROVE_API_KEY not configured',
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        const article = input.type === 'gazette'
+            ? await client.getGazetteArticle(input.articleId, input.includeText ?? true)
+            : await client.getNewspaperArticle(input.articleId, input.includeText ?? true);
+        if (!article) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Article ${input.articleId} not found`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'trove',
+                        article: {
+                            id: article.id,
+                            heading: article.heading,
+                            newspaper: article.title,
+                            newspaperId: article.titleId,
+                            date: article.date,
+                            page: article.page,
+                            category: article.category,
+                            wordCount: article.wordCount,
+                            correctionCount: article.correctionCount,
+                            illustrated: article.illustrated,
+                            url: article.troveUrl,
+                            pdfUrl: article.pdfUrl,
+                            fullText: article.fullText,
+                        },
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// List Newspaper Titles
+// ============================================================================
+export const troveListTitlesSchema = {
+    name: 'trove_list_titles',
+    description: `List available newspaper or gazette titles in Trove.
+
+Use this to discover what publications are available for a particular state.
+Returns publication dates and issue counts.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            type: {
+                type: 'string',
+                description: 'Type of publication',
+                enum: ['newspaper', 'gazette'],
+                default: 'newspaper',
+            },
+            state: {
+                type: 'string',
+                description: 'Filter by state',
+                enum: ['vic', 'nsw', 'qld', 'sa', 'wa', 'tas', 'nt', 'act', 'national'],
+            },
+        },
+        required: [],
+    },
+};
+export async function executeTroveListTitles(input) {
+    try {
+        const client = createTroveClient();
+        if (!client.hasApiKey()) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'TROVE_API_KEY not configured',
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        const titles = input.type === 'gazette'
+            ? await client.listGazetteTitles(input.state)
+            : await client.listNewspaperTitles(input.state);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'trove',
+                        type: input.type ?? 'newspaper',
+                        state: input.state ?? 'all',
+                        count: titles.length,
+                        titles: titles.map(t => ({
+                            id: t.id,
+                            title: t.title,
+                            state: t.state,
+                            issn: t.issn,
+                            dateRange: `${t.startDate} - ${t.endDate}`,
+                            url: t.troveUrl,
+                        })),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// Get Title Details
+// ============================================================================
+export const troveTitleDetailsSchema = {
+    name: 'trove_title_details',
+    description: `Get detailed information about a newspaper or gazette title.
+
+Use this to find:
+- Available years and issue counts
+- Specific issue dates for a date range`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            titleId: {
+                type: 'string',
+                description: 'The Trove title ID',
+            },
+            type: {
+                type: 'string',
+                description: 'Type of publication',
+                enum: ['newspaper', 'gazette'],
+                default: 'newspaper',
+            },
+            includeYears: {
+                type: 'boolean',
+                description: 'Include list of available years',
+                default: true,
+            },
+            dateFrom: {
+                type: 'string',
+                description: 'Start of date range for issue list (YYYYMMDD)',
+            },
+            dateTo: {
+                type: 'string',
+                description: 'End of date range for issue list (YYYYMMDD)',
+            },
+        },
+        required: ['titleId'],
+    },
+};
+export async function executeTroveTitleDetails(input) {
+    try {
+        const client = createTroveClient();
+        if (!client.hasApiKey()) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'TROVE_API_KEY not configured',
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        const details = await client.getTitleDetails(input.titleId, {
+            type: input.type,
+            includeYears: input.includeYears ?? true,
+            dateRange: input.dateFrom && input.dateTo
+                ? { from: input.dateFrom, to: input.dateTo }
+                : undefined,
+        });
+        if (!details) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Title ${input.titleId} not found`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'trove',
+                        title: {
+                            id: details.id,
+                            name: details.title,
+                            state: details.state,
+                            issn: details.issn,
+                            dateRange: `${details.startDate} - ${details.endDate}`,
+                            url: details.troveUrl,
+                            years: details.years,
+                            issues: details.issues,
+                        },
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=trove_newspaper.js.map

package/dist/tools/trove_newspaper.js.map

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

package/dist/tools/trove_search.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Trove Search Tool - Search the National Library of Australia's Trove collection
+ */
+import type { MCPToolResponse } from '../types.js';
+export declare const troveSearchSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+                enum: string[];
+                default: string;
+            };
+            state: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            dateFrom: {
+                type: string;
+                description: string;
+            };
+            dateTo: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                description: string;
+            };
+            includeFullText: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeTroveSearch(input: {
+    query: string;
+    category?: string;
+    state?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    format?: string;
+    includeFullText?: boolean;
+    limit?: number;
+}): Promise<MCPToolResponse>;
+//# sourceMappingURL=trove_search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trove_search.d.ts","sourceRoot":"","sources":["../../src/tools/trove_search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,aAAa,CAAC;AAE9E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuD7B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkF3B"}