@respond-io/mcp-server 1.0.0

package/dist/protocol/StdioProtocol.js

@@ -0,0 +1,32 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "../server.js";
+import { BaseProtocol } from "./BaseProtocol.js";
+export class StdioProtocol extends BaseProtocol {
+    apiBaseUrl;
+    debug;
+    constructor(options) {
+        super();
+        this.apiBaseUrl = options.apiBaseUrl;
+        this.debug = options.debug;
+    }
+    async init() {
+        const transport = new StdioServerTransport();
+        const { server } = createServer({
+            apiBaseUrl: this.apiBaseUrl,
+            debug: this.debug,
+            mode: "stdio",
+        });
+        try {
+            await server.connect(transport);
+            console.error("MCP STDIO Server listening");
+        }
+        catch (error) {
+            console.error("Failed to set up the server:", error);
+            throw error;
+        }
+    }
+    async close() {
+        // No-op for STDIO
+    }
+}
+//# sourceMappingURL=StdioProtocol.js.map

package/dist/protocol/StdioProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdioProtocol.js","sourceRoot":"","sources":["../../src/protocol/StdioProtocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQjD,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC5B,UAAU,CAAS;IACnB,KAAK,CAAU;IAEhC,YAAY,OAAoB;QAC9B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC;YAC9B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,OAAO;SACM,CAAC,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,kBAAkB;IACpB,CAAC;CACF"}

package/dist/protocol/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./BaseProtocol.js";
+export * from "./HttpStreamProtocol.js";
+export * from "./StdioProtocol.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,4 @@
+export * from "./BaseProtocol.js";
+export * from "./HttpStreamProtocol.js";
+export * from "./StdioProtocol.js";
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MCPServerOptions } from "./types.js";
+/**
+ * Creates and configures the MCP server.
+ * This function initializes the MCP server, registers all the available tools, and returns the server instance.
+ *
+ * @param {MCPServerOptions} options - The options for configuring the server, including the API base URL, debug mode, and server mode.
+ * @returns {{ server: McpServer }} - An object containing the configured MCP server instance.
+ */
+export declare const createServer: (options: MCPServerOptions) => {
+    server: McpServer;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,gBAAgB;;CAuBrD,CAAC"}

package/dist/server.js

@@ -0,0 +1,36 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ContactsTool } from "./tools/index.js";
+import { MessagingTool } from "./tools/messaging.tool.js";
+import { ConversationTool } from "./tools/conversation.tool.js";
+import { CommentTool } from "./tools/comment.tool.js";
+import { WorkspaceTool } from "./tools/workspace.tool.js";
+import { API_CONFIG } from "./constants.js";
+/**
+ * Creates and configures the MCP server.
+ * This function initializes the MCP server, registers all the available tools, and returns the server instance.
+ *
+ * @param {MCPServerOptions} options - The options for configuring the server, including the API base URL, debug mode, and server mode.
+ * @returns {{ server: McpServer }} - An object containing the configured MCP server instance.
+ */
+export const createServer = (options) => {
+    // Print startup configuration (excluding sensitive info)
+    console.error(`[INFO] Respond.io MCP Server starting...
+      API Base: ${API_CONFIG.BASE_URL}
+      Debug: ${options.debug ? "enabled" : "disabled"}
+      Mode: ${options.mode}
+      ${options.mode === "http" ? `HTTP mode on HTTP port: ${process.env.PORT}` : options.mode === "stdio" ? `STDIO mode` : ""}
+    `);
+    // Create server instance
+    const server = new McpServer({
+        name: "Respond.io MCP Server",
+        version: "1.0.1",
+    });
+    // Register all the tools with the server
+    new ContactsTool(options).register(server);
+    new MessagingTool(options).register(server);
+    new ConversationTool(options).register(server);
+    new CommentTool(options).register(server);
+    new WorkspaceTool(options).register(server);
+    return { server };
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAyB,EAAE,EAAE;IACxD,yDAAyD;IACzD,OAAO,CAAC,KAAK,CAAC;kBACE,UAAU,CAAC,QAAQ;eACtB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;cACvC,OAAO,CAAC,IAAI;QAClB,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,2BAA2B,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;KACzH,CAAC,CAAC;IAEL,yBAAyB;IACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,yCAAyC;IACzC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC,CAAC"}

package/dist/tools/BaseTool.d.ts

@@ -0,0 +1,38 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MCPServerOptions, Tool } from "../types.js";
+/**
+ * Abstract base class for creating tools to register with the MCP server.
+ * It simplifies tool creation by handling common initialization and registration logic.
+ */
+export declare abstract class BaseTool {
+    /**
+     * An array of tool definitions to be registered with the MCP server.
+     * Each tool definition includes its name, description, schema, and handler.
+     */
+    protected abstract tools: Tool[];
+    /**
+     * The base URL for the API, used by all tools.
+     */
+    protected readonly apiBaseUrl: string;
+    /**
+     * A flag indicating whether debug mode is enabled.
+     */
+    protected readonly debug: boolean;
+    /**
+     * The mode in which the server is running, either "http" or "stdio."
+     */
+    protected readonly mode: "http" | "stdio";
+    /**
+     * Initializes the BaseTool with the given server options.
+     * @param {MCPServerOptions} options - The server options, including the API base URL, API token, debug flag, and mode.
+     */
+    constructor({ apiBaseUrl, debug, mode }: MCPServerOptions);
+    /**
+     * Registers all the tools defined in the `tools` array with the MCP server.
+     * This method iterates over the `tools` array and registers each tool
+     * with the server using its name, description, schema, and handler.
+     * @param {McpServer} server - The MCP server instance to register the tools with.
+     */
+    register(server: McpServer): void;
+}
+//# sourceMappingURL=BaseTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTool.d.ts","sourceRoot":"","sources":["../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAErD;;;GAGG;AACH,8BAAsB,QAAQ;IAC5B;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAEtC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAElC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1C;;;OAGG;gBACS,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,gBAAgB;IAMzD;;;;;OAKG;IACI,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAKzC"}

package/dist/tools/BaseTool.js

@@ -0,0 +1,39 @@
+/**
+ * Abstract base class for creating tools to register with the MCP server.
+ * It simplifies tool creation by handling common initialization and registration logic.
+ */
+export class BaseTool {
+    /**
+     * The base URL for the API, used by all tools.
+     */
+    apiBaseUrl;
+    /**
+     * A flag indicating whether debug mode is enabled.
+     */
+    debug;
+    /**
+     * The mode in which the server is running, either "http" or "stdio."
+     */
+    mode;
+    /**
+     * Initializes the BaseTool with the given server options.
+     * @param {MCPServerOptions} options - The server options, including the API base URL, API token, debug flag, and mode.
+     */
+    constructor({ apiBaseUrl, debug, mode }) {
+        this.apiBaseUrl = apiBaseUrl;
+        this.debug = debug;
+        this.mode = mode;
+    }
+    /**
+     * Registers all the tools defined in the `tools` array with the MCP server.
+     * This method iterates over the `tools` array and registers each tool
+     * with the server using its name, description, schema, and handler.
+     * @param {McpServer} server - The MCP server instance to register the tools with.
+     */
+    register(server) {
+        for (const { name, description, schema, handler } of this.tools) {
+            server.tool(name, description, schema, handler);
+        }
+    }
+}
+//# sourceMappingURL=BaseTool.js.map

package/dist/tools/BaseTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAgB,QAAQ;IAO5B;;OAEG;IACgB,UAAU,CAAS;IAEtC;;OAEG;IACgB,KAAK,CAAU;IAElC;;OAEG;IACgB,IAAI,CAAmB;IAE1C;;;OAGG;IACH,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAoB;QACvD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,MAAiB;QAC/B,KAAK,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF"}

package/dist/tools/comment.tool.d.ts

@@ -0,0 +1,14 @@
+import { BaseTool } from "./BaseTool.js";
+import { Tool } from "../types.js";
+/**
+ * A tool for managing comments on contacts.
+ * This tool allows you to create comments for a given contact, which can be used for internal notes and collaboration.
+ */
+export declare class CommentTool extends BaseTool {
+    /**
+     * The list of tools provided by the CommentTool.
+     * It includes the `create_comment` tool, which allows you to add a comment to a contact.
+     */
+    protected tools: Tool[];
+}
+//# sourceMappingURL=comment.tool.d.ts.map

package/dist/tools/comment.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.tool.d.ts","sourceRoot":"","sources":["../../src/tools/comment.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC,OAAO,EAAO,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CA6BrB;CACH"}

package/dist/tools/comment.tool.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { BaseTool } from "./BaseTool.js";
+import { createSdkClient, formatContactIdentifier, handleSdkError, handleSdkResponse, } from "../utils/api.js";
+/**
+ * A tool for managing comments on contacts.
+ * This tool allows you to create comments for a given contact, which can be used for internal notes and collaboration.
+ */
+export class CommentTool extends BaseTool {
+    /**
+     * The list of tools provided by the CommentTool.
+     * It includes the `create_comment` tool, which allows you to add a comment to a contact.
+     */
+    tools = [
+        {
+            name: "create_comment",
+            description: "Add a comment to a contact for internal reference.",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number."),
+                text: z
+                    .string()
+                    .max(1000)
+                    .describe("The comment text. Max 1000 characters. To mention a user, use the format {{@user.ID}}."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier, text } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    const result = await sdkClient.comments.create(formattedIdentifier, {
+                        text,
+                    });
+                    return handleSdkResponse(result);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=comment.tool.js.map

package/dist/tools/comment.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.tool.js","sourceRoot":"","sources":["../../src/tools/comment.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC;;;OAGG;IACO,KAAK,GAAW;QACxB;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,oDAAoD;YACjE,MAAM,EAAE;gBACN,UAAU,EAAE,CAAC;qBACV,MAAM,EAAE;qBACR,QAAQ,CAAC,4EAA4E,CAAC;gBACzF,IAAI,EAAE,CAAC;qBACJ,MAAM,EAAE;qBACR,GAAG,CAAC,IAAI,CAAC;qBACT,QAAQ,CACP,wFAAwF,CACzF;aACJ;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;gBAC3B,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,IAA4C,CAAC;gBAC1E,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,GAAU,CAAC,CAAC;oBAC1E,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;oBAChE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE;wBAClE,IAAI;qBACL,CAAC,CAAC;oBACH,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF;KACF,CAAC;CACH"}

package/dist/tools/contacts.tool.d.ts

@@ -0,0 +1,17 @@
+import { BaseTool } from "./BaseTool.js";
+import { Tool } from "../types.js";
+/**
+ * A tool for managing contacts.
+ * This tool provides a comprehensive set of functionalities for contact management,
+ * including creating, retrieving, updating, deleting, and listing contacts,
+ * as well as managing contact tags.
+ */
+export declare class ContactsTool extends BaseTool {
+    /**
+     * The list of tools provided by the ContactsTool.
+     * It includes tools for getting, creating, updating, deleting, and listing contacts,
+     * as well as adding and removing tags from a contact.
+     */
+    protected tools: Tool[];
+}
+//# sourceMappingURL=contacts.tool.d.ts.map

package/dist/tools/contacts.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.tool.d.ts","sourceRoot":"","sources":["../../src/tools/contacts.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQzC,OAAO,EAAO,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAsYrB;CACH"}

package/dist/tools/contacts.tool.js

@@ -0,0 +1,355 @@
+import { z } from "zod";
+import { BaseTool } from "./BaseTool.js";
+import { createSdkClient, formatContactIdentifier, handleSdkError, handleSdkResponse, } from "../utils/api.js";
+/**
+ * A tool for managing contacts.
+ * This tool provides a comprehensive set of functionalities for contact management,
+ * including creating, retrieving, updating, deleting, and listing contacts,
+ * as well as managing contact tags.
+ */
+export class ContactsTool extends BaseTool {
+    /**
+     * The list of tools provided by the ContactsTool.
+     * It includes tools for getting, creating, updating, deleting, and listing contacts,
+     * as well as adding and removing tags from a contact.
+     */
+    tools = [
+        {
+            name: "get_contact",
+            description: "Retrieve information about a specific contact by their ID, email, or phone number.",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number, formatted as 'id:123', 'email:user@example.com', or 'phone:+1234567890'."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    const contact = await sdkClient.contacts.get(formattedIdentifier);
+                    return handleSdkResponse(contact);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "create_contact",
+            description: "Create a new contact in the workspace.",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier, using their phone or email, formatted as 'email:user@example.com' or 'phone:+1234567890'."),
+                firstName: z.string().describe("The first name of the contact."),
+                lastName: z.string().optional().describe("The last name of the contact."),
+                email: z.string().optional().describe("The contact's email address."),
+                phone: z
+                    .string()
+                    .optional()
+                    .describe("The contact's phone number, including the country code (e.g., +60123456789)."),
+                language: z
+                    .string()
+                    .optional()
+                    .describe("The contact's language code, based on the ISO 639-1 standard (e.g., 'en' for English, 'ms' for Malay)."),
+                custom_fields: z
+                    .array(z.object({
+                    name: z.string(),
+                    value: z.any(),
+                }))
+                    .optional()
+                    .describe("An array of custom field objects, each with a name and value."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier, firstName, lastName, phone, email, language, custom_fields } = args;
+                const data = { firstName, lastName, phone, email, language, custom_fields };
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    // For creation, we need email: or phone: format, not id:
+                    let formattedIdentifier;
+                    if (identifier.includes("@")) {
+                        formattedIdentifier = `email:${identifier}`;
+                    }
+                    else if (identifier.startsWith("+") || /^\d+$/.test(identifier)) {
+                        formattedIdentifier = `phone:${identifier.startsWith("+") ? identifier : "+" + identifier}`;
+                    }
+                    else {
+                        formattedIdentifier = `email:${identifier}`; // Default to email
+                    }
+                    const contact = await sdkClient.contacts.create(formattedIdentifier, data);
+                    return handleSdkResponse(contact);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "update_contact",
+            description: "Update an existing contact's information.",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number."),
+                firstName: z.string().optional().describe("The contact's new first name."),
+                lastName: z.string().optional().describe("The contact's new last name."),
+                email: z.string().optional().describe("The contact's new email address."),
+                phone: z.string().optional().describe("The contact's new phone number."),
+                language: z.string().optional().describe("The contact's new language code."),
+                custom_fields: z.array(z.any()).optional().describe("An array of custom fields to update."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier, ...data } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    const contact = await sdkClient.contacts.update(formattedIdentifier, data);
+                    return handleSdkResponse(contact);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "delete_contact",
+            description: "Delete a contact from the workspace.",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    await sdkClient.contacts.delete(formattedIdentifier);
+                    return handleSdkResponse({ success: true, message: "Contact deleted successfully" });
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "list_contacts",
+            description: "List contacts with optional filters and search.",
+            schema: {
+                limit: z
+                    .number()
+                    .min(1)
+                    .max(100)
+                    .default(10)
+                    .describe("The number of contacts to return, between 1 and 100."),
+                cursorId: z.number().optional().describe("The cursor ID for pagination."),
+                search: z.string().optional().describe("A search query to filter contacts."),
+                timezone: z
+                    .string()
+                    .default("UTC")
+                    .describe("The timezone to use for the search (e.g., 'Asia/Kuala_Lumpur')."),
+            },
+            handler: async (args, ctx) => {
+                const { limit = 10, cursorId, search = "", timezone = "UTC", } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const result = await sdkClient.contacts.list({
+                        search,
+                        timezone,
+                        filter: { $and: [] },
+                    }, {
+                        limit,
+                        cursorId,
+                    });
+                    return handleSdkResponse(result);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "add_contact_tags",
+            description: "Add tags to a contact.",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number."),
+                tags: z
+                    .array(z.string())
+                    .nonempty()
+                    .describe("An array of tag names to add to the contact."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier, tags } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    await sdkClient.contacts.addTags(formattedIdentifier, tags);
+                    return handleSdkResponse({ success: true, message: "Tags added successfully" });
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "remove_contact_tags",
+            description: "Remove tags from a contact.",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number."),
+                tags: z
+                    .array(z.string())
+                    .nonempty()
+                    .describe("An array of tag names to remove from the contact."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier, tags } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    await sdkClient.contacts.deleteTags(formattedIdentifier, tags);
+                    return handleSdkResponse({ success: true, message: "Tags removed successfully" });
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "create_or_update_contact",
+            description: "Create a contact if they do not exist, or update the existing contact. Uses the contact identifier to match.",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number."),
+                firstName: z.string().describe("The first name of the contact."),
+                lastName: z.string().optional().describe("The last name of the contact."),
+                email: z.string().optional().describe("The contact's email address."),
+                phone: z
+                    .string()
+                    .optional()
+                    .describe("The contact's phone number, including the country code (e.g., +60123456789)."),
+                language: z
+                    .string()
+                    .optional()
+                    .describe("The contact's language code, based on the ISO 639-1 standard (e.g., 'en' for English)."),
+                custom_fields: z
+                    .array(z.object({
+                    name: z.string(),
+                    value: z.any(),
+                }))
+                    .optional()
+                    .describe("An array of custom field objects, each with a name and value."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier, firstName, lastName, phone, email, language, custom_fields } = args;
+                const data = { firstName, lastName, phone, email, language, custom_fields };
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    const result = await sdkClient.contacts.createOrUpdate(formattedIdentifier, data);
+                    return handleSdkResponse(result);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "merge_contacts",
+            description: "Merge two contacts. The primary contact is kept; the secondary is merged into it. Optionally update fields on the primary.",
+            schema: {
+                primaryContactId: z
+                    .number()
+                    .describe("The contact ID of the contact to keep (primary). Must be numeric ID."),
+                secondaryContactId: z
+                    .number()
+                    .describe("The contact ID of the contact to merge into the primary (secondary)."),
+                firstName: z.string().optional().describe("Update the primary contact's first name."),
+                lastName: z.string().optional().describe("Update the primary contact's last name."),
+                email: z.string().optional().describe("Update the primary contact's email."),
+                phone: z.string().optional().describe("Update the primary contact's phone."),
+            },
+            handler: async (args, ctx) => {
+                const { primaryContactId, secondaryContactId, firstName, lastName, email, phone } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const request = {
+                        contactIds: [primaryContactId, secondaryContactId],
+                        ...(firstName !== undefined && { firstName }),
+                        ...(lastName !== undefined && { lastName }),
+                        ...(email !== undefined && { email }),
+                        ...(phone !== undefined && { phone }),
+                    };
+                    const result = await sdkClient.contacts.merge(request);
+                    return handleSdkResponse(result);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "list_contact_channels",
+            description: "List all messaging channels connected to a contact (e.g. WhatsApp, Facebook).",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number."),
+                limit: z
+                    .number()
+                    .min(1)
+                    .max(100)
+                    .default(10)
+                    .describe("The number of channels to return, between 1 and 100."),
+                cursorId: z.number().optional().describe("The cursor ID for pagination."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier, limit = 10, cursorId, } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    const result = await sdkClient.contacts.listChannels(formattedIdentifier, {
+                        limit,
+                        cursorId,
+                    });
+                    return handleSdkResponse(result);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+        {
+            name: "update_contact_lifecycle",
+            description: "Update a contact's lifecycle stage, or remove the lifecycle (pass stage as null or empty to clear).",
+            schema: {
+                identifier: z
+                    .string()
+                    .describe("The contact's identifier. Can be the contact's ID, email, or phone number."),
+                stage: z
+                    .string()
+                    .nullable()
+                    .describe("The lifecycle stage name to set. Set to null or omit to remove the contact's lifecycle."),
+            },
+            handler: async (args, ctx) => {
+                const { identifier, stage } = args;
+                try {
+                    const sdkClient = createSdkClient(this.apiBaseUrl, this.mode, ctx);
+                    const formattedIdentifier = formatContactIdentifier(identifier);
+                    const request = stage == null || stage === "" ? null : { name: stage };
+                    const result = await sdkClient.contacts.updateLifecycle(formattedIdentifier, request);
+                    return handleSdkResponse(result);
+                }
+                catch (error) {
+                    return handleSdkError(error);
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=contacts.tool.js.map