@elizaos/plugin-bluebubbles 2.0.0-alpha.3 → 2.0.0-alpha.4

package/dist/actions/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * BlueBubbles actions export
+ */
+export { sendMessageAction } from "./sendMessage";
+export { sendReactionAction } from "./sendReaction";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/{src/actions/index.ts → dist/actions/index.js}

@@ -3,3 +3,4 @@
  */
 export { sendMessageAction } from "./sendMessage";
 export { sendReactionAction } from "./sendReaction";
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/actions/sendMessage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Send message action for BlueBubbles
+ */
+import { type Action } from "@elizaos/core";
+export declare const sendMessageAction: Action;
+//# sourceMappingURL=sendMessage.d.ts.map

package/dist/actions/sendMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendMessage.d.ts","sourceRoot":"","sources":["../../src/actions/sendMessage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,KAAK,MAAM,EAWZ,MAAM,eAAe,CAAC;AA6CvB,eAAO,MAAM,iBAAiB,EAAE,MAkG/B,CAAC"}

package/dist/actions/sendMessage.js

@@ -0,0 +1,119 @@
+/**
+ * Send message action for BlueBubbles
+ */
+import { composePromptFromState, logger, ModelType, } from "@elizaos/core";
+import { BLUEBUBBLES_SERVICE_NAME } from "../constants";
+const sendMessageTemplate = `
+# Task: Generate a response to send via iMessage (BlueBubbles)
+{{recentMessages}}
+
+# Instructions: Write a response to send to the user via iMessage. Be conversational and friendly.
+Your response should be appropriate for iMessage - keep it relatively concise but engaging.
+`;
+const examples = [
+    [
+        {
+            name: "{{user1}}",
+            content: {
+                text: "Can you send a message to John saying I'll be late?",
+            },
+        },
+        {
+            name: "{{agentName}}",
+            content: {
+                text: "I'll send that message to John for you.",
+                action: "SEND_BLUEBUBBLES_MESSAGE",
+            },
+        },
+    ],
+    [
+        {
+            name: "{{user1}}",
+            content: {
+                text: "Reply to this iMessage for me",
+            },
+        },
+        {
+            name: "{{agentName}}",
+            content: {
+                text: "I'll compose and send a reply for you.",
+                action: "SEND_BLUEBUBBLES_MESSAGE",
+            },
+        },
+    ],
+];
+export const sendMessageAction = {
+    name: "SEND_BLUEBUBBLES_MESSAGE",
+    description: "Send a message via iMessage through BlueBubbles",
+    similes: ["SEND_IMESSAGE", "TEXT_MESSAGE", "IMESSAGE_REPLY", "BLUEBUBBLES_SEND", "APPLE_MESSAGE"],
+    examples,
+    validate: async (runtime, _message) => {
+        const service = runtime.getService(BLUEBUBBLES_SERVICE_NAME);
+        return service?.getIsRunning() ?? false;
+    },
+    handler: async (runtime, message, state, _options, callback) => {
+        const service = runtime.getService(BLUEBUBBLES_SERVICE_NAME);
+        const currentState = state ?? (await runtime.composeState(message));
+        if (!service || !service.getIsRunning()) {
+            logger.error("BlueBubbles service is not available");
+            if (callback) {
+                await callback({
+                    text: "Sorry, the iMessage service is currently unavailable.",
+                });
+            }
+            return { success: false, error: "BlueBubbles service not available" };
+        }
+        try {
+            // Get the room to find the target
+            const room = await runtime.getRoom(message.roomId);
+            if (!room?.channelId) {
+                logger.error("No channel ID found for room");
+                if (callback) {
+                    await callback({
+                        text: "Unable to determine the message recipient.",
+                    });
+                }
+                return { success: false, error: "No channel ID" };
+            }
+            // Generate response if state is available
+            const prompt = composePromptFromState({
+                state: currentState,
+                template: sendMessageTemplate,
+            });
+            const response = await runtime.useModel(ModelType.TEXT_LARGE, {
+                prompt,
+            });
+            const responseText = typeof response === "string" ? response : (response.text ?? "");
+            if (!responseText.trim()) {
+                logger.warn("Generated empty response, skipping send");
+                return { success: false, error: "Empty response generated" };
+            }
+            // Send the message
+            const result = await service.sendMessage(room.channelId, responseText, message.content.inReplyTo);
+            logger.info(`Sent BlueBubbles message: ${result.guid}`);
+            const content = {
+                text: responseText,
+                source: "bluebubbles",
+                metadata: {
+                    messageGuid: result.guid,
+                    chatGuid: room.channelId,
+                },
+            };
+            if (callback) {
+                await callback(content);
+            }
+            return { success: true, text: responseText };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error(`Failed to send BlueBubbles message: ${errorMessage}`);
+            if (callback) {
+                await callback({
+                    text: "Failed to send the iMessage. Please try again.",
+                });
+            }
+            return { success: false, error: errorMessage };
+        }
+    },
+};
+//# sourceMappingURL=sendMessage.js.map

package/dist/actions/sendMessage.js.map

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

package/dist/actions/sendReaction.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Send reaction action for the BlueBubbles plugin.
+ */
+import type { Action } from "@elizaos/core";
+export declare const sendReactionAction: Action;
+//# sourceMappingURL=sendReaction.d.ts.map

package/dist/actions/sendReaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendReaction.d.ts","sourceRoot":"","sources":["../../src/actions/sendReaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,eAAe,CAAC;AAiCvB,eAAO,MAAM,kBAAkB,EAAE,MAwIhC,CAAC"}

package/dist/actions/sendReaction.js

@@ -0,0 +1,139 @@
+/**
+ * Send reaction action for the BlueBubbles plugin.
+ */
+import { composePromptFromState, logger, ModelType, parseJSONObjectFromText } from "@elizaos/core";
+import { BLUEBUBBLES_SERVICE_NAME } from "../constants.js";
+const SEND_REACTION_TEMPLATE = `# Task: Extract BlueBubbles reaction parameters
+
+Based on the conversation, determine what reaction to add or remove.
+
+Recent conversation:
+{{recentMessages}}
+
+Extract the following:
+1. emoji: The emoji reaction to add (heart, thumbsup, thumbsdown, haha, exclamation, question, or any emoji)
+2. messageId: The message ID to react to (or "last" for the last message)
+3. remove: true to remove the reaction, false to add it
+
+Respond with a JSON object:
+\`\`\`json
+{
+  "emoji": "❤️",
+  "messageId": "last",
+  "remove": false
+}
+\`\`\`
+`;
+export const sendReactionAction = {
+    name: "BLUEBUBBLES_SEND_REACTION",
+    similes: ["BLUEBUBBLES_REACT", "BB_REACTION", "IMESSAGE_REACT"],
+    description: "Add or remove a reaction on a message via BlueBubbles",
+    validate: async (_runtime, message, _state) => {
+        return message.content.source === "bluebubbles";
+    },
+    handler: async (runtime, message, state, _options, callback) => {
+        const bbService = runtime.getService(BLUEBUBBLES_SERVICE_NAME);
+        const currentState = state ?? (await runtime.composeState(message));
+        if (!bbService || !bbService.isConnected()) {
+            if (callback) {
+                await callback({
+                    text: "BlueBubbles service is not available.",
+                    source: "bluebubbles",
+                });
+            }
+            return { success: false, error: "BlueBubbles service not available" };
+        }
+        // Extract parameters using LLM
+        const prompt = await composePromptFromState({
+            template: SEND_REACTION_TEMPLATE,
+            state: currentState,
+        });
+        let reactionInfo = null;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            const response = await runtime.useModel(ModelType.TEXT_SMALL, {
+                prompt,
+            });
+            const parsed = parseJSONObjectFromText(response);
+            if (parsed?.emoji) {
+                reactionInfo = {
+                    emoji: String(parsed.emoji),
+                    messageId: String(parsed.messageId || "last"),
+                    remove: Boolean(parsed.remove),
+                };
+                break;
+            }
+        }
+        if (!reactionInfo || !reactionInfo.emoji) {
+            if (callback) {
+                await callback({
+                    text: "I couldn't understand the reaction. Please specify an emoji.",
+                    source: "bluebubbles",
+                });
+            }
+            return { success: false, error: "Could not extract reaction parameters" };
+        }
+        // Get chat context
+        const stateData = (currentState.data || {});
+        const chatGuid = stateData.chatGuid;
+        let messageGuid = reactionInfo.messageId;
+        if (!chatGuid) {
+            if (callback) {
+                await callback({
+                    text: "I couldn't determine the chat to react in.",
+                    source: "bluebubbles",
+                });
+            }
+            return { success: false, error: "Could not determine chat" };
+        }
+        // If "last", get the last message GUID from context
+        if (messageGuid === "last" || !messageGuid) {
+            messageGuid = stateData.lastMessageGuid;
+            if (!messageGuid) {
+                if (callback) {
+                    await callback({
+                        text: "I couldn't find the message to react to.",
+                        source: "bluebubbles",
+                    });
+                }
+                return { success: false, error: "Could not find message to react to" };
+            }
+        }
+        // Send reaction - we only support adding reactions, not removing
+        // The BlueBubbles API handles remove through a negative reaction type internally
+        const reactionValue = reactionInfo.remove ? `-${reactionInfo.emoji}` : reactionInfo.emoji;
+        const result = await bbService.sendReaction(chatGuid, messageGuid, reactionValue);
+        if (!result.success) {
+            if (callback) {
+                await callback({
+                    text: `Failed to ${reactionInfo.remove ? "remove" : "add"} reaction.`,
+                    source: "bluebubbles",
+                });
+            }
+            return { success: false, error: "Failed to send reaction" };
+        }
+        logger.debug(`${reactionInfo.remove ? "Removed" : "Added"} reaction ${reactionInfo.emoji} on ${messageGuid}`);
+        if (callback) {
+            await callback({
+                text: reactionInfo.remove ? "Reaction removed." : `Reacted with ${reactionInfo.emoji}.`,
+                source: message.content.source,
+            });
+        }
+        return { success: true };
+    },
+    examples: [
+        [
+            {
+                name: "{{user1}}",
+                content: { text: "React to that message with a heart" },
+            },
+            {
+                name: "{{agent}}",
+                content: {
+                    text: "I'll add a heart reaction.",
+                    actions: ["BLUEBUBBLES_SEND_REACTION"],
+                },
+            },
+        ],
+    ],
+};
+//# sourceMappingURL=sendReaction.js.map

package/dist/actions/sendReaction.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,72 @@
+import type { BlueBubblesChat, BlueBubblesConfig, BlueBubblesMessage, BlueBubblesProbeResult, SendAttachmentOptions, SendMessageOptions, SendMessageResult } from "./types";
+export declare class BlueBubblesClient {
+    private baseUrl;
+    private password;
+    constructor(config: BlueBubblesConfig);
+    private request;
+    /**
+     * Probes the BlueBubbles server to check connectivity and capabilities
+     */
+    probe(timeoutMs?: number): Promise<BlueBubblesProbeResult>;
+    /**
+     * Sends a text message
+     */
+    sendMessage(chatGuid: string, text: string, options?: SendMessageOptions): Promise<SendMessageResult>;
+    /**
+     * Sends an attachment
+     */
+    sendAttachment(chatGuid: string, attachmentPath: string, options?: SendAttachmentOptions): Promise<SendMessageResult>;
+    /**
+     * Sends an attachment from a buffer
+     */
+    sendAttachmentBuffer(chatGuid: string, buffer: Uint8Array, filename: string, mimeType: string, caption?: string): Promise<SendMessageResult>;
+    /**
+     * Gets information about a chat
+     */
+    getChat(chatGuid: string): Promise<BlueBubblesChat>;
+    /**
+     * Lists all chats
+     */
+    listChats(limit?: number, offset?: number): Promise<BlueBubblesChat[]>;
+    /**
+     * Gets messages for a chat
+     */
+    getMessages(chatGuid: string, limit?: number, offset?: number): Promise<BlueBubblesMessage[]>;
+    /**
+     * Marks a chat as read
+     */
+    markChatRead(chatGuid: string): Promise<void>;
+    /**
+     * Sends a reaction to a message
+     */
+    reactToMessage(chatGuid: string, messageGuid: string, reaction: string): Promise<void>;
+    /**
+     * Edits a message (requires private API)
+     */
+    editMessage(messageGuid: string, newText: string, backwardsCompatMessage?: string): Promise<void>;
+    /**
+     * Unsends a message (requires private API)
+     */
+    unsendMessage(messageGuid: string): Promise<void>;
+    /**
+     * Resolves a target (handle or chat GUID) to a chat GUID
+     */
+    resolveTarget(target: string): Promise<string>;
+    /**
+     * Creates a new group chat
+     */
+    createGroupChat(participants: string[], name?: string, message?: string): Promise<BlueBubblesChat>;
+    /**
+     * Adds a participant to a group chat
+     */
+    addParticipant(chatGuid: string, handle: string): Promise<void>;
+    /**
+     * Removes a participant from a group chat
+     */
+    removeParticipant(chatGuid: string, handle: string): Promise<void>;
+    /**
+     * Renames a group chat
+     */
+    renameGroupChat(chatGuid: string, newName: string): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EAEtB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,iBAAiB;YAKvB,OAAO;IAqBrB;;OAEG;IACG,KAAK,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA4B9D;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAwB7B;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,iBAAiB,CAAC;IAqC7B;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC;IA8B7B;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAOzD;;OAEG;IACG,SAAS,CAAC,KAAK,SAAM,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOpE;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAO1F;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5F;;OAEG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,sBAAsB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBpD;;OAEG;IACG,eAAe,CACnB,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC;IAY3B;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxE;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMxE"}

package/dist/client.js

@@ -0,0 +1,272 @@
+/**
+ * BlueBubbles API client for interacting with the BlueBubbles server
+ */
+import { logger } from "@elizaos/core";
+import { API_ENDPOINTS } from "./constants";
+export class BlueBubblesClient {
+    baseUrl;
+    password;
+    constructor(config) {
+        this.baseUrl = config.serverUrl.replace(/\/$/, "");
+        this.password = config.password;
+    }
+    async request(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const separator = endpoint.includes("?") ? "&" : "?";
+        const urlWithPassword = `${url}${separator}password=${encodeURIComponent(this.password)}`;
+        const response = await fetch(urlWithPassword, {
+            ...options,
+            headers: {
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`BlueBubbles API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Probes the BlueBubbles server to check connectivity and capabilities
+     */
+    async probe(timeoutMs = 5000) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            const info = await this.request(API_ENDPOINTS.SERVER_INFO, {
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return {
+                ok: true,
+                serverVersion: info.data.server_version,
+                osVersion: info.data.os_version,
+                privateApiEnabled: info.data.private_api,
+                helperConnected: info.data.helper_connected,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error(`BlueBubbles probe failed: ${errorMessage}`);
+            return {
+                ok: false,
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Sends a text message
+     */
+    async sendMessage(chatGuid, text, options = {}) {
+        const response = await this.request(API_ENDPOINTS.SEND_MESSAGE, {
+            method: "POST",
+            body: JSON.stringify({
+                chatGuid,
+                message: text,
+                tempGuid: options.tempGuid,
+                method: options.method ?? "apple-script",
+                subject: options.subject,
+                effectId: options.effectId,
+                partIndex: options.partIndex,
+                ddScan: options.ddScan,
+            }),
+        });
+        return {
+            guid: response.data.guid,
+            tempGuid: options.tempGuid,
+            status: "sent",
+            dateCreated: response.data.dateCreated,
+            text: response.data.text ?? text,
+        };
+    }
+    /**
+     * Sends an attachment
+     */
+    async sendAttachment(chatGuid, attachmentPath, options = {}) {
+        const formData = new FormData();
+        formData.append("chatGuid", chatGuid);
+        formData.append("attachment", attachmentPath);
+        if (options.tempGuid) {
+            formData.append("tempGuid", options.tempGuid);
+        }
+        if (options.name) {
+            formData.append("name", options.name);
+        }
+        if (options.isAudioMessage !== undefined) {
+            formData.append("isAudioMessage", String(options.isAudioMessage));
+        }
+        const url = `${this.baseUrl}${API_ENDPOINTS.SEND_ATTACHMENT}?password=${encodeURIComponent(this.password)}`;
+        const response = await fetch(url, {
+            method: "POST",
+            body: formData,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Failed to send attachment: ${errorText}`);
+        }
+        const result = (await response.json());
+        return {
+            guid: result.data.guid,
+            tempGuid: options.tempGuid,
+            status: "sent",
+            dateCreated: result.data.dateCreated,
+            text: result.data.text ?? "",
+        };
+    }
+    /**
+     * Sends an attachment from a buffer
+     */
+    async sendAttachmentBuffer(chatGuid, buffer, filename, mimeType, caption) {
+        const blob = new Blob([buffer], { type: mimeType });
+        const formData = new FormData();
+        formData.append("chatGuid", chatGuid);
+        formData.append("attachment", blob, filename);
+        if (caption) {
+            formData.append("message", caption);
+        }
+        const url = `${this.baseUrl}${API_ENDPOINTS.SEND_ATTACHMENT}?password=${encodeURIComponent(this.password)}`;
+        const response = await fetch(url, {
+            method: "POST",
+            body: formData,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Failed to send attachment: ${errorText}`);
+        }
+        const result = (await response.json());
+        return {
+            guid: result.data.guid,
+            status: "sent",
+            dateCreated: result.data.dateCreated,
+            text: caption ?? "",
+        };
+    }
+    /**
+     * Gets information about a chat
+     */
+    async getChat(chatGuid) {
+        const response = await this.request(`${API_ENDPOINTS.CHAT_INFO}/${encodeURIComponent(chatGuid)}`);
+        return response.data;
+    }
+    /**
+     * Lists all chats
+     */
+    async listChats(limit = 100, offset = 0) {
+        const response = await this.request(`${API_ENDPOINTS.CHATS}?limit=${limit}&offset=${offset}&with=lastMessage,participants`);
+        return response.data;
+    }
+    /**
+     * Gets messages for a chat
+     */
+    async getMessages(chatGuid, limit = 50, offset = 0) {
+        const response = await this.request(`${API_ENDPOINTS.CHAT_INFO}/${encodeURIComponent(chatGuid)}/message?limit=${limit}&offset=${offset}`);
+        return response.data;
+    }
+    /**
+     * Marks a chat as read
+     */
+    async markChatRead(chatGuid) {
+        const endpoint = API_ENDPOINTS.MARK_READ.replace(":guid", encodeURIComponent(chatGuid));
+        await this.request(endpoint, {
+            method: "POST",
+        });
+    }
+    /**
+     * Sends a reaction to a message
+     */
+    async reactToMessage(chatGuid, messageGuid, reaction) {
+        await this.request(API_ENDPOINTS.REACT, {
+            method: "POST",
+            body: JSON.stringify({
+                chatGuid,
+                messageGuid,
+                reaction,
+            }),
+        });
+    }
+    /**
+     * Edits a message (requires private API)
+     */
+    async editMessage(messageGuid, newText, backwardsCompatMessage) {
+        const endpoint = API_ENDPOINTS.EDIT.replace(":guid", encodeURIComponent(messageGuid));
+        await this.request(endpoint, {
+            method: "POST",
+            body: JSON.stringify({
+                editedMessage: newText,
+                backwardsCompatibilityMessage: backwardsCompatMessage ?? newText,
+            }),
+        });
+    }
+    /**
+     * Unsends a message (requires private API)
+     */
+    async unsendMessage(messageGuid) {
+        const endpoint = API_ENDPOINTS.UNSEND.replace(":guid", encodeURIComponent(messageGuid));
+        await this.request(endpoint, {
+            method: "POST",
+        });
+    }
+    /**
+     * Resolves a target (handle or chat GUID) to a chat GUID
+     */
+    async resolveTarget(target) {
+        // If it already looks like a chat GUID, return it
+        if (target.startsWith("iMessage;") || target.startsWith("SMS;")) {
+            return target;
+        }
+        // If it looks like a chat ID or identifier, query for it
+        if (target.startsWith("chat_")) {
+            const chats = await this.listChats();
+            const chat = chats.find((c) => c.chatIdentifier === target || c.guid === target || c.chatIdentifier.includes(target));
+            if (chat) {
+                return chat.guid;
+            }
+        }
+        // Otherwise, construct a DM chat GUID
+        // First try as iMessage, which is most common
+        return `iMessage;-;${target}`;
+    }
+    /**
+     * Creates a new group chat
+     */
+    async createGroupChat(participants, name, message) {
+        const response = await this.request(API_ENDPOINTS.CHATS, {
+            method: "POST",
+            body: JSON.stringify({
+                participants,
+                name,
+                message,
+            }),
+        });
+        return response.data;
+    }
+    /**
+     * Adds a participant to a group chat
+     */
+    async addParticipant(chatGuid, handle) {
+        await this.request(`${API_ENDPOINTS.CHAT_INFO}/${encodeURIComponent(chatGuid)}/participant`, {
+            method: "POST",
+            body: JSON.stringify({ address: handle }),
+        });
+    }
+    /**
+     * Removes a participant from a group chat
+     */
+    async removeParticipant(chatGuid, handle) {
+        await this.request(`${API_ENDPOINTS.CHAT_INFO}/${encodeURIComponent(chatGuid)}/participant`, {
+            method: "DELETE",
+            body: JSON.stringify({ address: handle }),
+        });
+    }
+    /**
+     * Renames a group chat
+     */
+    async renameGroupChat(chatGuid, newName) {
+        await this.request(`${API_ENDPOINTS.CHAT_INFO}/${encodeURIComponent(chatGuid)}`, {
+            method: "PATCH",
+            body: JSON.stringify({ displayName: newName }),
+        });
+    }
+}
+//# sourceMappingURL=client.js.map