@littlebearapps/australian-history-mcp 0.6.0

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

@@ -0,0 +1,46 @@
+/**
+ * PROV (Public Record Office Victoria) API Client
+ *
+ * The PROV Collection API is a Solr-based search interface for Victorian
+ * state government archives. No API key is required (CC-BY-NC license).
+ *
+ * API Documentation: https://prov.vic.gov.au/prov-collection-api
+ * GLAM Workbench: https://glam-workbench.net/prov/
+ */
+import { BaseClient } from '../../core/base-client.js';
+import type { PROVSearchParams, PROVSearchResult, PROVSeries, PROVAgency, PROVImagesResult } from './types.js';
+export declare class PROVClient extends BaseClient {
+    constructor();
+    /**
+     * Search the PROV collection
+     */
+    search(params: PROVSearchParams): Promise<PROVSearchResult>;
+    /**
+     * Get details of a specific series (VPRS)
+     */
+    getSeries(seriesId: string): Promise<PROVSeries | null>;
+    /**
+     * Get details of a specific agency (VA)
+     */
+    getAgency(agencyId: string): Promise<PROVAgency | null>;
+    /**
+     * Get image URLs from a PROV IIIF manifest
+     */
+    getImages(manifestUrl: string, options?: {
+        pages?: number[];
+        pageRange?: string;
+    }): Promise<PROVImagesResult>;
+    private escapeQuery;
+    private parseSearchResponse;
+    private parseRecordDoc;
+    private parseSeriesDoc;
+    private parseAgencyDoc;
+    private buildRecordUrl;
+    private formatDateRange;
+    private extractManifestTitle;
+    private extractManifestDescription;
+    private parsePageFilter;
+    private extractImageUrls;
+}
+export declare const provClient: PROVClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/sources/prov/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEhB,UAAU,EACV,UAAU,EAEV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAIpB,qBAAa,UAAW,SAAQ,UAAU;;IAKxC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqDjE;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAmB7D;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAmB7D;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAC7C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0C7B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,0BAA0B;IAWlC,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,gBAAgB;CAwCzB;AAGD,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/sources/prov/client.js

@@ -0,0 +1,297 @@
+/**
+ * PROV (Public Record Office Victoria) API Client
+ *
+ * The PROV Collection API is a Solr-based search interface for Victorian
+ * state government archives. No API key is required (CC-BY-NC license).
+ *
+ * API Documentation: https://prov.vic.gov.au/prov-collection-api
+ * GLAM Workbench: https://glam-workbench.net/prov/
+ */
+import { BaseClient } from '../../core/base-client.js';
+const PROV_API_BASE = 'https://api.prov.vic.gov.au/search';
+export class PROVClient extends BaseClient {
+    constructor() {
+        super(PROV_API_BASE, { userAgent: 'australian-history-mcp/0.6.0' });
+    }
+    /**
+     * Search the PROV collection
+     */
+    async search(params) {
+        const queryParts = [];
+        // Build Solr query
+        if (params.query) {
+            queryParts.push(`text:${this.escapeQuery(params.query)}`);
+        }
+        if (params.series) {
+            const seriesNum = params.series.replace(/^VPRS\s*/i, '');
+            queryParts.push(`series_id:${seriesNum}`);
+        }
+        if (params.agency) {
+            const agencyNum = params.agency.replace(/^VA\s*/i, '');
+            queryParts.push(`agencies.ids:VA${agencyNum}`);
+        }
+        if (params.recordForm) {
+            queryParts.push(`record_form:"${params.recordForm}"`);
+        }
+        if (params.startDate || params.endDate) {
+            const start = params.startDate || '*';
+            const end = params.endDate || '*';
+            queryParts.push(`start_dt:[${start} TO ${end}]`);
+        }
+        if (params.digitisedOnly) {
+            queryParts.push('iiif-manifest:[* TO *]');
+        }
+        if (params.category) {
+            // Use proper case for category: 'agency' -> 'Agency', 'series' -> 'Series', etc.
+            const capitalizedCategory = params.category.charAt(0).toUpperCase() + params.category.slice(1).toLowerCase();
+            queryParts.push(`category:${capitalizedCategory}`);
+        }
+        const q = queryParts.length > 0 ? queryParts.join(' AND ') : '*:*';
+        const rows = params.rows ?? 20;
+        const start = params.start ?? 0;
+        const url = this.buildUrl('/query', {
+            q,
+            wt: 'json',
+            rows,
+            start,
+        });
+        const data = await this.fetchJSON(url);
+        return this.parseSearchResponse(data, start, rows);
+    }
+    /**
+     * Get details of a specific series (VPRS)
+     */
+    async getSeries(seriesId) {
+        const seriesNum = seriesId.replace(/^VPRS\s*/i, '');
+        const url = this.buildUrl('/query', {
+            q: `category:Series AND series_id:${seriesNum}`,
+            wt: 'json',
+            rows: 1,
+        });
+        const data = await this.fetchJSON(url);
+        const docs = data.response?.docs ?? [];
+        if (docs.length === 0) {
+            return null;
+        }
+        return this.parseSeriesDoc(docs[0]);
+    }
+    /**
+     * Get details of a specific agency (VA)
+     */
+    async getAgency(agencyId) {
+        const agencyNum = agencyId.replace(/^VA\s*/i, '');
+        const url = this.buildUrl('/query', {
+            q: `category:Agency AND citation:"VA ${agencyNum}"`,
+            wt: 'json',
+            rows: 1,
+        });
+        const data = await this.fetchJSON(url);
+        const docs = data.response?.docs ?? [];
+        if (docs.length === 0) {
+            return null;
+        }
+        return this.parseAgencyDoc(docs[0]);
+    }
+    /**
+     * Get image URLs from a PROV IIIF manifest
+     */
+    async getImages(manifestUrl, options) {
+        const manifest = await this.fetchJSON(manifestUrl);
+        const title = this.extractManifestTitle(manifest);
+        const description = this.extractManifestDescription(manifest);
+        const canvases = manifest.sequences?.[0]?.canvases ?? manifest.items ?? [];
+        const pageFilter = this.parsePageFilter(options?.pages, options?.pageRange);
+        const images = [];
+        for (let i = 0; i < canvases.length; i++) {
+            const pageNum = i + 1;
+            if (pageFilter && !pageFilter.has(pageNum)) {
+                continue;
+            }
+            const canvas = canvases[i];
+            const imageUrls = this.extractImageUrls(canvas);
+            if (imageUrls) {
+                images.push({
+                    page: pageNum,
+                    label: canvas.label ?? `Page ${pageNum}`,
+                    ...imageUrls,
+                });
+            }
+        }
+        return {
+            manifestUrl,
+            title,
+            description,
+            totalPages: canvases.length,
+            images,
+        };
+    }
+    // =========================================================================
+    // Private helpers
+    // =========================================================================
+    escapeQuery(query) {
+        const trimmed = query.trim();
+        if (trimmed.includes(' ')) {
+            return `"${trimmed.replace(/"/g, '\\"')}"`;
+        }
+        return trimmed.replace(/([+\-!(){}[\]^"~*?:\\/])/g, '\\$1');
+    }
+    parseSearchResponse(data, start, rows) {
+        const response = data.response ?? {};
+        const docs = response.docs ?? [];
+        return {
+            totalResults: response.numFound ?? 0,
+            start,
+            rows,
+            records: docs.map((doc) => this.parseRecordDoc(doc)),
+        };
+    }
+    parseRecordDoc(doc) {
+        const getFirst = (val) => Array.isArray(val) ? val[0] : val;
+        return {
+            id: doc._id ?? doc.id ?? '',
+            title: doc.title ?? doc.name ?? 'Untitled',
+            description: doc.presentation_text ?? doc['description.aggregate'] ?? undefined,
+            series: doc.series_id ? `VPRS ${doc.series_id}` : undefined,
+            seriesTitle: getFirst(doc['is_part_of_series.title']) ?? undefined,
+            agency: getFirst(doc['agencies.ids']) ?? undefined,
+            agencyTitle: getFirst(doc['agencies.titles']) ?? undefined,
+            recordForm: getFirst(doc.record_form) ?? undefined,
+            startDate: doc.start_dt ?? undefined,
+            endDate: doc.end_dt ?? undefined,
+            iiifManifest: doc['iiif-manifest'] ?? undefined,
+            digitised: !!doc['iiif-manifest'],
+            url: this.buildRecordUrl(doc),
+        };
+    }
+    parseSeriesDoc(doc) {
+        const getFirst = (val) => Array.isArray(val) ? val[0] : val;
+        // Extract description from function_content or other fields
+        const description = getFirst(doc.function_content) ?? doc.description ?? doc.scope_content ?? undefined;
+        return {
+            id: doc['identifier.PROV_ACM.id'] ?? `VPRS ${doc.series_id ?? doc.id}`,
+            title: doc.title ?? doc.name ?? 'Untitled',
+            description: description,
+            agency: getFirst(doc.resp_agency_id) ? `VA ${getFirst(doc.resp_agency_id)}` : undefined,
+            agencyTitle: getFirst(doc.resp_agency_title) ?? undefined,
+            dateRange: this.formatDateRange(doc.start_dt, doc.end_dt),
+            accessStatus: getFirst(doc.rights_status) ?? undefined,
+            itemCount: doc.item_count ?? undefined,
+        };
+    }
+    parseAgencyDoc(doc) {
+        const _getFirst = (val) => Array.isArray(val) ? val[0] : val;
+        return {
+            id: doc['identifier.PROV_ACM.id'] ?? doc.citation ?? `VA ${doc.VA}`,
+            title: doc.title ?? doc.name ?? 'Untitled',
+            description: doc.description ?? doc.history ?? doc.scope_content ?? undefined,
+            dateRange: this.formatDateRange(doc.start_dt, doc.end_dt),
+            status: doc.status ?? undefined,
+            seriesCount: doc.series_count ?? undefined,
+        };
+    }
+    buildRecordUrl(doc) {
+        const id = doc._id ?? doc.id;
+        if (doc.series_id) {
+            return `https://prov.vic.gov.au/archive/VPRS${doc.series_id}`;
+        }
+        if (id) {
+            return `https://prov.vic.gov.au/archive/${id}`;
+        }
+        return 'https://prov.vic.gov.au/';
+    }
+    formatDateRange(start, end) {
+        if (!start && !end)
+            return undefined;
+        if (start && end)
+            return `${start} - ${end}`;
+        if (start)
+            return `${start} -`;
+        return `- ${end}`;
+    }
+    extractManifestTitle(manifest) {
+        const label = manifest.label;
+        if (typeof label === 'string')
+            return label;
+        if (Array.isArray(label))
+            return label[0]?.['@value'] ?? label[0] ?? 'Untitled';
+        if (typeof label === 'object') {
+            const values = Object.values(label)[0];
+            return values?.[0] ?? 'Untitled';
+        }
+        return 'Untitled';
+    }
+    extractManifestDescription(manifest) {
+        const desc = manifest.description ?? manifest.summary;
+        if (typeof desc === 'string')
+            return desc;
+        if (Array.isArray(desc))
+            return desc[0]?.['@value'] ?? desc[0];
+        if (typeof desc === 'object') {
+            const values = Object.values(desc)[0];
+            return values?.[0];
+        }
+        return undefined;
+    }
+    parsePageFilter(pages, pageRange) {
+        if (!pages && !pageRange)
+            return null;
+        const filter = new Set();
+        if (pages) {
+            pages.forEach(p => filter.add(p));
+        }
+        if (pageRange) {
+            const parts = pageRange.split(',').map(s => s.trim());
+            for (const part of parts) {
+                if (part.includes('-')) {
+                    const [start, end] = part.split('-').map(s => parseInt(s.trim(), 10));
+                    for (let i = start; i <= end; i++) {
+                        filter.add(i);
+                    }
+                }
+                else {
+                    filter.add(parseInt(part, 10));
+                }
+            }
+        }
+        return filter.size > 0 ? filter : null;
+    }
+    extractImageUrls(canvas) {
+        let serviceUrl;
+        // Try IIIF v2 structure
+        const images = canvas.images ?? [];
+        if (images.length > 0) {
+            const resource = images[0].resource;
+            if (resource?.service) {
+                const service = Array.isArray(resource.service) ? resource.service[0] : resource.service;
+                serviceUrl = service?.['@id'] ?? service?.id;
+            }
+            if (!serviceUrl && resource?.['@id']) {
+                const resourceId = resource['@id'];
+                if (resourceId.includes('/full/')) {
+                    serviceUrl = resourceId.split('/full/')[0];
+                }
+            }
+        }
+        // Try IIIF v3 structure
+        if (!serviceUrl && canvas.items) {
+            const annotationPage = canvas.items[0];
+            const annotation = annotationPage?.items?.[0];
+            const body = annotation?.body;
+            if (body?.service) {
+                const service = Array.isArray(body.service) ? body.service[0] : body.service;
+                serviceUrl = service?.['@id'] ?? service?.id;
+            }
+        }
+        if (!serviceUrl) {
+            return null;
+        }
+        return {
+            thumbnail: `${serviceUrl}/full/!200,200/0/default.jpg`,
+            medium: `${serviceUrl}/full/!800,800/0/default.jpg`,
+            full: `${serviceUrl}/full/full/0/default.jpg`,
+        };
+    }
+}
+// Export singleton instance
+export const provClient = new PROVClient();
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * PROV (Public Record Office Victoria) Source Module
+ *
+ * Provides access to Victorian state government archives
+ * through the PROV Solr-based search API.
+ *
+ * No API key required (CC-BY-NC license).
+ */
+export declare const provSource: import("../../core/base-source.js").Source;
+export * from './types.js';
+export { provClient } from './client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sources/prov/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,eAAO,MAAM,UAAU,4CAYrB,CAAC;AAGH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/sources/prov/index.js

@@ -0,0 +1,31 @@
+/**
+ * PROV (Public Record Office Victoria) Source Module
+ *
+ * Provides access to Victorian state government archives
+ * through the PROV Solr-based search API.
+ *
+ * No API key required (CC-BY-NC license).
+ */
+import { defineSource } from '../../core/base-source.js';
+import { provSearchTool } from './tools/search.js';
+import { provGetImagesTool } from './tools/images.js';
+import { provHarvestTool } from './tools/harvest.js';
+import { provGetSeriesTool } from './tools/get-series.js';
+import { provGetAgencyTool } from './tools/get-agency.js';
+export const provSource = defineSource({
+    name: 'prov',
+    displayName: 'Public Record Office Victoria',
+    description: 'Victorian state government archives including photographs, maps, government files, and council records.',
+    requiresAuth: false,
+    tools: [
+        provSearchTool,
+        provGetImagesTool,
+        provHarvestTool,
+        provGetSeriesTool,
+        provGetAgencyTool,
+    ],
+});
+// Re-export types and client for external use
+export * from './types.js';
+export { provClient } from './client.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sources/prov/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;IACrC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,+BAA+B;IAC5C,WAAW,EAAE,yGAAyG;IACtH,YAAY,EAAE,KAAK;IACnB,KAAK,EAAE;QACL,cAAc;QACd,iBAAiB;QACjB,eAAe;QACf,iBAAiB;QACjB,iBAAiB;KAClB;CACF,CAAC,CAAC;AAEH,8CAA8C;AAC9C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/sources/prov/tools/get-agency.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PROV Get Agency Tool - Get details of a specific VA agency
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const provGetAgencyTool: SourceTool;
+//# sourceMappingURL=get-agency.d.ts.map

package/dist/sources/prov/tools/get-agency.d.ts.map

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

package/dist/sources/prov/tools/get-agency.js

@@ -0,0 +1,49 @@
+/**
+ * PROV Get Agency Tool - Get details of a specific VA agency
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { provClient } from '../client.js';
+export const provGetAgencyTool = {
+    schema: {
+        name: 'prov_get_agency',
+        description: 'Get detailed information about a PROV agency (VA) including description, date range, status, and associated series count.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agencyId: {
+                    type: 'string',
+                    description: 'Agency ID (e.g., "VA 473" or "473")',
+                },
+            },
+            required: ['agencyId'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        if (!input.agencyId) {
+            return errorResponse('agencyId is required');
+        }
+        try {
+            const agency = await provClient.getAgency(input.agencyId);
+            if (!agency) {
+                return errorResponse(`Agency not found: ${input.agencyId}`);
+            }
+            return successResponse({
+                source: 'prov',
+                agency: {
+                    id: agency.id,
+                    title: agency.title,
+                    description: agency.description,
+                    dateRange: agency.dateRange,
+                    status: agency.status,
+                    seriesCount: agency.seriesCount,
+                    url: `https://prov.vic.gov.au/archive/${agency.id.replace(/\s+/g, '')}`,
+                },
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-agency.js.map

package/dist/sources/prov/tools/get-agency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-agency.js","sourceRoot":"","sources":["../../../../src/sources/prov/tools/get-agency.ts"],"names":[],"mappings":"AAAA;;GAEG;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,2HAA2H;QACxI,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;iBACnD;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,KAAK,GAAG,IAA6B,CAAC;QAE5C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,aAAa,CAAC,sBAAsB,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAE1D,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,aAAa,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE;oBACN,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,GAAG,EAAE,mCAAmC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;iBACxE;aACF,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/get-series.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PROV Get Series Tool - Get details of a specific VPRS series
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const provGetSeriesTool: SourceTool;
+//# sourceMappingURL=get-series.d.ts.map

package/dist/sources/prov/tools/get-series.d.ts.map

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

package/dist/sources/prov/tools/get-series.js

@@ -0,0 +1,51 @@
+/**
+ * PROV Get Series Tool - Get details of a specific VPRS series
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { provClient } from '../client.js';
+export const provGetSeriesTool = {
+    schema: {
+        name: 'prov_get_series',
+        description: 'Get detailed information about a PROV series (VPRS) including description, agency, date range, and access status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                seriesId: {
+                    type: 'string',
+                    description: 'Series ID (e.g., "VPRS 515" or "515")',
+                },
+            },
+            required: ['seriesId'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        if (!input.seriesId) {
+            return errorResponse('seriesId is required');
+        }
+        try {
+            const series = await provClient.getSeries(input.seriesId);
+            if (!series) {
+                return errorResponse(`Series not found: ${input.seriesId}`);
+            }
+            return successResponse({
+                source: 'prov',
+                series: {
+                    id: series.id,
+                    title: series.title,
+                    description: series.description,
+                    agency: series.agency,
+                    agencyTitle: series.agencyTitle,
+                    dateRange: series.dateRange,
+                    accessStatus: series.accessStatus,
+                    itemCount: series.itemCount,
+                    url: `https://prov.vic.gov.au/archive/${series.id.replace(/\s+/g, '')}`,
+                },
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-series.js.map

package/dist/sources/prov/tools/get-series.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-series.js","sourceRoot":"","sources":["../../../../src/sources/prov/tools/get-series.ts"],"names":[],"mappings":"AAAA;;GAEG;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,mHAAmH;QAChI,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;iBACrD;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,KAAK,GAAG,IAA6B,CAAC;QAE5C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,aAAa,CAAC,sBAAsB,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAE1D,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,aAAa,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE;oBACN,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,GAAG,EAAE,mCAAmC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;iBACxE;aACF,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/harvest.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PROV Harvest Tool - Bulk download records from PROV
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const provHarvestTool: SourceTool;
+//# sourceMappingURL=harvest.d.ts.map

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

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