@littlebearapps/australian-history-mcp 0.6.0

package/dist/sources/nma/client.js

@@ -0,0 +1,175 @@
+/**
+ * National Museum of Australia API Client
+ *
+ * Provides access to museum collection objects, parties (people/orgs),
+ * places, and media. Optional API key for higher rate limits.
+ *
+ * API Documentation: https://github.com/NationalMuseumAustralia/Collection-API
+ */
+import { BaseClient } from '../../core/base-client.js';
+const NMA_API_BASE = 'https://data.nma.gov.au';
+export class NMAClient extends BaseClient {
+    apiKey;
+    constructor() {
+        super(NMA_API_BASE, { userAgent: 'australian-history-mcp/0.6.0' });
+        this.apiKey = process.env.NMA_API_KEY;
+    }
+    // =========================================================================
+    // Object Search
+    // =========================================================================
+    /**
+     * Search for museum objects
+     */
+    async searchObjects(params) {
+        const queryParams = {};
+        if (params.text) {
+            queryParams.text = params.text;
+        }
+        if (params.type) {
+            queryParams.type = params.type;
+        }
+        if (params.collection) {
+            queryParams.collection = params.collection;
+        }
+        queryParams.limit = (params.limit ?? 20).toString();
+        if (params.offset) {
+            queryParams.offset = params.offset.toString();
+        }
+        const url = this.buildUrl('/object', queryParams);
+        return this.fetchWithAuth(url);
+    }
+    /**
+     * Get a single object by ID
+     */
+    async getObject(id) {
+        const url = this.buildUrl(`/object/${id}`, {});
+        try {
+            const result = await this.fetchWithAuth(url);
+            return result.data[0] ?? null;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('404')) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    // =========================================================================
+    // Party Search (People/Organisations)
+    // =========================================================================
+    /**
+     * Search for parties (people and organisations)
+     */
+    async searchParties(params) {
+        const queryParams = {};
+        if (params.text) {
+            queryParams.text = params.text;
+        }
+        queryParams.limit = (params.limit ?? 20).toString();
+        if (params.offset) {
+            queryParams.offset = params.offset.toString();
+        }
+        const url = this.buildUrl('/party', queryParams);
+        return this.fetchWithAuth(url);
+    }
+    /**
+     * Get a single party by ID
+     */
+    async getParty(id) {
+        const url = this.buildUrl(`/party/${id}`, {});
+        try {
+            const result = await this.fetchWithAuth(url);
+            return result.data[0] ?? null;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('404')) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    // =========================================================================
+    // Place Search
+    // =========================================================================
+    /**
+     * Search for places
+     */
+    async searchPlaces(params) {
+        const queryParams = {};
+        if (params.text) {
+            queryParams.text = params.text;
+        }
+        queryParams.limit = (params.limit ?? 20).toString();
+        if (params.offset) {
+            queryParams.offset = params.offset.toString();
+        }
+        const url = this.buildUrl('/place', queryParams);
+        return this.fetchWithAuth(url);
+    }
+    /**
+     * Get a single place by ID
+     */
+    async getPlace(id) {
+        const url = this.buildUrl(`/place/${id}`, {});
+        try {
+            const result = await this.fetchWithAuth(url);
+            return result.data[0] ?? null;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('404')) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    // =========================================================================
+    // Media Search
+    // =========================================================================
+    /**
+     * Search for media items
+     */
+    async searchMedia(params) {
+        const queryParams = {};
+        if (params.text) {
+            queryParams.text = params.text;
+        }
+        queryParams.limit = (params.limit ?? 20).toString();
+        if (params.offset) {
+            queryParams.offset = params.offset.toString();
+        }
+        const url = this.buildUrl('/media', queryParams);
+        return this.fetchWithAuth(url);
+    }
+    /**
+     * Get a single media item by ID
+     */
+    async getMedia(id) {
+        const url = this.buildUrl(`/media/${id}`, {});
+        try {
+            const result = await this.fetchWithAuth(url);
+            return result.data[0] ?? null;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('404')) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    // =========================================================================
+    // Private Helpers
+    // =========================================================================
+    /**
+     * Fetch with optional API key header
+     */
+    async fetchWithAuth(url) {
+        const headers = {};
+        if (this.apiKey) {
+            headers['apikey'] = this.apiKey;
+        }
+        return this.fetchJSON(url, { headers });
+    }
+}
+// Export singleton instance
+export const nmaClient = new NMAClient();
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * National Museum of Australia (NMA) Source Module
+ *
+ * Provides access to the museum's collection of objects, places, and media.
+ * Optional API key for higher rate limits.
+ *
+ * No API key required for basic access.
+ */
+export declare const nmaSource: import("../../core/base-source.js").Source;
+export * from './types.js';
+export { nmaClient } from './client.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/sources/nma/index.js

@@ -0,0 +1,39 @@
+/**
+ * National Museum of Australia (NMA) Source Module
+ *
+ * Provides access to the museum's collection of objects, places, and media.
+ * Optional API key for higher rate limits.
+ *
+ * No API key required for basic access.
+ */
+import { defineSource } from '../../core/base-source.js';
+import { nmaSearchObjectsTool } from './tools/search-objects.js';
+import { nmaGetObjectTool } from './tools/get-object.js';
+import { nmaSearchPlacesTool } from './tools/search-places.js';
+import { nmaGetPlaceTool } from './tools/get-place.js';
+import { nmaSearchPartiesTool } from './tools/search-parties.js';
+import { nmaGetPartyTool } from './tools/get-party.js';
+import { nmaSearchMediaTool } from './tools/search-media.js';
+import { nmaGetMediaTool } from './tools/get-media.js';
+import { nmaHarvestTool } from './tools/harvest.js';
+export const nmaSource = defineSource({
+    name: 'nma',
+    displayName: 'National Museum of Australia',
+    description: 'Australian museum collection including objects, photographs, and historical artefacts.',
+    requiresAuth: false,
+    tools: [
+        nmaSearchObjectsTool,
+        nmaGetObjectTool,
+        nmaSearchPlacesTool,
+        nmaGetPlaceTool,
+        nmaSearchPartiesTool,
+        nmaGetPartyTool,
+        nmaSearchMediaTool,
+        nmaGetMediaTool,
+        nmaHarvestTool,
+    ],
+});
+// Re-export types and client for external use
+export * from './types.js';
+export { nmaClient } from './client.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sources/nma/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;IACpC,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,8BAA8B;IAC3C,WAAW,EAAE,wFAAwF;IACrG,YAAY,EAAE,KAAK;IACnB,KAAK,EAAE;QACL,oBAAoB;QACpB,gBAAgB;QAChB,mBAAmB;QACnB,eAAe;QACf,oBAAoB;QACpB,eAAe;QACf,kBAAkB;QAClB,eAAe;QACf,cAAc;KACf;CACF,CAAC,CAAC;AAEH,8CAA8C;AAC9C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/sources/nma/tools/get-media.d.ts

@@ -0,0 +1,6 @@
+/**
+ * NMA Get Media Tool - Get media item by ID
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const nmaGetMediaTool: SourceTool;
+//# sourceMappingURL=get-media.d.ts.map

package/dist/sources/nma/tools/get-media.d.ts.map

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

package/dist/sources/nma/tools/get-media.js

@@ -0,0 +1,58 @@
+/**
+ * NMA Get Media Tool - Get media item by ID
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { nmaClient } from '../client.js';
+export const nmaGetMediaTool = {
+    schema: {
+        name: 'nma_get_media',
+        description: 'Get detailed media record from National Museum of Australia by ID. Returns format, dimensions, creator, and rights information.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Media ID (from search results)',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        if (!input.id) {
+            return errorResponse('id is required');
+        }
+        try {
+            const media = await nmaClient.getMedia(input.id);
+            if (!media) {
+                return errorResponse(`Media not found: ${input.id}`);
+            }
+            return successResponse({
+                source: 'nma',
+                media: {
+                    id: media.id,
+                    title: media.title,
+                    identifier: media.identifier,
+                    format: media.format,
+                    dimensions: media.extent ? {
+                        width: media.extent.width,
+                        height: media.extent.height,
+                        units: media.extent.unitText,
+                    } : undefined,
+                    creator: media.creator,
+                    rights: media.rights,
+                    licence: media.licence,
+                    metadata: {
+                        modified: media._meta?.modified,
+                        downloadUrl: media._meta?.hasFormat,
+                    },
+                },
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-media.js.map

package/dist/sources/nma/tools/get-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-media.js","sourceRoot":"","sources":["../../../../src/sources/nma/tools/get-media.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,MAAM,EAAE;QACN,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,iIAAiI;QAC9I,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;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,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,aAAa,CAAC,oBAAoB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;YAED,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE;oBACL,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;wBACzB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK;wBACzB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;wBAC3B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;qBAC7B,CAAC,CAAC,CAAC,SAAS;oBACb,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,QAAQ,EAAE;wBACR,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ;wBAC/B,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS;qBACpC;iBACF;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/nma/tools/get-object.d.ts

@@ -0,0 +1,6 @@
+/**
+ * NMA Get Object Tool - Get detailed museum object by ID
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const nmaGetObjectTool: SourceTool;
+//# sourceMappingURL=get-object.d.ts.map

package/dist/sources/nma/tools/get-object.d.ts.map

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

package/dist/sources/nma/tools/get-object.js

@@ -0,0 +1,83 @@
+/**
+ * NMA Get Object Tool - Get detailed museum object by ID
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { nmaClient } from '../client.js';
+export const nmaGetObjectTool = {
+    schema: {
+        name: 'nma_get_object',
+        description: 'Get detailed museum object record from National Museum of Australia by ID. Returns full description, significance, materials, and metadata.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Object ID (from search results)',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        if (!input.id) {
+            return errorResponse('id is required');
+        }
+        try {
+            const obj = await nmaClient.getObject(input.id);
+            if (!obj) {
+                return errorResponse(`Object not found: ${input.id}`);
+            }
+            return successResponse({
+                source: 'nma',
+                object: {
+                    id: obj.id,
+                    title: obj.title,
+                    types: obj.additionalType,
+                    collection: obj.collection ? {
+                        id: obj.collection.id,
+                        title: obj.collection.title,
+                    } : undefined,
+                    identifier: obj.identifier,
+                    materials: obj.medium?.map((m) => m.title),
+                    dimensions: obj.extent ? {
+                        length: obj.extent.length,
+                        width: obj.extent.width,
+                        height: obj.extent.height,
+                        depth: obj.extent.depth,
+                        weight: obj.extent.weight,
+                        units: obj.extent.unitText,
+                    } : undefined,
+                    physicalDescription: obj.physicalDescription,
+                    significanceStatement: obj.significanceStatement,
+                    places: obj.spatial?.map((p) => ({
+                        title: p.title,
+                        role: p.roleName,
+                        coordinates: p.geo,
+                    })),
+                    dates: obj.temporal?.map((t) => ({
+                        title: t.title,
+                        startDate: t.startDate,
+                        endDate: t.endDate,
+                    })),
+                    media: obj.hasVersion?.map((v) => ({
+                        id: v.id,
+                        format: v.format,
+                        identifier: v.identifier,
+                    })),
+                    metadata: {
+                        modified: obj._meta?.modified,
+                        issued: obj._meta?.issued,
+                        copyright: obj._meta?.copyright,
+                        licence: obj._meta?.licence,
+                        webUrl: obj._meta?.hasFormat,
+                    },
+                },
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-object.js.map

package/dist/sources/nma/tools/get-object.js.map

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

package/dist/sources/nma/tools/get-party.d.ts

@@ -0,0 +1,6 @@
+/**
+ * NMA Get Party Tool - Get person or organisation by ID
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const nmaGetPartyTool: SourceTool;
+//# sourceMappingURL=get-party.d.ts.map

package/dist/sources/nma/tools/get-party.d.ts.map

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

package/dist/sources/nma/tools/get-party.js

@@ -0,0 +1,63 @@
+/**
+ * NMA Get Party Tool - Get person or organisation by ID
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { nmaClient } from '../client.js';
+export const nmaGetPartyTool = {
+    schema: {
+        name: 'nma_get_party',
+        description: 'Get detailed person or organisation record from National Museum of Australia by ID. Returns biographical details, birth/death info, and associated metadata.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Party ID (from search results)',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        if (!input.id) {
+            return errorResponse('id is required');
+        }
+        try {
+            const party = await nmaClient.getParty(input.id);
+            if (!party) {
+                return errorResponse(`Party not found: ${input.id}`);
+            }
+            return successResponse({
+                source: 'nma',
+                party: {
+                    id: party.id,
+                    name: party.name,
+                    title: party.title,
+                    description: party.description,
+                    birthDate: party.birthDate,
+                    deathDate: party.deathDate,
+                    birthPlace: party.birthPlace ? {
+                        id: party.birthPlace.id,
+                        title: party.birthPlace.title,
+                    } : undefined,
+                    deathPlace: party.deathPlace ? {
+                        id: party.deathPlace.id,
+                        title: party.deathPlace.title,
+                    } : undefined,
+                    nationality: party.nationality,
+                    gender: party.gender,
+                    metadata: {
+                        modified: party._meta?.modified,
+                        issued: party._meta?.issued,
+                        webUrl: party._meta?.hasFormat,
+                    },
+                },
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-party.js.map

package/dist/sources/nma/tools/get-party.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-party.js","sourceRoot":"","sources":["../../../../src/sources/nma/tools/get-party.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,MAAM,EAAE;QACN,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,8JAA8J;QAC3K,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;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,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,aAAa,CAAC,oBAAoB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;YAED,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE;oBACL,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;wBAC7B,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;wBACvB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK;qBAC9B,CAAC,CAAC,CAAC,SAAS;oBACb,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;wBAC7B,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;wBACvB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK;qBAC9B,CAAC,CAAC,CAAC,SAAS;oBACb,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,QAAQ,EAAE;wBACR,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ;wBAC/B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM;wBAC3B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS;qBAC/B;iBACF;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/nma/tools/get-place.d.ts

@@ -0,0 +1,6 @@
+/**
+ * NMA Get Place Tool - Get place of significance by ID
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const nmaGetPlaceTool: SourceTool;
+//# sourceMappingURL=get-place.d.ts.map

package/dist/sources/nma/tools/get-place.d.ts.map

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

package/dist/sources/nma/tools/get-place.js

@@ -0,0 +1,50 @@
+/**
+ * NMA Get Place Tool - Get place of significance by ID
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { nmaClient } from '../client.js';
+export const nmaGetPlaceTool = {
+    schema: {
+        name: 'nma_get_place',
+        description: 'Get detailed place record from National Museum of Australia by ID. Returns location details, coordinates, and associated information.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Place ID (from search results)',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        if (!input.id) {
+            return errorResponse('id is required');
+        }
+        try {
+            const place = await nmaClient.getPlace(input.id);
+            if (!place) {
+                return errorResponse(`Place not found: ${input.id}`);
+            }
+            return successResponse({
+                source: 'nma',
+                place: {
+                    id: place.id,
+                    title: place.title,
+                    description: place.description,
+                    coordinates: place.geo,
+                    metadata: {
+                        modified: place._meta?.modified,
+                        issued: place._meta?.issued,
+                    },
+                },
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-place.js.map

package/dist/sources/nma/tools/get-place.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-place.js","sourceRoot":"","sources":["../../../../src/sources/nma/tools/get-place.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,MAAM,EAAE;QACN,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,uIAAuI;QACpJ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;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,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,aAAa,CAAC,oBAAoB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;YAED,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE;oBACL,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,WAAW,EAAE,KAAK,CAAC,GAAG;oBACtB,QAAQ,EAAE;wBACR,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ;wBAC/B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM;qBAC5B;iBACF;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/nma/tools/harvest.d.ts

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

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

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