neuron-mcp-server 1.0.0 → 1.1.0

package/dist/tools/contact-lists.js

@@ -3,14 +3,19 @@ import { api, jsonResult, errorResult } from "../client.js";
 export function registerContactListsTools(server) {
     server.registerTool("neuron_list_contact_lists", {
         title: "List Contact Lists",
-        description: "List all contact lists with optional search, type filter, and pagination",
+        description: "Retrieve all contact lists for the current organization with optional filtering by search term, type, and pagination.",
         inputSchema: z.object({
-            search: z.string().optional().describe("Search by name or slug"),
-            type: z.string().optional().describe("Filter by type: static, dynamic, merged"),
-            page: z.number().int().positive().optional().describe("Page number"),
-            limit: z.number().int().positive().optional().describe("Items per page"),
+            search: z.string().optional().describe("Search term to filter lists by name or slug"),
+            type: z.string().optional().describe("Filter by list type: 'static', 'dynamic', or 'merged'"),
+            page: z.number().int().positive().optional().describe("Page number for pagination (default: 1)"),
+            limit: z.number().int().positive().optional().describe("Number of items per page (default: 20)"),
         }),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("GET", "/contact-lists", undefined, {
@@ -27,11 +32,16 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_get_contact_list", {
         title: "Get Contact List",
-        description: "Get a contact list by ID or slug, including member count",
+        description: "Retrieve detailed information about a specific contact list, including member count and configuration.",
         inputSchema: z.object({
-            idOrSlug: z.string().describe("The list ID (UUID) or slug"),
+            idOrSlug: z.string().describe("Unique identifier (UUID) or URL-friendly slug of the contact list"),
         }),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("GET", `/contact-lists/${params.idOrSlug}`);
@@ -43,15 +53,21 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_create_contact_list", {
         title: "Create Contact List",
-        description: "Create a new contact list. Slug is auto-generated from name if not provided. For dynamic lists, provide criteria with rules and/or aiPrompt.",
+        description: "Create a new contact list. Slug is auto-generated from name if not provided. For dynamic lists, provide criteria with rules and/or an AI prompt.",
         inputSchema: z.object({
-            name: z.string().describe("Display name for the list"),
-            slug: z.string().optional().describe("URL-friendly identifier (auto-generated if omitted)"),
-            description: z.string().optional().describe("Optional description"),
-            type: z.enum(["static", "dynamic", "merged"]).optional().describe("List type (default: static)"),
-            criteria: z.record(z.unknown()).optional().describe("For dynamic lists: { rules?: { operator, conditions }, aiPrompt?, aiMaxResults? }"),
-            refreshSchedule: z.enum(["manual", "daily", "weekly", "on_access"]).optional().describe("Refresh schedule for dynamic lists (default: manual)"),
+            name: z.string().describe("Display name for the contact list"),
+            slug: z.string().optional().describe("URL-friendly identifier (auto-generated from name if omitted)"),
+            description: z.string().optional().describe("Human-readable description of the list's purpose"),
+            type: z.enum(["static", "dynamic", "merged"]).optional().describe("List type (default: 'static')"),
+            criteria: z.record(z.unknown()).optional().describe("Dynamic list criteria object: { rules?: { operator, conditions }, aiPrompt?, aiMaxResults? }"),
+            refreshSchedule: z.enum(["manual", "daily", "weekly", "on_access"]).optional().describe("Refresh schedule for dynamic lists (default: 'manual')"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("POST", "/contact-lists", params);
@@ -63,15 +79,21 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_update_contact_list", {
         title: "Update Contact List",
-        description: "Update a contact list's name, slug, description, criteria, or refresh schedule",
+        description: "Update an existing contact list's name, slug, description, criteria, or refresh schedule.",
         inputSchema: z.object({
-            idOrSlug: z.string().describe("The list ID (UUID) or slug"),
-            name: z.string().optional().describe("New name"),
-            slug: z.string().optional().describe("New slug"),
-            description: z.string().optional().describe("New description"),
-            criteria: z.record(z.unknown()).optional().nullable().describe("For dynamic lists: criteria rules/AI prompt. Set to null to clear."),
-            refreshSchedule: z.enum(["manual", "daily", "weekly", "on_access"]).optional().describe("Refresh schedule for dynamic lists"),
+            idOrSlug: z.string().describe("Unique identifier (UUID) or URL-friendly slug of the contact list to update"),
+            name: z.string().optional().describe("Updated display name for the list"),
+            slug: z.string().optional().describe("Updated URL-friendly slug for the list"),
+            description: z.string().optional().describe("Updated description of the list's purpose"),
+            criteria: z.record(z.unknown()).optional().nullable().describe("Updated dynamic list criteria. Set to null to clear existing criteria."),
+            refreshSchedule: z.enum(["manual", "daily", "weekly", "on_access"]).optional().describe("Updated refresh schedule for dynamic lists"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const { idOrSlug, ...body } = params;
@@ -84,11 +106,16 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_delete_contact_list", {
         title: "Delete Contact List",
-        description: "Delete a contact list. System lists (like 'Do Not Contact') cannot be deleted.",
+        description: "Permanently delete a contact list. System-protected lists (e.g., 'Do Not Contact') cannot be deleted.",
         inputSchema: z.object({
-            idOrSlug: z.string().describe("The list ID (UUID) or slug"),
+            idOrSlug: z.string().describe("Unique identifier (UUID) or URL-friendly slug of the contact list to delete"),
         }),
-        annotations: { destructiveHint: true },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("DELETE", `/contact-lists/${params.idOrSlug}`);
@@ -100,14 +127,19 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_get_contact_list_members", {
         title: "Get Contact List Members",
-        description: "List members of a contact list with search and pagination",
+        description: "Retrieve the members of a specific contact list with optional search filtering and pagination.",
         inputSchema: z.object({
-            idOrSlug: z.string().describe("The list ID (UUID) or slug"),
-            search: z.string().optional().describe("Search members by name or phone"),
-            page: z.number().int().positive().optional().describe("Page number"),
-            limit: z.number().int().positive().optional().describe("Items per page"),
+            idOrSlug: z.string().describe("Unique identifier (UUID) or URL-friendly slug of the contact list"),
+            search: z.string().optional().describe("Search term to filter members by name or phone number"),
+            page: z.number().int().positive().optional().describe("Page number for pagination (default: 1)"),
+            limit: z.number().int().positive().optional().describe("Number of items per page (default: 20)"),
         }),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("GET", `/contact-lists/${params.idOrSlug}/members`, undefined, {
@@ -123,14 +155,20 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_add_to_contact_list", {
         title: "Add to Contact List",
-        description: "Add contacts to a list by contact ID or phone number. Phone numbers without existing contacts are auto-created as minimal contacts.",
+        description: "Add one or more contacts to a list by contact ID or phone number. Phone numbers without existing contacts are auto-created as minimal contact records.",
         inputSchema: z.object({
-            idOrSlug: z.string().describe("The list ID (UUID) or slug"),
+            idOrSlug: z.string().describe("Unique identifier (UUID) or URL-friendly slug of the target contact list"),
             entries: z.array(z.object({
-                contactId: z.string().optional().describe("Contact UUID"),
-                phone: z.string().optional().describe("Phone number (creates contact if needed)"),
-            })).describe("Contacts to add"),
+                contactId: z.string().optional().describe("Unique identifier (UUID) of an existing contact"),
+                phone: z.string().optional().describe("Phone number in E.164 format (e.g., +2348012345678). Creates a new contact if no match exists."),
+            })).describe("Array of contacts to add, each identified by contactId or phone number"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("POST", `/contact-lists/${params.idOrSlug}/members`, {
@@ -144,12 +182,17 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_remove_from_contact_list", {
         title: "Remove from Contact List",
-        description: "Remove contacts from a list by their contact IDs",
+        description: "Remove one or more contacts from a list by their contact IDs. Does not delete the contacts themselves.",
         inputSchema: z.object({
-            idOrSlug: z.string().describe("The list ID (UUID) or slug"),
-            contactIds: z.array(z.string()).describe("Contact UUIDs to remove"),
+            idOrSlug: z.string().describe("Unique identifier (UUID) or URL-friendly slug of the contact list"),
+            contactIds: z.array(z.string()).describe("Array of contact UUIDs to remove from the list"),
         }),
-        annotations: { destructiveHint: true },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("DELETE", `/contact-lists/${params.idOrSlug}/members`, {
@@ -163,13 +206,19 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_merge_contact_lists", {
         title: "Merge Contact Lists",
-        description: "Create a new list by merging multiple source lists. Window merge creates a virtual union; materialized merge creates a static copy.",
+        description: "Merge two or more contact lists into a single unified list, deduplicating entries. Window merge creates a virtual union; materialized merge creates a static copy.",
         inputSchema: z.object({
-            name: z.string().describe("Name for the merged list"),
-            sourceListIds: z.array(z.string()).min(2).describe("IDs or slugs of lists to merge"),
-            mergeType: z.enum(["window", "materialized"]).describe("Merge type: window (virtual union) or materialized (static copy)"),
-            slug: z.string().optional().describe("Optional slug for the merged list"),
+            name: z.string().describe("Display name for the resulting merged list"),
+            sourceListIds: z.array(z.string()).min(2).describe("UUIDs or slugs of the source lists to merge (minimum 2)"),
+            mergeType: z.enum(["window", "materialized"]).describe("Merge strategy: 'window' (virtual union, stays in sync) or 'materialized' (static copy at merge time)"),
+            slug: z.string().optional().describe("URL-friendly slug for the merged list (auto-generated if omitted)"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("POST", "/contact-lists/merge", params);
@@ -181,11 +230,16 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_find_contact_lists_for_contact", {
         title: "Find Contact Lists for Contact",
-        description: "Find which contact lists a specific contact belongs to",
+        description: "Retrieve all contact lists that a specific contact belongs to.",
         inputSchema: z.object({
-            contactId: z.string().describe("The contact UUID"),
+            contactId: z.string().describe("Unique identifier (UUID) of the contact to look up"),
         }),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("GET", `/contact-lists/by-contact/${params.contactId}`);
@@ -197,10 +251,16 @@ export function registerContactListsTools(server) {
     });
     server.registerTool("neuron_refresh_contact_list", {
         title: "Refresh Contact List",
-        description: "Trigger a refresh of a dynamic contact list. Re-evaluates criteria rules and/or AI prompt, materializes updated members.",
+        description: "Trigger a refresh of a dynamic contact list. Re-evaluates criteria rules and/or AI prompt and materializes updated members.",
         inputSchema: z.object({
-            idOrSlug: z.string().describe("The dynamic list ID (UUID) or slug"),
+            idOrSlug: z.string().describe("Unique identifier (UUID) or URL-friendly slug of the dynamic list to refresh"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("POST", `/contact-lists/${params.idOrSlug}/refresh`);

package/dist/tools/contact-lists.js.map

@@ -1 +1 @@
-{"version":3,"file":"contact-lists.js","sourceRoot":"","sources":["../../src/tools/contact-lists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,0EAA0E;QACvF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAChE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YAC/E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACzE,CAAC;QACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE;gBAC3D,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SAC5D,CAAC;QACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,kBAAkB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACrE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,8IAA8I;QAC3J,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;YAC3F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACnE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAChG,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mFAAmF,CAAC;YACxI,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;SAChJ,CAAC;KACH,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;YAC3D,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC3D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;YAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;YAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;YACpI,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SAC9H,CAAC;KACH,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,kBAAkB,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;YACpE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SAC5D,CAAC;QACF,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,kBAAkB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACxE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iCAAiC,EACjC;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,2DAA2D;QACxE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACzE,CAAC;QACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,kBAAkB,MAAM,CAAC,QAAQ,UAAU,EAAE,SAAS,EAAE;gBACtF,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,qIAAqI;QAClJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC3D,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;gBACP,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;gBACzD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;aAClF,CAAC,CACH,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SAC9B,CAAC;KACH,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,kBAAkB,MAAM,CAAC,QAAQ,UAAU,EAAE;gBAC5E,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iCAAiC,EACjC;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,kDAAkD;QAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC3D,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SACpE,CAAC;QACF,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,kBAAkB,MAAM,CAAC,QAAQ,UAAU,EAAE;gBAC9E,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,qIAAqI;QAClJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACrD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACpF,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,kEAAkE,CAAC;YAC1H,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SAC1E,CAAC;KACH,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAC;YACjE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,uCAAuC,EACvC;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SACnD,CAAC;QACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,6BAA6B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YACjF,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,0HAA0H;QACvI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SACpE,CAAC;KACH,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,kBAAkB,MAAM,CAAC,QAAQ,UAAU,CAAC,CAAC;YAC9E,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"contact-lists.js","sourceRoot":"","sources":["../../src/tools/contact-lists.ts"],"names":[],"mappings":"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"}

package/dist/tools/contacts.js

@@ -1,22 +1,31 @@
 import { z } from "zod";
-import { api, jsonResult, errorResult, getAuthToken } from "../client.js";
+import { api, jsonResult, errorResult, getAuthToken, getBaseUrl } from "../client.js";
 export function registerContactsTools(server) {
     // List contacts
     server.registerTool("neuron_list_contacts", {
         title: "List Contacts",
-        description: "List contacts with optional filtering by search term, tag, and pagination",
+        description: "Retrieve all contacts for the current organization with optional filtering by search term, tag, and pagination.",
         inputSchema: z.object({
-            search: z.string().optional().describe("Search term to filter contacts by name, phone, or email"),
-            tag: z.string().optional().describe("Filter contacts by tag"),
-            page: z.number().int().positive().optional().describe("Page number for pagination"),
-            limit: z.number().int().positive().optional().describe("Number of contacts per page"),
+            search: z.string().optional().describe("Search term to filter contacts by name, phone number, or email address"),
+            tag: z.string().optional().describe("Tag name to filter contacts by category"),
+            doNotBroadcast: z.boolean().optional().describe("Filter to contacts that are (true) or are not (false) excluded from broadcasts"),
+            doNotAutoRespond: z.boolean().optional().describe("Filter to contacts the bot will never (true) / may (false) auto-respond to"),
+            page: z.number().int().positive().optional().describe("Page number for pagination (default: 1)"),
+            limit: z.number().int().positive().optional().describe("Number of contacts per page (default: 20)"),
         }),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("GET", "/contacts", undefined, {
                 search: params.search,
                 tag: params.tag,
+                doNotBroadcast: params.doNotBroadcast === undefined ? undefined : String(params.doNotBroadcast),
+                doNotAutoRespond: params.doNotAutoRespond === undefined ? undefined : String(params.doNotAutoRespond),
                 page: params.page,
                 limit: params.limit,
             });
@@ -29,11 +38,16 @@ export function registerContactsTools(server) {
     // Search contacts
     server.registerTool("neuron_search_contacts", {
         title: "Search Contacts",
-        description: "Search contacts by a query string across name, phone, and email fields",
+        description: "Search contacts by a query string across name, phone number, and email fields. Returns matching contacts ranked by relevance.",
         inputSchema: z.object({
-            q: z.string().describe("Search query string"),
+            q: z.string().describe("Search query string to match against contact name, phone, or email"),
         }),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("GET", "/contacts/search", undefined, { q: params.q });
@@ -46,11 +60,16 @@ export function registerContactsTools(server) {
     // Get contact
     server.registerTool("neuron_get_contact", {
         title: "Get Contact",
-        description: "Get detailed information about a specific contact by ID",
+        description: "Retrieve detailed information about a specific contact including their tags, notes, and associated lists.",
         inputSchema: z.object({
-            id: z.string().describe("The unique identifier of the contact"),
+            id: z.string().describe("Unique identifier (UUID) of the contact"),
         }),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("GET", `/contacts/${params.id}`);
@@ -63,14 +82,22 @@ export function registerContactsTools(server) {
     // Create contact
     server.registerTool("neuron_create_contact", {
         title: "Create Contact",
-        description: "Create a new contact. If notes are provided, they are saved as a structured note entry with source tracking.",
+        description: "Create a new contact in the organization's address book. If notes are provided, they are saved as a structured note entry with source tracking.",
         inputSchema: z.object({
             name: z.string().describe("Full name of the contact"),
-            phone: z.string().describe("Phone number of the contact"),
+            phone: z.string().describe("Contact phone number in E.164 format (e.g., +2348012345678)"),
             email: z.string().optional().describe("Email address of the contact"),
-            tags: z.array(z.string()).optional().describe("Tags to categorize the contact"),
-            notes: z.string().optional().describe("Additional notes about the contact"),
+            tags: z.array(z.string()).optional().describe("Tags to categorize the contact (e.g., ['vendor', 'lagos'])"),
+            notes: z.string().optional().describe("Additional notes about the contact, saved as a structured entry"),
+            doNotBroadcast: z.boolean().optional().describe("If true, this contact is permanently excluded from all broadcasts"),
+            doNotAutoRespond: z.boolean().optional().describe("If true, the bot will never auto-respond to this contact (manual/API and human sends still work)"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("POST", "/contacts", params);
@@ -83,15 +110,23 @@ export function registerContactsTools(server) {
     // Update contact
     server.registerTool("neuron_update_contact", {
         title: "Update Contact",
-        description: "Update an existing contact. If notes are provided, they are added as a new structured note entry (does not overwrite existing notes).",
+        description: "Update an existing contact's details. If notes are provided, they are appended as a new structured note entry without overwriting existing notes.",
         inputSchema: z.object({
-            id: z.string().describe("The unique identifier of the contact to update"),
-            name: z.string().optional().describe("New name for the contact"),
-            phone: z.string().optional().describe("New phone number for the contact"),
-            email: z.string().optional().describe("New email address for the contact"),
-            tags: z.array(z.string()).optional().describe("New tags for the contact"),
-            notes: z.string().optional().describe("New notes about the contact"),
+            id: z.string().describe("Unique identifier (UUID) of the contact to update"),
+            name: z.string().optional().describe("Updated full name for the contact"),
+            phone: z.string().optional().describe("Updated phone number in E.164 format (e.g., +2348012345678)"),
+            email: z.string().optional().describe("Updated email address for the contact"),
+            tags: z.array(z.string()).optional().describe("Updated tags for the contact (replaces existing tags)"),
+            notes: z.string().optional().describe("New note to append to the contact's existing notes"),
+            doNotBroadcast: z.boolean().optional().describe("Set true to exclude this contact from all broadcasts, false to allow"),
+            doNotAutoRespond: z.boolean().optional().describe("Set true so the bot never auto-responds to this contact, false to allow (manual/API and human sends are unaffected either way)"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const { id, ...body } = params;
@@ -105,11 +140,16 @@ export function registerContactsTools(server) {
     // Delete contact
     server.registerTool("neuron_delete_contact", {
         title: "Delete Contact",
-        description: "Permanently delete a contact. This action cannot be undone.",
+        description: "Permanently delete a contact and remove them from all contact lists. This action cannot be undone.",
         inputSchema: z.object({
-            id: z.string().describe("The unique identifier of the contact to delete"),
+            id: z.string().describe("Unique identifier (UUID) of the contact to delete"),
         }),
-        annotations: { destructiveHint: true },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("DELETE", `/contacts/${params.id}`);
@@ -122,9 +162,14 @@ export function registerContactsTools(server) {
     // Export contacts
     server.registerTool("neuron_export_contacts", {
         title: "Export Contacts",
-        description: "Export all contacts from the system",
+        description: "Export all contacts as a downloadable dataset for the current organization.",
         inputSchema: z.object({}),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async () => {
         try {
             const result = await api("GET", "/contacts/export");
@@ -137,16 +182,22 @@ export function registerContactsTools(server) {
     // Import contacts
     server.registerTool("neuron_import_contacts", {
         title: "Import Contacts",
-        description: "Import multiple contacts at once. Provide an array of contact objects.",
+        description: "Bulk import multiple contacts into the organization's address book. Accepts an array of contact objects with name, phone, and optional fields.",
         inputSchema: z.object({
             contacts: z.array(z.object({
                 name: z.string().describe("Full name of the contact"),
-                phone: z.string().describe("Phone number of the contact"),
-                email: z.string().optional().describe("Email address"),
+                phone: z.string().describe("Contact phone number in E.164 format (e.g., +2348012345678)"),
+                email: z.string().optional().describe("Email address of the contact"),
                 tags: z.array(z.string()).optional().describe("Tags to categorize the contact"),
-                notes: z.string().optional().describe("Additional notes"),
-            })).describe("Array of contacts to import"),
+                notes: z.string().optional().describe("Additional notes about the contact"),
+            })).describe("Array of contact objects to import into the organization"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const result = await api("POST", "/contacts/import", { contacts: params.contacts });
@@ -159,8 +210,14 @@ export function registerContactsTools(server) {
     // Populate contacts
     server.registerTool("neuron_populate_contacts", {
         title: "Populate Contacts",
-        description: "Populate contacts with additional data from connected channels",
+        description: "Enrich existing contacts with additional data from connected messaging channels. Syncs profile information from linked platforms.",
         inputSchema: z.object({}),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async () => {
         try {
             const result = await api("POST", "/contacts/populate");
@@ -173,8 +230,14 @@ export function registerContactsTools(server) {
     // Sync WhatsApp contacts
     server.registerTool("neuron_sync_whatsapp_contacts", {
         title: "Sync WhatsApp Contacts",
-        description: "Synchronize contacts from connected WhatsApp channels into the contacts database",
+        description: "Synchronize contacts from all connected WhatsApp channels into the organization's contact database. Creates new contacts for unseen numbers.",
         inputSchema: z.object({}),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async () => {
         try {
             const result = await api("POST", "/contacts/sync-whatsapp");
@@ -189,10 +252,15 @@ export function registerContactsTools(server) {
         title: "Semantic Search Contacts",
         description: "Search contacts using natural language AI-powered semantic search. Finds contacts based on the meaning of their notes — skills, services, schedules, preferences, etc. Returns ranked results with relevance scores and AI-generated match reasons.",
         inputSchema: z.object({
-            query: z.string().describe("Natural language search query (e.g. 'who can deliver to Lagos on Monday?')"),
-            limit: z.number().int().positive().max(20).optional().describe("Maximum number of results to return (default 10, max 20)"),
+            query: z.string().describe("Natural language search query (e.g., 'who can deliver to Lagos on Monday?')"),
+            limit: z.number().int().positive().max(20).optional().describe("Maximum number of results to return (default: 10, max: 20)"),
         }),
-        annotations: { readOnlyHint: true },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             const queryParams = { q: params.query };
@@ -209,15 +277,21 @@ export function registerContactsTools(server) {
     server.registerTool("neuron_audio_contact", {
         title: "Extract Contact from Audio",
         description: "Transcribe an audio recording and extract contact information (name, phone, email, notes, tags). " +
-            "Auto-saves the contact. Provide base64-encoded audio data.",
+            "Automatically saves the extracted contact to the organization's address book.",
         inputSchema: z.object({
-            audioBase64: z.string().describe("Base64-encoded audio data"),
+            audioBase64: z.string().describe("Base64-encoded audio data containing spoken contact information"),
             audioFormat: z
                 .string()
                 .optional()
                 .default("webm")
-                .describe("Audio format hint (default: webm)"),
+                .describe("Audio format hint for decoding (default: 'webm')"),
         }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     }, async (params) => {
         try {
             // Decode base64 to buffer and create a File-like object for the API
@@ -227,8 +301,7 @@ export function registerContactsTools(server) {
             const formData = new FormData();
             formData.append("audio", blob, `recording.${params.audioFormat || "webm"}`);
             // Use raw fetch since api() doesn't handle FormData
-            const baseUrl = process.env.NEURON_API_URL || "https://api.neuron.ng";
-            const response = await fetch(`${baseUrl}/api/v1/contacts/extract-audio`, {
+            const response = await fetch(`${getBaseUrl()}/contacts/extract-audio`, {
                 method: "POST",
                 headers: {
                     Authorization: `Bearer ${getAuthToken()}`,