mcp-grampsweb 1.2.0 → 1.3.0

package/dist/tools/index.js

@@ -7,6 +7,8 @@ import { analysisTools } from "./analysis.js";
 import { listTools } from "./list.js";
 import { updateTools } from "./update.js";
 import { convenienceTools } from "./convenience.js";
+import { deleteTools } from "./delete.js";
+import { tagTools } from "./tags.js";
 // Combine all tools
 export const allTools = {
     ...searchTools,
@@ -15,9 +17,11 @@ export const allTools = {
     ...listTools,
     ...updateTools,
     ...convenienceTools,
+    ...deleteTools,
+    ...tagTools,
 };
 // Export tool names for registration
 export const toolNames = Object.keys(allTools);
 // Export individual tool groups
-export { searchTools, createTools, analysisTools, listTools, updateTools, convenienceTools };
+export { searchTools, createTools, analysisTools, listTools, updateTools, convenienceTools, deleteTools, tagTools };
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,oBAAoB;AACpB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,WAAW;IACd,GAAG,WAAW;IACd,GAAG,aAAa;IAChB,GAAG,SAAS;IACZ,GAAG,WAAW;IACd,GAAG,gBAAgB;CACpB,CAAC;AAEF,qCAAqC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAE/C,gCAAgC;AAChC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,oBAAoB;AACpB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,WAAW;IACd,GAAG,WAAW;IACd,GAAG,aAAa;IAChB,GAAG,SAAS;IACZ,GAAG,WAAW;IACd,GAAG,gBAAgB;IACnB,GAAG,WAAW;IACd,GAAG,QAAQ;CACZ,CAAC;AAEF,qCAAqC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAE/C,gCAAgC;AAChC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC"}

package/dist/tools/tags.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Tag management tools
+ */
+import { z } from "zod";
+declare const createTagSchema: z.ZodObject<{
+    name: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    color?: string | undefined;
+    priority?: number | undefined;
+}, {
+    name: string;
+    color?: string | undefined;
+    priority?: number | undefined;
+}>;
+declare const tagEntitySchema: z.ZodObject<{
+    entity_type: z.ZodString;
+    handle: z.ZodString;
+    tag_handle: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entity_type: string;
+    handle: string;
+    tag_handle: string;
+}, {
+    entity_type: string;
+    handle: string;
+    tag_handle: string;
+}>;
+/**
+ * List all tags in the database
+ */
+export declare function grampsListTags(): Promise<string>;
+/**
+ * Create a new tag
+ */
+export declare function grampsCreateTag(params: z.infer<typeof createTagSchema>): Promise<string>;
+/**
+ * Add a tag to an entity
+ */
+export declare function grampsTagEntity(params: z.infer<typeof tagEntitySchema>): Promise<string>;
+/**
+ * Remove a tag from an entity
+ */
+export declare function grampsUntagEntity(params: z.infer<typeof tagEntitySchema>): Promise<string>;
+export declare const tagTools: {
+    gramps_list_tags: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: typeof grampsListTags;
+    };
+    gramps_create_tag: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                color: {
+                    type: string;
+                    description: string;
+                };
+                priority: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: typeof grampsCreateTag;
+    };
+    gramps_tag_entity: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                entity_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                handle: {
+                    type: string;
+                    description: string;
+                };
+                tag_handle: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: typeof grampsTagEntity;
+    };
+    gramps_untag_entity: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                entity_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                handle: {
+                    type: string;
+                    description: string;
+                };
+                tag_handle: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: typeof grampsUntagEntity;
+    };
+};
+export {};
+//# sourceMappingURL=tags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/tools/tags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,QAAA,MAAM,eAAe;;;;;;;;;;;;EAOnB,CAAC;AAGH,QAAA,MAAM,eAAe;;;;;;;;;;;;EAMnB,CAAC;AAEH;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAgCtD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CA0DjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CA0DjB;AAGD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuHpB,CAAC"}

package/dist/tools/tags.js

@@ -0,0 +1,296 @@
+/**
+ * Tag management tools
+ */
+import { z } from "zod";
+import { grampsClient } from "../client.js";
+import { API_ENDPOINTS, ENTITY_ENDPOINT_MAP } from "../constants.js";
+import { formatToolResponse } from "../utils/response.js";
+// Schema for creating a tag
+const createTagSchema = z.object({
+    name: z.string().describe("Tag name"),
+    color: z
+        .string()
+        .optional()
+        .describe("Hex color for the tag (e.g., '#FF5500')"),
+    priority: z.number().optional().describe("Priority (lower = higher priority)"),
+});
+// Schema for tagging/untagging an entity
+const tagEntitySchema = z.object({
+    entity_type: z
+        .string()
+        .describe("Entity type: people, families, events, places, sources, citations, repositories, media, notes"),
+    handle: z.string().describe("Handle of the entity to tag/untag"),
+    tag_handle: z.string().describe("Handle of the tag to add/remove"),
+});
+/**
+ * List all tags in the database
+ */
+export async function grampsListTags() {
+    const tags = await grampsClient.get(API_ENDPOINTS.TAGS);
+    if (!tags || tags.length === 0) {
+        return formatToolResponse({
+            status: "success",
+            summary: "No tags found",
+            data: {
+                count: 0,
+                tags: [],
+            },
+            details: "Create tags using gramps_create_tag to organize your records.",
+        });
+    }
+    const tagList = tags.map((tag) => ({
+        handle: tag.handle,
+        gramps_id: tag.gramps_id,
+        name: tag.name,
+        color: tag.color || null,
+        priority: tag.priority ?? null,
+    }));
+    return formatToolResponse({
+        status: "success",
+        summary: `Found ${tags.length} tag(s)`,
+        data: {
+            count: tags.length,
+            tags: tagList,
+        },
+        details: "Use tag handles to tag entities with gramps_tag_entity.",
+    });
+}
+/**
+ * Create a new tag
+ */
+export async function grampsCreateTag(params) {
+    const validated = createTagSchema.parse(params);
+    const tag = {
+        _class: "Tag",
+        name: validated.name,
+        color: validated.color,
+        priority: validated.priority,
+    };
+    const rawResponse = await grampsClient.post(API_ENDPOINTS.TAGS, tag);
+    const response = Array.isArray(rawResponse) ? rawResponse[0] : rawResponse;
+    if (!response?.handle) {
+        throw new Error(`API did not return entity handle after creating tag. Response: ${JSON.stringify(rawResponse)}`);
+    }
+    return formatToolResponse({
+        status: "success",
+        summary: `Created tag "${validated.name}"`,
+        data: {
+            handle: response.handle,
+            gramps_id: response.gramps_id,
+            name: validated.name,
+            color: validated.color || null,
+        },
+        details: `Use handle "${response.handle}" to tag entities with gramps_tag_entity.`,
+    });
+}
+/**
+ * Add a tag to an entity
+ */
+export async function grampsTagEntity(params) {
+    const { entity_type, handle, tag_handle } = tagEntitySchema.parse(params);
+    // Validate entity type
+    const endpoint = ENTITY_ENDPOINT_MAP[entity_type.toLowerCase()];
+    if (!endpoint) {
+        throw new Error(`Invalid entity type "${entity_type}". Valid types: people, families, events, places, sources, citations, repositories, media, notes`);
+    }
+    // Fetch the existing entity
+    const entity = await grampsClient.get(`${endpoint}${handle}`);
+    // Check if tag is already applied
+    const existingTags = entity.tag_list || [];
+    if (existingTags.includes(tag_handle)) {
+        return formatToolResponse({
+            status: "success",
+            summary: `Tag already applied to ${entity_type.replace(/s$/, "")}`,
+            data: {
+                entity_type,
+                entity_handle: handle,
+                tag_handle,
+                tag_count: existingTags.length,
+            },
+            details: "No changes were made - tag was already applied.",
+        });
+    }
+    // Build updated entity with new tag
+    const updatedEntity = {
+        ...entity,
+        tag_list: [...existingTags, tag_handle],
+    };
+    // PUT the updated entity
+    const rawResponse = await grampsClient.put(`${endpoint}${handle}`, updatedEntity);
+    const response = Array.isArray(rawResponse) ? rawResponse[0] : rawResponse;
+    return formatToolResponse({
+        status: "success",
+        summary: `Tagged ${entity_type.replace(/s$/, "")} ${entity.gramps_id}`,
+        data: {
+            entity_type,
+            entity_handle: handle,
+            entity_gramps_id: entity.gramps_id,
+            tag_handle,
+            tag_count: existingTags.length + 1,
+        },
+        details: `Tag added successfully. Entity now has ${existingTags.length + 1} tag(s).`,
+    });
+}
+/**
+ * Remove a tag from an entity
+ */
+export async function grampsUntagEntity(params) {
+    const { entity_type, handle, tag_handle } = tagEntitySchema.parse(params);
+    // Validate entity type
+    const endpoint = ENTITY_ENDPOINT_MAP[entity_type.toLowerCase()];
+    if (!endpoint) {
+        throw new Error(`Invalid entity type "${entity_type}". Valid types: people, families, events, places, sources, citations, repositories, media, notes`);
+    }
+    // Fetch the existing entity
+    const entity = await grampsClient.get(`${endpoint}${handle}`);
+    // Check if tag exists
+    const existingTags = entity.tag_list || [];
+    if (!existingTags.includes(tag_handle)) {
+        return formatToolResponse({
+            status: "success",
+            summary: `Tag not found on ${entity_type.replace(/s$/, "")}`,
+            data: {
+                entity_type,
+                entity_handle: handle,
+                tag_handle,
+                tag_count: existingTags.length,
+            },
+            details: "No changes were made - tag was not applied to this entity.",
+        });
+    }
+    // Build updated entity without the tag
+    const updatedEntity = {
+        ...entity,
+        tag_list: existingTags.filter((t) => t !== tag_handle),
+    };
+    // PUT the updated entity
+    const rawResponse = await grampsClient.put(`${endpoint}${handle}`, updatedEntity);
+    const response = Array.isArray(rawResponse) ? rawResponse[0] : rawResponse;
+    return formatToolResponse({
+        status: "success",
+        summary: `Removed tag from ${entity_type.replace(/s$/, "")} ${entity.gramps_id}`,
+        data: {
+            entity_type,
+            entity_handle: handle,
+            entity_gramps_id: entity.gramps_id,
+            tag_handle,
+            tag_count: existingTags.length - 1,
+        },
+        details: `Tag removed successfully. Entity now has ${existingTags.length - 1} tag(s).`,
+    });
+}
+// Tool definitions for MCP
+export const tagTools = {
+    gramps_list_tags: {
+        name: "gramps_list_tags",
+        description: "List all tags in the database. " +
+            "RETURNS: Tag names, handles, colors, and priorities. " +
+            "USE FOR: Finding tag handles before tagging entities.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        handler: grampsListTags,
+    },
+    gramps_create_tag: {
+        name: "gramps_create_tag",
+        description: "Create a new tag for organizing records. " +
+            "REQUIRED: name. " +
+            "OPTIONAL: color (hex format), priority. " +
+            "RETURNS: Handle to use with gramps_tag_entity.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Tag name (e.g., 'Needs Research', 'Verified')",
+                },
+                color: {
+                    type: "string",
+                    description: "Hex color for the tag (e.g., '#FF5500', '#00FF00')",
+                },
+                priority: {
+                    type: "number",
+                    description: "Priority (lower number = higher priority)",
+                },
+            },
+            required: ["name"],
+        },
+        handler: grampsCreateTag,
+    },
+    gramps_tag_entity: {
+        name: "gramps_tag_entity",
+        description: "Add a tag to any entity. " +
+            "REQUIRED: entity_type, handle, tag_handle. " +
+            "USE FOR: Categorizing, marking records for review, or organizing. " +
+            "NOTE: Safe to call if tag is already applied.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entity_type: {
+                    type: "string",
+                    enum: [
+                        "people",
+                        "families",
+                        "events",
+                        "places",
+                        "sources",
+                        "citations",
+                        "repositories",
+                        "media",
+                        "notes",
+                    ],
+                    description: "Type of entity to tag",
+                },
+                handle: {
+                    type: "string",
+                    description: "Handle of the entity to tag",
+                },
+                tag_handle: {
+                    type: "string",
+                    description: "Handle of the tag to apply (from gramps_list_tags or gramps_create_tag)",
+                },
+            },
+            required: ["entity_type", "handle", "tag_handle"],
+        },
+        handler: grampsTagEntity,
+    },
+    gramps_untag_entity: {
+        name: "gramps_untag_entity",
+        description: "Remove a tag from an entity. " +
+            "REQUIRED: entity_type, handle, tag_handle. " +
+            "NOTE: Safe to call if tag is not applied.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entity_type: {
+                    type: "string",
+                    enum: [
+                        "people",
+                        "families",
+                        "events",
+                        "places",
+                        "sources",
+                        "citations",
+                        "repositories",
+                        "media",
+                        "notes",
+                    ],
+                    description: "Type of entity to untag",
+                },
+                handle: {
+                    type: "string",
+                    description: "Handle of the entity to untag",
+                },
+                tag_handle: {
+                    type: "string",
+                    description: "Handle of the tag to remove",
+                },
+            },
+            required: ["entity_type", "handle", "tag_handle"],
+        },
+        handler: grampsUntagEntity,
+    },
+};
+//# sourceMappingURL=tags.js.map

package/dist/tools/tags.js.map

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

package/dist/tools/update.d.ts

@@ -8,7 +8,7 @@ declare const updatePersonSchema: z.ZodObject<{
     primary_name: z.ZodOptional<z.ZodObject<{
         _class: z.ZodOptional<z.ZodLiteral<"Name">>;
         first_name: z.ZodOptional<z.ZodString>;
-        call_name: z.ZodOptional<z.ZodString>;
+        nickname: z.ZodOptional<z.ZodString>;
         surname: z.ZodOptional<z.ZodString>;
         surname_list: z.ZodOptional<z.ZodArray<z.ZodObject<{
             _class: z.ZodOptional<z.ZodLiteral<"Surname">>;
@@ -42,7 +42,7 @@ declare const updatePersonSchema: z.ZodObject<{
         surname?: string | undefined;
         primary?: boolean | undefined;
         first_name?: string | undefined;
-        call_name?: string | undefined;
+        nickname?: string | undefined;
         surname_list?: {
             surname: string;
             _class?: "Surname" | undefined;
@@ -59,7 +59,7 @@ declare const updatePersonSchema: z.ZodObject<{
         surname?: string | undefined;
         primary?: boolean | undefined;
         first_name?: string | undefined;
-        call_name?: string | undefined;
+        nickname?: string | undefined;
         surname_list?: {
             surname: string;
             _class?: "Surname" | undefined;
@@ -74,7 +74,7 @@ declare const updatePersonSchema: z.ZodObject<{
     alternate_names: z.ZodOptional<z.ZodArray<z.ZodObject<{
         _class: z.ZodOptional<z.ZodLiteral<"Name">>;
         first_name: z.ZodOptional<z.ZodString>;
-        call_name: z.ZodOptional<z.ZodString>;
+        nickname: z.ZodOptional<z.ZodString>;
         surname: z.ZodOptional<z.ZodString>;
         surname_list: z.ZodOptional<z.ZodArray<z.ZodObject<{
             _class: z.ZodOptional<z.ZodLiteral<"Surname">>;
@@ -108,7 +108,7 @@ declare const updatePersonSchema: z.ZodObject<{
         surname?: string | undefined;
         primary?: boolean | undefined;
         first_name?: string | undefined;
-        call_name?: string | undefined;
+        nickname?: string | undefined;
         surname_list?: {
             surname: string;
             _class?: "Surname" | undefined;
@@ -125,7 +125,7 @@ declare const updatePersonSchema: z.ZodObject<{
         surname?: string | undefined;
         primary?: boolean | undefined;
         first_name?: string | undefined;
-        call_name?: string | undefined;
+        nickname?: string | undefined;
         surname_list?: {
             surname: string;
             _class?: "Surname" | undefined;
@@ -206,7 +206,7 @@ declare const updatePersonSchema: z.ZodObject<{
         surname?: string | undefined;
         primary?: boolean | undefined;
         first_name?: string | undefined;
-        call_name?: string | undefined;
+        nickname?: string | undefined;
         surname_list?: {
             surname: string;
             _class?: "Surname" | undefined;
@@ -224,7 +224,7 @@ declare const updatePersonSchema: z.ZodObject<{
         surname?: string | undefined;
         primary?: boolean | undefined;
         first_name?: string | undefined;
-        call_name?: string | undefined;
+        nickname?: string | undefined;
         surname_list?: {
             surname: string;
             _class?: "Surname" | undefined;
@@ -273,7 +273,7 @@ declare const updatePersonSchema: z.ZodObject<{
         surname?: string | undefined;
         primary?: boolean | undefined;
         first_name?: string | undefined;
-        call_name?: string | undefined;
+        nickname?: string | undefined;
         surname_list?: {
             surname: string;
             _class?: "Surname" | undefined;
@@ -291,7 +291,7 @@ declare const updatePersonSchema: z.ZodObject<{
         surname?: string | undefined;
         primary?: boolean | undefined;
         first_name?: string | undefined;
-        call_name?: string | undefined;
+        nickname?: string | undefined;
         surname_list?: {
             surname: string;
             _class?: "Surname" | undefined;
@@ -543,7 +543,7 @@ export declare const updateTools: {
                         surname: {
                             type: string;
                         };
-                        call_name: {
+                        nickname: {
                             type: string;
                             description: string;
                         };

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/tools/update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBtB,CAAC;AAGH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBtB,CAAC;AAeH;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,CAuHjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,CAwHjB;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHvB,CAAC"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/tools/update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBtB,CAAC;AAGH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBtB,CAAC;AAeH;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,CAkIjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,CAwHjB;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHvB,CAAC"}

package/dist/tools/update.js

@@ -75,17 +75,28 @@ export async function grampsUpdatePerson(params) {
     };
     // Handle primary_name update
     if (updateFields.primary_name) {
-        updatedPerson.primary_name = { _class: "Name", ...updateFields.primary_name };
+        const nameData = { ...updateFields.primary_name };
+        // Map nickname to call_name (API field name)
+        if (nameData.nickname) {
+            nameData.call_name = nameData.nickname;
+            delete nameData.nickname;
+        }
+        updatedPerson.primary_name = { _class: "Name", ...nameData };
     }
     else {
         updatedPerson.primary_name = existing.primary_name;
     }
     // Handle alternate_names update
     if (updateFields.alternate_names) {
-        updatedPerson.alternate_names = updateFields.alternate_names.map((n) => ({
-            _class: "Name",
-            ...n,
-        }));
+        updatedPerson.alternate_names = updateFields.alternate_names.map((n) => {
+            const nameData = { ...n };
+            // Map nickname to call_name (API field name)
+            if (nameData.nickname) {
+                nameData.call_name = nameData.nickname;
+                delete nameData.nickname;
+            }
+            return { _class: "Name", ...nameData };
+        });
     }
     else {
         updatedPerson.alternate_names = existing.alternate_names;
@@ -289,7 +300,7 @@ export const updateTools = {
                     properties: {
                         first_name: { type: "string" },
                         surname: { type: "string" },
-                        call_name: { type: "string", description: "Nickname/call name" },
+                        nickname: { type: "string", description: "Nickname (also known as call name)" },
                         suffix: { type: "string" },
                         title: { type: "string" },
                     },