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

package/dist/service.d.ts

@@ -0,0 +1,71 @@
+/**
+ * iMessage service implementation for ElizaOS.
+ */
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import { type IIMessageService, type IMessageChat, type IMessageMessage, type IMessageSendOptions, type IMessageSendResult, type IMessageSettings } from "./types.js";
+/**
+ * iMessage service for ElizaOS agents.
+ * Note: This only works on macOS.
+ */
+export declare class IMessageService extends Service implements IIMessageService {
+    static serviceType: string;
+    capabilityDescription: string;
+    private settings;
+    private connected;
+    private pollInterval;
+    private lastMessageId;
+    /**
+     * Start the iMessage service.
+     */
+    static start(runtime: IAgentRuntime): Promise<IMessageService>;
+    /**
+     * Stop the iMessage service.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the service is connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Check if running on macOS.
+     */
+    isMacOS(): boolean;
+    /**
+     * Send a message via iMessage.
+     */
+    sendMessage(to: string, text: string, options?: IMessageSendOptions): Promise<IMessageSendResult>;
+    /**
+     * Get recent messages.
+     */
+    getRecentMessages(limit?: number): Promise<IMessageMessage[]>;
+    /**
+     * Get chats.
+     */
+    getChats(): Promise<IMessageChat[]>;
+    /**
+     * Get current settings.
+     */
+    getSettings(): IMessageSettings | null;
+    private loadSettings;
+    private validateSettings;
+    private sendSingleMessage;
+    private sendViaCli;
+    private sendViaAppleScript;
+    private runAppleScript;
+    private startPolling;
+    private pollForNewMessages;
+    private isAllowed;
+    private parseMessagesResult;
+    private parseChatsResult;
+}
+/**
+ * Parse tab-delimited AppleScript messages output.
+ * Expected format per line: "id\ttext\tdate_sent\tis_from_me\tchat_identifier\tsender"
+ */
+export declare function parseMessagesFromAppleScript(result: string): IMessageMessage[];
+/**
+ * Parse tab-delimited AppleScript chats output.
+ * Expected format per line: "chat_identifier\tdisplay_name\tparticipant_count\tlast_message_date"
+ */
+export declare function parseChatsFromAppleScript(result: string): IMessageChat[];
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAqB,KAAK,aAAa,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAGL,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAKjB,KAAK,eAAe,EAEpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,OAAQ,YAAW,gBAAgB;IACtE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAyB;IAEnD,qBAAqB,SAAkE;IAEvF,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,aAAa,CAAuB;IAE5C;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IA+BpE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAmC9B;;OAEG;IACG,iBAAiB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAkCvE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA0BzC;;OAEG;IACH,WAAW,IAAI,gBAAgB,GAAG,IAAI;IAMtC,OAAO,CAAC,YAAY;YAoDN,gBAAgB;YAsBhB,iBAAiB;YAkBjB,UAAU;YAuBV,kBAAkB;YAsClB,cAAc;IAU5B,OAAO,CAAC,YAAY;YAcN,kBAAkB;IAiChC,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;CAGzB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CA0C9E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CA+BxE"}

package/dist/service.js

@@ -0,0 +1,433 @@
+/**
+ * iMessage service implementation for ElizaOS.
+ */
+import { exec } from "node:child_process";
+import { existsSync } from "node:fs";
+import { platform } from "node:os";
+import { promisify } from "node:util";
+import { logger, Service } from "@elizaos/core";
+import { DEFAULT_POLL_INTERVAL_MS, formatPhoneNumber, IMESSAGE_SERVICE_NAME, IMessageCliError, IMessageConfigurationError, IMessageEventTypes, IMessageNotSupportedError, isPhoneNumber, splitMessageForIMessage, } from "./types.js";
+const execAsync = promisify(exec);
+/**
+ * iMessage service for ElizaOS agents.
+ * Note: This only works on macOS.
+ */
+export class IMessageService extends Service {
+    static serviceType = IMESSAGE_SERVICE_NAME;
+    capabilityDescription = "iMessage service for sending and receiving messages on macOS";
+    settings = null;
+    connected = false;
+    pollInterval = null;
+    lastMessageId = null;
+    /**
+     * Start the iMessage service.
+     */
+    static async start(runtime) {
+        logger.info("Starting iMessage service...");
+        const service = new IMessageService(runtime);
+        // Check if running on macOS
+        if (!service.isMacOS()) {
+            throw new IMessageNotSupportedError();
+        }
+        // Load settings
+        service.settings = service.loadSettings();
+        await service.validateSettings();
+        // Start polling for new messages
+        if (service.settings.pollIntervalMs > 0) {
+            service.startPolling();
+        }
+        service.connected = true;
+        logger.info("iMessage service started");
+        // Emit connection ready event
+        runtime.emitEvent(IMessageEventTypes.CONNECTION_READY, {
+            runtime,
+            service,
+        });
+        return service;
+    }
+    /**
+     * Stop the iMessage service.
+     */
+    async stop() {
+        logger.info("Stopping iMessage service...");
+        this.connected = false;
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = null;
+        }
+        this.settings = null;
+        this.lastMessageId = null;
+        logger.info("iMessage service stopped");
+    }
+    /**
+     * Check if the service is connected.
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Check if running on macOS.
+     */
+    isMacOS() {
+        return platform() === "darwin";
+    }
+    /**
+     * Send a message via iMessage.
+     */
+    async sendMessage(to, text, options) {
+        if (!this.settings) {
+            return { success: false, error: "Service not initialized" };
+        }
+        // Format phone number if needed
+        const target = isPhoneNumber(to) ? formatPhoneNumber(to) : to;
+        // Split message if too long
+        const chunks = splitMessageForIMessage(text);
+        for (const chunk of chunks) {
+            const result = await this.sendSingleMessage(target, chunk, options);
+            if (!result.success) {
+                return result;
+            }
+        }
+        // Emit sent event
+        if (this.runtime) {
+            this.runtime.emitEvent(IMessageEventTypes.MESSAGE_SENT, {
+                runtime: this.runtime,
+                to: target,
+                text,
+                hasMedia: Boolean(options?.mediaUrl),
+            });
+        }
+        return {
+            success: true,
+            messageId: Date.now().toString(),
+            chatId: target,
+        };
+    }
+    /**
+     * Get recent messages.
+     */
+    async getRecentMessages(limit = 50) {
+        if (!this.settings) {
+            return [];
+        }
+        // Use CLI or AppleScript to get recent messages
+        const script = `
+      tell application "Messages"
+        set AppleScript's text item delimiters to tab
+        set outputLines to {}
+        repeat with i from 1 to ${limit}
+          try
+            set msg to item i of (get messages)
+            set msgLine to (id of msg) & tab & (text of msg) & tab & ((date of msg) as string) & tab & (is_from_me of msg as string) & tab & (chat_identifier of msg as string) & tab & (handle of sender of msg)
+            set end of outputLines to msgLine
+          end try
+        end repeat
+        set AppleScript's text item delimiters to linefeed
+        set outputText to outputLines as string
+        set AppleScript's text item delimiters to ""
+        return outputText
+      end tell
+    `;
+        try {
+            const result = await this.runAppleScript(script);
+            // Parse result and return messages
+            return this.parseMessagesResult(result);
+        }
+        catch (error) {
+            logger.warn(`Failed to get recent messages: ${error}`);
+            return [];
+        }
+    }
+    /**
+     * Get chats.
+     */
+    async getChats() {
+        if (!this.settings) {
+            return [];
+        }
+        const script = `
+      tell application "Messages"
+        set chatList to {}
+        repeat with c in chats
+          set chatId to id of c
+          set chatName to name of c
+          set end of chatList to {chatId, chatName}
+        end repeat
+        return chatList
+      end tell
+    `;
+        try {
+            const result = await this.runAppleScript(script);
+            return this.parseChatsResult(result);
+        }
+        catch (error) {
+            logger.warn(`Failed to get chats: ${error}`);
+            return [];
+        }
+    }
+    /**
+     * Get current settings.
+     */
+    getSettings() {
+        return this.settings;
+    }
+    // Private methods
+    loadSettings() {
+        if (!this.runtime) {
+            throw new IMessageConfigurationError("Runtime not initialized");
+        }
+        const getStringSetting = (key, envKey, defaultValue = "") => {
+            const value = this.runtime?.getSetting(key);
+            if (typeof value === "string")
+                return value;
+            return process.env[envKey] || defaultValue;
+        };
+        const cliPath = getStringSetting("IMESSAGE_CLI_PATH", "IMESSAGE_CLI_PATH", "imsg");
+        const dbPath = getStringSetting("IMESSAGE_DB_PATH", "IMESSAGE_DB_PATH") || undefined;
+        const pollIntervalMs = Number(getStringSetting("IMESSAGE_POLL_INTERVAL_MS", "IMESSAGE_POLL_INTERVAL_MS")) ||
+            DEFAULT_POLL_INTERVAL_MS;
+        const dmPolicy = getStringSetting("IMESSAGE_DM_POLICY", "IMESSAGE_DM_POLICY", "pairing");
+        const groupPolicy = getStringSetting("IMESSAGE_GROUP_POLICY", "IMESSAGE_GROUP_POLICY", "allowlist");
+        const allowFromRaw = getStringSetting("IMESSAGE_ALLOW_FROM", "IMESSAGE_ALLOW_FROM");
+        const allowFrom = allowFromRaw
+            ? allowFromRaw
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean)
+            : [];
+        const enabledRaw = getStringSetting("IMESSAGE_ENABLED", "IMESSAGE_ENABLED", "true");
+        const enabled = enabledRaw !== "false";
+        return {
+            cliPath,
+            dbPath,
+            pollIntervalMs,
+            dmPolicy,
+            groupPolicy,
+            allowFrom,
+            enabled,
+        };
+    }
+    async validateSettings() {
+        if (!this.settings) {
+            throw new IMessageConfigurationError("Settings not loaded");
+        }
+        // Check if CLI tool exists (if specified and not default)
+        if (this.settings.cliPath !== "imsg") {
+            if (!existsSync(this.settings.cliPath)) {
+                logger.warn(`iMessage CLI not found at ${this.settings.cliPath}, will use AppleScript`);
+            }
+        }
+        // Check if Messages app is accessible
+        try {
+            await this.runAppleScript('tell application "Messages" to return 1');
+        }
+        catch (_error) {
+            throw new IMessageConfigurationError("Cannot access Messages app. Ensure Full Disk Access is granted.");
+        }
+    }
+    async sendSingleMessage(to, text, options) {
+        // Try CLI first if available
+        if (this.settings?.cliPath && this.settings.cliPath !== "imsg") {
+            try {
+                return await this.sendViaCli(to, text, options);
+            }
+            catch (error) {
+                logger.debug(`CLI send failed, falling back to AppleScript: ${error}`);
+            }
+        }
+        // Fall back to AppleScript
+        return await this.sendViaAppleScript(to, text, options);
+    }
+    async sendViaCli(to, text, options) {
+        if (!this.settings) {
+            return { success: false, error: "Service not initialized" };
+        }
+        const args = [to, text];
+        if (options?.mediaUrl) {
+            args.push("--attachment", options.mediaUrl);
+        }
+        try {
+            await execAsync(`"${this.settings.cliPath}" ${args.map((a) => `"${a}"`).join(" ")}`);
+            return { success: true, messageId: Date.now().toString(), chatId: to };
+        }
+        catch (error) {
+            const err = error;
+            throw new IMessageCliError(err.message || "CLI command failed", err.code);
+        }
+    }
+    async sendViaAppleScript(to, text, _options) {
+        // Escape text for AppleScript
+        const escapedText = text.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+        let script;
+        if (to.startsWith("chat_id:")) {
+            // Send to existing chat
+            const chatId = to.slice(8);
+            script = `
+        tell application "Messages"
+          set targetChat to chat id "${chatId}"
+          send "${escapedText}" to targetChat
+        end tell
+      `;
+        }
+        else {
+            // Send to buddy (phone/email)
+            script = `
+        tell application "Messages"
+          set targetService to 1st account whose service type = iMessage
+          set targetBuddy to participant "${to}" of targetService
+          send "${escapedText}" to targetBuddy
+        end tell
+      `;
+        }
+        try {
+            await this.runAppleScript(script);
+            return { success: true, messageId: Date.now().toString(), chatId: to };
+        }
+        catch (error) {
+            return { success: false, error: `AppleScript error: ${error}` };
+        }
+    }
+    async runAppleScript(script) {
+        try {
+            const { stdout } = await execAsync(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`);
+            return stdout.trim();
+        }
+        catch (error) {
+            const err = error;
+            throw new Error(err.stderr || err.message || "AppleScript execution failed");
+        }
+    }
+    startPolling() {
+        if (!this.settings) {
+            return;
+        }
+        this.pollInterval = setInterval(async () => {
+            try {
+                await this.pollForNewMessages();
+            }
+            catch (error) {
+                logger.debug(`Polling error: ${error}`);
+            }
+        }, this.settings.pollIntervalMs);
+    }
+    async pollForNewMessages() {
+        if (!this.runtime) {
+            return;
+        }
+        const messages = await this.getRecentMessages(10);
+        for (const msg of messages) {
+            // Skip if we've already seen this message
+            if (this.lastMessageId && msg.id <= this.lastMessageId) {
+                continue;
+            }
+            // Skip messages from self
+            if (msg.isFromMe) {
+                continue;
+            }
+            // Check DM policy
+            if (!this.isAllowed(msg.handle)) {
+                continue;
+            }
+            // Emit message received event
+            this.runtime.emitEvent(IMessageEventTypes.MESSAGE_RECEIVED, {
+                runtime: this.runtime,
+                message: msg,
+            });
+            this.lastMessageId = msg.id;
+        }
+    }
+    isAllowed(handle) {
+        if (!this.settings) {
+            return false;
+        }
+        if (this.settings.dmPolicy === "open") {
+            return true;
+        }
+        if (this.settings.dmPolicy === "disabled") {
+            return false;
+        }
+        if (this.settings.dmPolicy === "allowlist") {
+            return this.settings.allowFrom.some((allowed) => allowed.toLowerCase() === handle.toLowerCase());
+        }
+        // pairing - allow and track
+        return true;
+    }
+    parseMessagesResult(result) {
+        return parseMessagesFromAppleScript(result);
+    }
+    parseChatsResult(result) {
+        return parseChatsFromAppleScript(result);
+    }
+}
+/**
+ * Parse tab-delimited AppleScript messages output.
+ * Expected format per line: "id\ttext\tdate_sent\tis_from_me\tchat_identifier\tsender"
+ */
+export function parseMessagesFromAppleScript(result) {
+    const messages = [];
+    if (!result || !result.trim()) {
+        return messages;
+    }
+    for (const line of result.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            continue;
+        }
+        const fields = trimmed.split("\t");
+        if (fields.length < 6) {
+            continue;
+        }
+        const [id, text, dateSent, isFromMeStr, chatIdentifier, sender] = fields;
+        const isFromMe = isFromMeStr === "1" || isFromMeStr.toLowerCase() === "true";
+        let timestamp;
+        const parsed = Number(dateSent);
+        if (!Number.isNaN(parsed) && parsed > 0) {
+            timestamp = parsed;
+        }
+        else {
+            const dateObj = new Date(dateSent);
+            timestamp = Number.isNaN(dateObj.getTime()) ? 0 : dateObj.getTime();
+        }
+        messages.push({
+            id: id || "",
+            text: text || "",
+            handle: sender || "",
+            chatId: chatIdentifier || "",
+            timestamp,
+            isFromMe,
+            hasAttachments: false,
+        });
+    }
+    return messages;
+}
+/**
+ * Parse tab-delimited AppleScript chats output.
+ * Expected format per line: "chat_identifier\tdisplay_name\tparticipant_count\tlast_message_date"
+ */
+export function parseChatsFromAppleScript(result) {
+    const chats = [];
+    if (!result || !result.trim()) {
+        return chats;
+    }
+    for (const line of result.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            continue;
+        }
+        const fields = trimmed.split("\t");
+        if (fields.length < 4) {
+            continue;
+        }
+        const [chatIdentifier, displayName, participantCountStr] = fields;
+        const participantCount = Number(participantCountStr) || 0;
+        const chatType = participantCount > 1 ? "group" : "direct";
+        chats.push({
+            chatId: chatIdentifier || "",
+            chatType,
+            displayName: displayName || undefined,
+            participants: [],
+        });
+    }
+    return chats;
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAyC,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EAEjB,qBAAqB,EAGrB,gBAAgB,EAChB,0BAA0B,EAC1B,kBAAkB,EAElB,yBAAyB,EAIzB,aAAa,EACb,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,OAAO;IAC1C,MAAM,CAAC,WAAW,GAAW,qBAAqB,CAAC;IAEnD,qBAAqB,GAAG,8DAA8D,CAAC;IAE/E,QAAQ,GAA4B,IAAI,CAAC;IACzC,SAAS,GAAY,KAAK,CAAC;IAC3B,YAAY,GAA0B,IAAI,CAAC;IAC3C,aAAa,GAAkB,IAAI,CAAC;IAE5C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAsB;QACvC,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;QAE7C,4BAA4B;QAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,yBAAyB,EAAE,CAAC;QACxC,CAAC;QAED,gBAAgB;QAChB,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QAC1C,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAEjC,iCAAiC;QACjC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,CAAC;QAED,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAExC,8BAA8B;QAC9B,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,gBAAgB,EAAE;YACrD,OAAO;YACP,OAAO;SACQ,CAAC,CAAC;QAEnB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAEvB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,QAAQ,EAAE,KAAK,QAAQ,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,EAAU,EACV,IAAY,EACZ,OAA6B;QAE7B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;QAC9D,CAAC;QAED,gCAAgC;QAChC,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE9D,4BAA4B;QAC5B,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,YAAY,EAAE;gBACtD,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,EAAE,EAAE,MAAM;gBACV,IAAI;gBACJ,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;aACrB,CAAC,CAAC;QACrB,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;YAChC,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,gDAAgD;QAChD,MAAM,MAAM,GAAG;;;;kCAIe,KAAK;;;;;;;;;;;;KAYlC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACjD,mCAAmC;YACnC,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG;;;;;;;;;;KAUd,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,kBAAkB;IAEV,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,0BAA0B,CAAC,yBAAyB,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,MAAc,EAAE,YAAY,GAAG,EAAE,EAAU,EAAE;YAClF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC;QAC7C,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,gBAAgB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC;QAErF,MAAM,cAAc,GAClB,MAAM,CAAC,gBAAgB,CAAC,2BAA2B,EAAE,2BAA2B,CAAC,CAAC;YAClF,wBAAwB,CAAC;QAE3B,MAAM,QAAQ,GAAG,gBAAgB,CAC/B,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,CACsB,CAAC;QAElC,MAAM,WAAW,GAAG,gBAAgB,CAClC,uBAAuB,EACvB,uBAAuB,EACvB,WAAW,CACuB,CAAC;QAErC,MAAM,YAAY,GAAG,gBAAgB,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAC;QACpF,MAAM,SAAS,GAAG,YAAY;YAC5B,CAAC,CAAC,YAAY;iBACT,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBAC5B,MAAM,CAAC,OAAO,CAAC;YACpB,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,UAAU,GAAG,gBAAgB,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,UAAU,KAAK,OAAO,CAAC;QAEvC,OAAO;YACL,OAAO;YACP,MAAM;YACN,cAAc;YACd,QAAQ;YACR,WAAW;YACX,SAAS;YACT,OAAO;SACR,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,gBAAgB;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,0BAA0B,CAAC,qBAAqB,CAAC,CAAC;QAC9D,CAAC;QAED,0DAA0D;QAC1D,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,QAAQ,CAAC,OAAO,wBAAwB,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,yCAAyC,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,0BAA0B,CAClC,iEAAiE,CAClE,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,EAAU,EACV,IAAY,EACZ,OAA6B;QAE7B,6BAA6B;QAC7B,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC/D,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,iDAAiD,KAAK,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,EAAU,EACV,IAAY,EACZ,OAA6B;QAE7B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;QAC9D,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACxB,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAA4C,CAAC;YACzD,MAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,IAAI,oBAAoB,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,EAAU,EACV,IAAY,EACZ,QAA8B;QAE9B,8BAA8B;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAErE,IAAI,MAAc,CAAC;QAEnB,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,wBAAwB;YACxB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,GAAG;;uCAEwB,MAAM;kBAC3B,WAAW;;OAEtB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,8BAA8B;YAC9B,MAAM,GAAG;;;4CAG6B,EAAE;kBAC5B,WAAW;;OAEtB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,KAAK,EAAE,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,MAAc;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,iBAAiB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;YACxF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAA8C,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,8BAA8B,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YACzC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC9B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAElD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,0CAA0C;YAC1C,IAAI,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvD,SAAS;YACX,CAAC;YAED,0BAA0B;YAC1B,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,kBAAkB;YAClB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,SAAS;YACX,CAAC;YAED,8BAA8B;YAC9B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,gBAAgB,EAAE;gBAC1D,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,GAAG;aACG,CAAC,CAAC;YAEnB,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,MAAc;QAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CACjC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAC5D,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,mBAAmB,CAAC,MAAc;QACxC,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAEO,gBAAgB,CAAC,MAAc;QACrC,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;;AAGH;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QAED,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;QAEzE,MAAM,QAAQ,GAAG,WAAW,KAAK,GAAG,IAAI,WAAW,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QAE7E,IAAI,SAAiB,CAAC;QACtB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,SAAS,GAAG,MAAM,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,EAAE,IAAI,EAAE;YACZ,IAAI,EAAE,IAAI,IAAI,EAAE;YAChB,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,MAAM,EAAE,cAAc,IAAI,EAAE;YAC5B,SAAS;YACT,QAAQ;YACR,cAAc,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QAED,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,mBAAmB,CAAC,GAAG,MAAM,CAAC;QAElE,MAAM,gBAAgB,GAAG,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAqB,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE7E,KAAK,CAAC,IAAI,CAAC;YACT,MAAM,EAAE,cAAc,IAAI,EAAE;YAC5B,QAAQ;YACR,WAAW,EAAE,WAAW,IAAI,SAAS;YACrC,YAAY,EAAE,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Type definitions for the iMessage plugin.
+ */
+import type { Service } from "@elizaos/core";
+/** Maximum message length for iMessage */
+export declare const MAX_IMESSAGE_MESSAGE_LENGTH = 4000;
+/** Default poll interval in ms */
+export declare const DEFAULT_POLL_INTERVAL_MS = 5000;
+/** iMessage service name constant */
+export declare const IMESSAGE_SERVICE_NAME = "imessage";
+/**
+ * Event types emitted by the iMessage plugin
+ */
+export declare const IMessageEventTypes: {
+    readonly MESSAGE_RECEIVED: "IMESSAGE_MESSAGE_RECEIVED";
+    readonly MESSAGE_SENT: "IMESSAGE_MESSAGE_SENT";
+    readonly CONNECTION_READY: "IMESSAGE_CONNECTION_READY";
+    readonly ERROR: "IMESSAGE_ERROR";
+};
+export type IMessageEventType = (typeof IMessageEventTypes)[keyof typeof IMessageEventTypes];
+/**
+ * iMessage chat types
+ */
+export type IMessageChatType = "direct" | "group";
+/**
+ * Configuration settings for the iMessage plugin
+ */
+export interface IMessageSettings {
+    /** Path to iMessage CLI tool */
+    cliPath: string;
+    /** Path to iMessage database */
+    dbPath?: string;
+    /** Polling interval in ms */
+    pollIntervalMs: number;
+    /** DM policy */
+    dmPolicy: "open" | "pairing" | "allowlist" | "disabled";
+    /** Group policy */
+    groupPolicy: "open" | "allowlist" | "disabled";
+    /** Handles/phone numbers for allowlist */
+    allowFrom: string[];
+    /** Enable/disable the plugin */
+    enabled: boolean;
+}
+/**
+ * iMessage contact
+ */
+export interface IMessageContact {
+    /** Handle (phone number or email) */
+    handle: string;
+    /** Display name */
+    displayName?: string;
+    /** Is this a phone number? */
+    isPhoneNumber: boolean;
+}
+/**
+ * iMessage chat
+ */
+export interface IMessageChat {
+    /** Chat ID */
+    chatId: string;
+    /** Chat type */
+    chatType: IMessageChatType;
+    /** Display name */
+    displayName?: string;
+    /** Participants */
+    participants: IMessageContact[];
+}
+/**
+ * iMessage message
+ */
+export interface IMessageMessage {
+    /** Message ID (ROWID) */
+    id: string;
+    /** Message text */
+    text: string;
+    /** Sender handle */
+    handle: string;
+    /** Chat ID */
+    chatId: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Is from me */
+    isFromMe: boolean;
+    /** Has attachments */
+    hasAttachments: boolean;
+    /** Attachment paths */
+    attachmentPaths?: string[];
+}
+/**
+ * Options for sending a message
+ */
+export interface IMessageSendOptions {
+    /** Media URL or path to attach */
+    mediaUrl?: string;
+    /** Max bytes for media */
+    maxBytes?: number;
+}
+/**
+ * Result from sending a message
+ */
+export interface IMessageSendResult {
+    success: boolean;
+    messageId?: string;
+    chatId?: string;
+    error?: string;
+}
+/**
+ * Service interface for iMessage
+ */
+export interface IIMessageService extends Service {
+    /** Check if the service is connected */
+    isConnected(): boolean;
+    /** Check if running on macOS */
+    isMacOS(): boolean;
+    /** Send a message */
+    sendMessage(to: string, text: string, options?: IMessageSendOptions): Promise<IMessageSendResult>;
+    /** Get recent messages */
+    getRecentMessages(limit?: number): Promise<IMessageMessage[]>;
+    /** Get chats */
+    getChats(): Promise<IMessageChat[]>;
+}
+/**
+ * iMessage plugin errors
+ */
+export declare class IMessagePluginError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+export declare class IMessageConfigurationError extends IMessagePluginError {
+    constructor(message: string, setting?: string);
+}
+export declare class IMessageNotSupportedError extends IMessagePluginError {
+    constructor(message?: string);
+}
+export declare class IMessageCliError extends IMessagePluginError {
+    constructor(message: string, exitCode?: number);
+}
+/**
+ * Check if a string looks like a phone number
+ */
+export declare function isPhoneNumber(input: string): boolean;
+/**
+ * Check if a string looks like an email
+ */
+export declare function isEmail(input: string): boolean;
+/**
+ * Check if a string is a valid iMessage target (phone or email)
+ */
+export declare function isValidIMessageTarget(target: string): boolean;
+/**
+ * Normalize an iMessage target
+ */
+export declare function normalizeIMessageTarget(target: string): string | null;
+/**
+ * Format a phone number for iMessage
+ */
+export declare function formatPhoneNumber(phone: string): string;
+/**
+ * Split text for iMessage
+ */
+export declare function splitMessageForIMessage(text: string, maxLength?: number): string[];
+//# sourceMappingURL=types.d.ts.map