@littlebearapps/australian-history-mcp 0.6.0

package/dist/sources/pm-transcripts/client.js

@@ -0,0 +1,192 @@
+/**
+ * Prime Ministerial Transcripts API Client
+ *
+ * Provides access to transcripts of Australian Prime Ministers' speeches,
+ * media releases, and interviews.
+ *
+ * API Documentation: https://pmtranscripts.pmc.gov.au/developers
+ * No API key required.
+ */
+import { BaseClient } from '../../core/base-client.js';
+const PM_TRANSCRIPTS_BASE = 'https://pmtranscripts.pmc.gov.au';
+/**
+ * Simple XML text extractor - gets content between tags
+ */
+function extractXmlText(xml, tagName) {
+    const regex = new RegExp(`<${tagName}>([\\s\\S]*?)</${tagName}>`, 'i');
+    const match = xml.match(regex);
+    return match ? match[1].trim() : '';
+}
+/**
+ * Extract multiple values from repeated tags
+ */
+function extractXmlArray(xml, tagName) {
+    const regex = new RegExp(`<${tagName}>([\\s\\S]*?)</${tagName}>`, 'gi');
+    const matches = [...xml.matchAll(regex)];
+    return matches.map((m) => m[1].trim()).filter((s) => s.length > 0);
+}
+/**
+ * Parse a transcript XML response into PMTranscript object
+ * API returns: <response><item key="0">...fields...</item></response>
+ */
+function parseTranscriptXml(xml) {
+    // Find the item element (API returns <response><item key="0">...</item></response>)
+    const itemMatch = xml.match(/<item[^>]*>([\s\S]*?)<\/item>/i);
+    if (!itemMatch) {
+        return null;
+    }
+    const itemXml = itemMatch[1];
+    const transcriptId = parseInt(extractXmlText(itemXml, 'transcript-id'), 10);
+    if (isNaN(transcriptId)) {
+        return null;
+    }
+    // Handle content which may be in CDATA
+    let content = extractXmlText(itemXml, 'content');
+    // Extract from CDATA if present
+    const cdataMatch = content.match(/<!\[CDATA\[([\s\S]*?)\]\]>/);
+    if (cdataMatch) {
+        content = cdataMatch[1];
+    }
+    // API uses field_date instead of release-date
+    const releaseDate = extractXmlText(itemXml, 'field_date') || extractXmlText(itemXml, 'release-date');
+    return {
+        transcriptId,
+        title: extractXmlText(itemXml, 'title'),
+        primeMinister: extractXmlText(itemXml, 'prime-minister'),
+        periodOfService: extractXmlText(itemXml, 'period-of-service'),
+        releaseDate,
+        releaseType: extractXmlText(itemXml, 'release-type'),
+        documentUrl: extractXmlText(itemXml, 'document') || null,
+        subjects: extractXmlArray(itemXml, 'subject'),
+        content,
+    };
+}
+/**
+ * Parse sitemap XML to extract transcript references
+ */
+function parseSitemapXml(xml) {
+    const refs = [];
+    // Extract all <url> elements
+    const urlMatches = xml.matchAll(/<url>([\s\S]*?)<\/url>/gi);
+    for (const match of urlMatches) {
+        const urlXml = match[1];
+        const loc = extractXmlText(urlXml, 'loc');
+        // Extract ID from URL like /release/transcript-12345
+        const idMatch = loc.match(/transcript-(\d+)/i);
+        if (idMatch) {
+            refs.push({
+                id: parseInt(idMatch[1], 10),
+                url: loc,
+            });
+        }
+    }
+    return refs;
+}
+export class PMTranscriptsClient extends BaseClient {
+    constructor() {
+        super(PM_TRANSCRIPTS_BASE, { userAgent: 'australian-history-mcp/0.6.0' });
+    }
+    /**
+     * Get a single transcript by ID
+     */
+    async getTranscript(id) {
+        const url = this.buildUrl('/query', { transcript: id.toString() });
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    Accept: 'application/xml, text/xml',
+                    'User-Agent': 'australian-history-mcp/0.6.0',
+                },
+            });
+            if (!response.ok) {
+                if (response.status === 404) {
+                    return null;
+                }
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const xml = await response.text();
+            return parseTranscriptXml(xml);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('404')) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get all transcript IDs from sitemap
+     * Note: This is a large request (~26,000 entries)
+     */
+    async getSitemapIds() {
+        const url = `${PM_TRANSCRIPTS_BASE}/transcripts.xml`;
+        const response = await fetch(url, {
+            headers: {
+                Accept: 'application/xml, text/xml',
+                'User-Agent': 'australian-history-mcp/0.6.0',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const xml = await response.text();
+        return parseSitemapXml(xml);
+    }
+    /**
+     * Get a range of transcripts by ID
+     * Fetches sequentially to avoid overwhelming the server
+     */
+    async getTranscriptRange(startId, endId, options) {
+        const transcripts = [];
+        const total = endId - startId + 1;
+        for (let id = startId; id <= endId; id++) {
+            try {
+                const transcript = await this.getTranscript(id);
+                if (transcript) {
+                    // Apply filters
+                    if (options?.primeMinister) {
+                        const pmFilter = options.primeMinister.toLowerCase();
+                        if (!transcript.primeMinister.toLowerCase().includes(pmFilter)) {
+                            continue;
+                        }
+                    }
+                    if (options?.dateFrom || options?.dateTo) {
+                        const releaseDate = this.parseReleaseDate(transcript.releaseDate);
+                        if (releaseDate) {
+                            if (options.dateFrom && releaseDate < options.dateFrom) {
+                                continue;
+                            }
+                            if (options.dateTo && releaseDate > options.dateTo) {
+                                continue;
+                            }
+                        }
+                    }
+                    transcripts.push(transcript);
+                }
+                if (options?.onProgress) {
+                    options.onProgress(id - startId + 1, total);
+                }
+                // Small delay to be respectful to the server
+                await new Promise((resolve) => setTimeout(resolve, 100));
+            }
+            catch {
+                // Skip failed transcripts silently
+                continue;
+            }
+        }
+        return transcripts;
+    }
+    /**
+     * Parse release date from DD/MM/YYYY to YYYY-MM-DD
+     */
+    parseReleaseDate(dateStr) {
+        const match = dateStr.match(/(\d{1,2})\/(\d{1,2})\/(\d{4})/);
+        if (!match)
+            return null;
+        const [, day, month, year] = match;
+        return `${year}-${month.padStart(2, '0')}-${day.padStart(2, '0')}`;
+    }
+}
+// Export singleton instance
+export const pmTranscriptsClient = new PMTranscriptsClient();
+//# sourceMappingURL=client.js.map

package/dist/sources/pm-transcripts/client.js.map

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

package/dist/sources/pm-transcripts/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prime Ministerial Transcripts Source Module
+ *
+ * Provides access to transcripts of Australian Prime Ministers' speeches,
+ * media releases, and interviews from 1945 onwards.
+ * No API key required.
+ *
+ * API Documentation: https://pmtranscripts.pmc.gov.au/developers
+ */
+export declare const pmTranscriptsSource: import("../../core/base-source.js").Source;
+export * from './types.js';
+export { pmTranscriptsClient } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sources/pm-transcripts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sources/pm-transcripts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,eAAO,MAAM,mBAAmB,4CAO9B,CAAC;AAGH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/sources/pm-transcripts/index.js

@@ -0,0 +1,23 @@
+/**
+ * Prime Ministerial Transcripts Source Module
+ *
+ * Provides access to transcripts of Australian Prime Ministers' speeches,
+ * media releases, and interviews from 1945 onwards.
+ * No API key required.
+ *
+ * API Documentation: https://pmtranscripts.pmc.gov.au/developers
+ */
+import { defineSource } from '../../core/base-source.js';
+import { pmTranscriptsGetTranscriptTool } from './tools/get-transcript.js';
+import { pmTranscriptsHarvestTool } from './tools/harvest.js';
+export const pmTranscriptsSource = defineSource({
+    name: 'pm-transcripts',
+    displayName: 'Prime Ministerial Transcripts',
+    description: 'Australian Prime Ministerial transcripts including speeches, media releases, and interviews.',
+    requiresAuth: false,
+    tools: [pmTranscriptsGetTranscriptTool, pmTranscriptsHarvestTool],
+});
+// Re-export types and client for external use
+export * from './types.js';
+export { pmTranscriptsClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/sources/pm-transcripts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sources/pm-transcripts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;IAC9C,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,+BAA+B;IAC5C,WAAW,EACT,8FAA8F;IAChG,YAAY,EAAE,KAAK;IACnB,KAAK,EAAE,CAAC,8BAA8B,EAAE,wBAAwB,CAAC;CAClE,CAAC,CAAC;AAEH,8CAA8C;AAC9C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/sources/pm-transcripts/tools/get-transcript.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PM Transcripts Get Transcript Tool - Get a transcript by ID
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const pmTranscriptsGetTranscriptTool: SourceTool;
+//# sourceMappingURL=get-transcript.d.ts.map

package/dist/sources/pm-transcripts/tools/get-transcript.d.ts.map

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

package/dist/sources/pm-transcripts/tools/get-transcript.js

@@ -0,0 +1,52 @@
+/**
+ * PM Transcripts Get Transcript Tool - Get a transcript by ID
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { pmTranscriptsClient } from '../client.js';
+export const pmTranscriptsGetTranscriptTool = {
+    schema: {
+        name: 'pm_transcripts_get_transcript',
+        description: 'Get a Prime Ministerial transcript by ID. Returns speeches, media releases, and interviews from Australian PMs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'number',
+                    description: 'Transcript ID (1 to ~26000)',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        if (!input.id) {
+            return errorResponse('id is required');
+        }
+        try {
+            const transcript = await pmTranscriptsClient.getTranscript(input.id);
+            if (!transcript) {
+                return errorResponse(`Transcript ${input.id} not found`);
+            }
+            return successResponse({
+                source: 'pm-transcripts',
+                transcript: {
+                    id: transcript.transcriptId,
+                    title: transcript.title,
+                    primeMinister: transcript.primeMinister,
+                    periodOfService: transcript.periodOfService,
+                    releaseDate: transcript.releaseDate,
+                    releaseType: transcript.releaseType,
+                    documentUrl: transcript.documentUrl,
+                    subjects: transcript.subjects,
+                    content: transcript.content,
+                    webUrl: `https://pmtranscripts.pmc.gov.au/release/transcript-${transcript.transcriptId}`,
+                },
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-transcript.js.map

package/dist/sources/pm-transcripts/tools/get-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-transcript.js","sourceRoot":"","sources":["../../../../src/sources/pm-transcripts/tools/get-transcript.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,8BAA8B,GAAe;IACxD,MAAM,EAAE;QACN,IAAI,EAAE,+BAA+B;QACrC,WAAW,EACT,iHAAiH;QACnH,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,KAAK,GAAG,IAAuB,CAAC;QAEtC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,aAAa,CAAC,gBAAgB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAErE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,aAAa,CAAC,cAAc,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;YAC3D,CAAC;YAED,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE;oBACV,EAAE,EAAE,UAAU,CAAC,YAAY;oBAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,aAAa,EAAE,UAAU,CAAC,aAAa;oBACvC,eAAe,EAAE,UAAU,CAAC,eAAe;oBAC3C,WAAW,EAAE,UAAU,CAAC,WAAW;oBACnC,WAAW,EAAE,UAAU,CAAC,WAAW;oBACnC,WAAW,EAAE,UAAU,CAAC,WAAW;oBACnC,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,MAAM,EAAE,uDAAuD,UAAU,CAAC,YAAY,EAAE;iBACzF;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/pm-transcripts/tools/harvest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PM Transcripts Harvest Tool - Bulk download transcripts
+ *
+ * When filtering by PM name, uses sitemap for faster lookups instead of
+ * sequential scanning. This reduces harvest time from minutes to seconds.
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const pmTranscriptsHarvestTool: SourceTool;
+//# sourceMappingURL=harvest.d.ts.map

package/dist/sources/pm-transcripts/tools/harvest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvest.d.ts","sourceRoot":"","sources":["../../../../src/sources/pm-transcripts/tools/harvest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAK/D,eAAO,MAAM,wBAAwB,EAAE,UA4NtC,CAAC"}

package/dist/sources/pm-transcripts/tools/harvest.js

@@ -0,0 +1,213 @@
+/**
+ * PM Transcripts Harvest Tool - Bulk download transcripts
+ *
+ * When filtering by PM name, uses sitemap for faster lookups instead of
+ * sequential scanning. This reduces harvest time from minutes to seconds.
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { pmTranscriptsClient } from '../client.js';
+export const pmTranscriptsHarvestTool = {
+    schema: {
+        name: 'pm_transcripts_harvest',
+        description: 'Bulk download Prime Ministerial transcripts. Fetches sequentially by ID with optional filters. ' +
+            'When filtering by PM name, uses sitemap for faster lookups. ' +
+            'PM era approximate ID ranges: Curtin ~1-2000, Menzies ~2000-4000, Hawke ~5000-8000, ' +
+            'Keating ~8000-10000, Howard ~10000-18000, Rudd/Gillard ~18000-22000, Abbott+ ~22000+.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                primeMinister: {
+                    type: 'string',
+                    description: 'Filter by PM name (partial match, e.g., "Hawke", "Keating")',
+                },
+                dateFrom: {
+                    type: 'string',
+                    description: 'Filter from date (YYYY-MM-DD)',
+                },
+                dateTo: {
+                    type: 'string',
+                    description: 'Filter to date (YYYY-MM-DD)',
+                },
+                startFrom: {
+                    type: 'number',
+                    description: 'Starting transcript ID (default: 1). For faster PM filtering, use approximate era: ' +
+                        'Hawke ~5000, Keating ~8000, Howard ~10000, Rudd ~18000, Abbott ~22000',
+                    default: 1,
+                },
+                maxRecords: {
+                    type: 'number',
+                    description: 'Maximum records to harvest (1-500, default: 100)',
+                    default: 100,
+                },
+                useSitemap: {
+                    type: 'boolean',
+                    description: 'Use sitemap for faster PM-filtered harvesting (default: true when primeMinister filter used). ' +
+                        'Sitemap fetches all ~26,000 transcript IDs at once, then filters locally.',
+                    default: true,
+                },
+            },
+            required: [],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        try {
+            const startFrom = input.startFrom ?? 1;
+            const maxRecords = Math.min(input.maxRecords ?? 100, 500);
+            const useSitemap = input.useSitemap !== false; // Default true
+            const transcripts = [];
+            // Use sitemap-based harvesting when PM filter is provided (much faster)
+            if (input.primeMinister && useSitemap) {
+                // Fetch sitemap once - contains all ~26,000 transcript IDs
+                const allRefs = await pmTranscriptsClient.getSitemapIds();
+                // Filter to IDs >= startFrom and sort
+                const candidateIds = allRefs
+                    .map((ref) => ref.id)
+                    .filter((id) => id >= startFrom)
+                    .sort((a, b) => a - b);
+                let lastId = startFrom;
+                // Iterate through candidate IDs (much faster than sequential scan)
+                for (const id of candidateIds) {
+                    if (transcripts.length >= maxRecords)
+                        break;
+                    try {
+                        const transcript = await pmTranscriptsClient.getTranscript(id);
+                        lastId = id;
+                        if (transcript) {
+                            // Apply PM filter
+                            const pmFilter = input.primeMinister.toLowerCase();
+                            if (!transcript.primeMinister.toLowerCase().includes(pmFilter)) {
+                                continue;
+                            }
+                            // Apply date filters
+                            if (input.dateFrom || input.dateTo) {
+                                const releaseDate = parseReleaseDate(transcript.releaseDate);
+                                if (releaseDate) {
+                                    if (input.dateFrom && releaseDate < input.dateFrom)
+                                        continue;
+                                    if (input.dateTo && releaseDate > input.dateTo)
+                                        continue;
+                                }
+                            }
+                            transcripts.push(transcript);
+                        }
+                        // Small delay to be respectful to the server
+                        await new Promise((resolve) => setTimeout(resolve, 100));
+                    }
+                    catch {
+                        // Skip failed transcripts
+                        continue;
+                    }
+                }
+                return successResponse({
+                    source: 'pm-transcripts',
+                    mode: 'sitemap',
+                    harvested: transcripts.length,
+                    startedAt: startFrom,
+                    endedAt: lastId,
+                    totalIdsInSitemap: allRefs.length,
+                    hasMore: transcripts.length >= maxRecords,
+                    filters: {
+                        primeMinister: input.primeMinister || null,
+                        dateFrom: input.dateFrom || null,
+                        dateTo: input.dateTo || null,
+                    },
+                    records: transcripts.map((t) => ({
+                        id: t.transcriptId,
+                        title: t.title,
+                        primeMinister: t.primeMinister,
+                        releaseDate: t.releaseDate,
+                        releaseType: t.releaseType,
+                        documentUrl: t.documentUrl,
+                        subjects: t.subjects,
+                        contentPreview: t.content.substring(0, 500),
+                        webUrl: `https://pmtranscripts.pmc.gov.au/release/transcript-${t.transcriptId}`,
+                    })),
+                });
+            }
+            // Sequential harvesting (original behavior for non-PM-filtered harvests)
+            let currentId = startFrom;
+            let consecutiveNotFound = 0;
+            const maxConsecutiveNotFound = 50; // Stop if 50 in a row not found (gap detection)
+            while (transcripts.length < maxRecords && consecutiveNotFound < maxConsecutiveNotFound) {
+                try {
+                    const transcript = await pmTranscriptsClient.getTranscript(currentId);
+                    if (transcript) {
+                        consecutiveNotFound = 0;
+                        // Apply filters
+                        let include = true;
+                        if (input.primeMinister) {
+                            const pmFilter = input.primeMinister.toLowerCase();
+                            if (!transcript.primeMinister.toLowerCase().includes(pmFilter)) {
+                                include = false;
+                            }
+                        }
+                        if (include && (input.dateFrom || input.dateTo)) {
+                            const releaseDate = parseReleaseDate(transcript.releaseDate);
+                            if (releaseDate) {
+                                if (input.dateFrom && releaseDate < input.dateFrom) {
+                                    include = false;
+                                }
+                                if (input.dateTo && releaseDate > input.dateTo) {
+                                    include = false;
+                                }
+                            }
+                        }
+                        if (include) {
+                            transcripts.push(transcript);
+                        }
+                    }
+                    else {
+                        consecutiveNotFound++;
+                    }
+                }
+                catch {
+                    consecutiveNotFound++;
+                }
+                currentId++;
+                // Small delay to be respectful to the server
+                await new Promise((resolve) => setTimeout(resolve, 100));
+            }
+            const hasMore = consecutiveNotFound < maxConsecutiveNotFound;
+            return successResponse({
+                source: 'pm-transcripts',
+                mode: 'sequential',
+                harvested: transcripts.length,
+                startedAt: startFrom,
+                endedAt: currentId - 1,
+                hasMore,
+                nextId: hasMore ? currentId : null,
+                filters: {
+                    primeMinister: input.primeMinister || null,
+                    dateFrom: input.dateFrom || null,
+                    dateTo: input.dateTo || null,
+                },
+                records: transcripts.map((t) => ({
+                    id: t.transcriptId,
+                    title: t.title,
+                    primeMinister: t.primeMinister,
+                    releaseDate: t.releaseDate,
+                    releaseType: t.releaseType,
+                    documentUrl: t.documentUrl,
+                    subjects: t.subjects,
+                    contentPreview: t.content.substring(0, 500),
+                    webUrl: `https://pmtranscripts.pmc.gov.au/release/transcript-${t.transcriptId}`,
+                })),
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+/**
+ * Parse release date from DD/MM/YYYY to YYYY-MM-DD
+ */
+function parseReleaseDate(dateStr) {
+    const match = dateStr.match(/(\d{1,2})\/(\d{1,2})\/(\d{4})/);
+    if (!match)
+        return null;
+    const [, day, month, year] = match;
+    return `${year}-${month.padStart(2, '0')}-${day.padStart(2, '0')}`;
+}
+//# sourceMappingURL=harvest.js.map

package/dist/sources/pm-transcripts/tools/harvest.js.map

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

package/dist/sources/pm-transcripts/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * PM Transcripts Type Definitions
+ *
+ * Types for the Prime Ministerial Transcripts API.
+ * API returns XML responses.
+ */
+/**
+ * A transcript from the PM Transcripts archive
+ */
+export interface PMTranscript {
+    /** Unique transcript ID */
+    transcriptId: number;
+    /** Title of the transcript */
+    title: string;
+    /** Prime Minister name */
+    primeMinister: string;
+    /** Period of service (format: YYYYMMDD - YYYYMMDD) */
+    periodOfService: string;
+    /** Release date (format: DD/MM/YYYY) */
+    releaseDate: string;
+    /** Type of release (e.g., "Media Release", "Speech", "Interview") */
+    releaseType: string;
+    /** URL to PDF document */
+    documentUrl: string | null;
+    /** Subject tags */
+    subjects: string[];
+    /** Full text content */
+    content: string;
+}
+/**
+ * Minimal transcript info from sitemap
+ */
+export interface PMTranscriptRef {
+    /** Transcript ID */
+    id: number;
+    /** URL to transcript page */
+    url: string;
+}
+/**
+ * Filter options for harvest
+ */
+export interface PMTranscriptsHarvestParams {
+    /** Filter by Prime Minister name */
+    primeMinister?: string;
+    /** Start date (YYYY-MM-DD) */
+    dateFrom?: string;
+    /** End date (YYYY-MM-DD) */
+    dateTo?: string;
+    /** Maximum records to harvest */
+    maxRecords?: number;
+    /** Starting transcript ID for pagination */
+    startFrom?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sources/pm-transcripts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sources/pm-transcripts/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IAErB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IAEtB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IAExB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAEpB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IAEpB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,mBAAmB;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IAEX,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/sources/pm-transcripts/types.js

@@ -0,0 +1,8 @@
+/**
+ * PM Transcripts Type Definitions
+ *
+ * Types for the Prime Ministerial Transcripts API.
+ * API returns XML responses.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sources/pm-transcripts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sources/pm-transcripts/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}