@elizaos/plugin-imessage 2.0.0-alpha.9 → 2.0.0-beta.1

package/dist/contacts-reader.js

@@ -0,0 +1,481 @@
+/**
+ * macOS Contacts reader for @elizaos/plugin-imessage.
+ *
+ * Incoming iMessages arrive tagged with a raw handle — a phone number in
+ * E.164 form (`+15551234567`) or an email address. Raw handles are ugly
+ * to read and make the agent's replies feel impersonal. This module
+ * resolves each handle to the real display name from the user's Apple
+ * Contacts so the agent sees "Mom" or "Alex Chen" instead of a string
+ * of digits.
+ *
+ * ---
+ *
+ * Backend: **AppleScript against Contacts.app**. Unlike Messages.app
+ * (whose scripting dictionary does not expose the message table), the
+ * Contacts app ships with a complete and officially-supported AppleScript
+ * vocabulary covering `person`, `phone`, and `email` classes. Reading
+ * contacts this way is the Apple-blessed path and does not require Full
+ * Disk Access — only the macOS "Contacts" TCC permission, which the OS
+ * prompts for on first use.
+ *
+ * The reader runs once on service start and caches the result. Contacts
+ * rarely change mid-session, so a periodic refresh is overkill for v1.
+ * Callers can force a reload by constructing a fresh reader instance.
+ *
+ * Graceful degradation: if Contacts is not authorized, or returns no
+ * rows, or AppleScript fails for any other reason, the reader returns
+ * an empty map. The service treats that as "handles remain anonymous"
+ * and proceeds normally — no crash, no hard failure.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { logger } from "@elizaos/core";
+const execFileAsync = promisify(execFile);
+const DEFAULT_CONTACTS_SCRIPT_TIMEOUT_MS = 5_000;
+/**
+ * Normalize a handle to the canonical form used as a key in the
+ * ContactsMap. Strips whitespace, parentheses, hyphens, and dots from
+ * phone numbers and lowercases emails. Leaves a leading `+` in place.
+ */
+export function normalizeContactHandle(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return "";
+    // Email: lowercase
+    if (trimmed.includes("@")) {
+        return trimmed.toLowerCase();
+    }
+    // Phone: strip formatting characters, preserve leading +
+    const hasPlus = trimmed.startsWith("+");
+    const digitsOnly = trimmed.replace(/[^\d]/g, "");
+    return hasPlus ? `+${digitsOnly}` : digitsOnly;
+}
+/**
+ * AppleScript that asks Contacts.app to dump every person's name and
+ * every phone/email handle they own, one row per handle, tab-delimited.
+ *
+ * Format per line: `<kind>\t<handle>\t<name>` where `<kind>` is
+ * `phone` or `email`. Lines with empty values are skipped by the parser.
+ */
+const CONTACTS_DUMP_SCRIPT = `
+tell application "Contacts"
+  launch
+  set AppleScript's text item delimiters to tab
+  set outputLines to {}
+  repeat with p in people
+    set personName to name of p
+    if personName is missing value then set personName to ""
+    repeat with ph in phones of p
+      set phoneValue to value of ph
+      if phoneValue is not missing value then
+        set end of outputLines to "phone" & tab & phoneValue & tab & personName
+      end if
+    end repeat
+    repeat with em in emails of p
+      set emailValue to value of em
+      if emailValue is not missing value then
+        set end of outputLines to "email" & tab & emailValue & tab & personName
+      end if
+    end repeat
+  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
+`.trim();
+/**
+ * Parse the tab-delimited output of `CONTACTS_DUMP_SCRIPT` into a
+ * ContactsMap. Exported so tests can exercise it with fixture strings
+ * without needing a live Contacts.app.
+ *
+ * Input format per line: `kind\thandle\tname`.
+ * Empty lines are skipped. Lines with fewer than 3 fields are skipped.
+ * Empty handles are skipped. Duplicate handles keep the first entry
+ * (AppleScript's iteration order is generally stable).
+ */
+export function parseContactsOutput(raw) {
+    const map = new Map();
+    if (!raw?.trim())
+        return map;
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const fields = trimmed.split("\t");
+        if (fields.length < 3)
+            continue;
+        const [_kind, handle, name] = fields;
+        if (!handle || !name)
+            continue;
+        const normalized = normalizeContactHandle(handle);
+        if (!normalized)
+            continue;
+        if (map.has(normalized))
+            continue;
+        map.set(normalized, { name: name.trim() });
+    }
+    return map;
+}
+/**
+ * Run the contacts dump AppleScript and return a ContactsMap. Returns
+ * an empty map (with a warning log) on any failure — most commonly, the
+ * user hasn't authorized Contacts access yet, in which case macOS
+ * surfaces a one-time system prompt and this call returns empty until
+ * the user accepts on a subsequent run.
+ */
+export async function loadContacts() {
+    try {
+        const stdout = await runContactsScript(CONTACTS_DUMP_SCRIPT);
+        const map = parseContactsOutput(stdout);
+        logger.info(`[imessage] Contacts loaded: ${map.size} handle(s) resolved from Contacts.app`);
+        return map;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        if (/not authorized|1743/.test(reason)) {
+            logger.warn("[imessage] Contacts access not yet authorized. macOS will prompt " +
+                "the user on the next run. Inbound messages will use raw handles " +
+                "(phone numbers / emails) until Contacts access is granted.");
+        }
+        else {
+            logger.warn(`[imessage] Failed to load Contacts.app data: ${reason}. ` +
+                "Inbound messages will use raw handles instead of names.");
+        }
+        return new Map();
+    }
+}
+/**
+ * Escape a JavaScript string so it can be embedded inside an
+ * AppleScript double-quoted string literal. Handles backslashes and
+ * quotes — AppleScript doesn't treat newlines specially inside quoted
+ * strings, so those pass through as-is.
+ */
+function escapeAppleScriptString(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+/**
+ * Whether we've already confirmed Contacts.app is running in this
+ * process lifetime. Avoids paying the `open -a` cost on every call.
+ */
+let contactsLaunched = false;
+function getContactsScriptTimeoutMs() {
+    const raw = Number(process.env.IMESSAGE_CONTACTS_TIMEOUT_MS);
+    return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_CONTACTS_SCRIPT_TIMEOUT_MS;
+}
+/**
+ * Ensure Contacts.app is actually in the running process list before
+ * handing an AppleScript to it. Annoyingly, the `launch` verb inside
+ * `tell application "Contacts"` is a no-op on modern macOS when the
+ * app isn't already running — it doesn't actually start the process,
+ * and the subsequent scripting call returns `Application isn't running
+ * (-600)`. The reliable fix is to use the shell-level `open` which
+ * goes through LaunchServices and spawns the app.
+ *
+ * `-g` launches in the background so Contacts doesn't steal focus from
+ * whatever window the user was just looking at (a plain `open -a`
+ * raises the app to the foreground, which interrupts the UI mid-boot).
+ * `-j` hides the app entirely on first launch so the user never sees a
+ * Contacts window flash across the screen — the AppleScript bridge
+ * still works against a hidden instance.
+ *
+ * Idempotent: after the first successful launch we set a flag and
+ * subsequent calls are no-ops. If Contacts.app is force-quit mid-run
+ * the next osascript will still throw -600 and the caller's error
+ * path will log it; at that point restarting the plugin recovers.
+ */
+async function ensureContactsLaunched() {
+    if (contactsLaunched)
+        return;
+    try {
+        await execFileAsync("open", ["-g", "-j", "-a", "Contacts"]);
+        // Give LaunchServices a beat to register the process so the next
+        // scripting-bridge call finds it. 400ms is empirical: 100ms was
+        // flaky, 250ms worked most of the time, 400ms has been reliable.
+        await new Promise((r) => setTimeout(r, 400));
+        contactsLaunched = true;
+    }
+    catch {
+        // If `open` fails (unlikely — it's a LaunchServices primitive
+        // that almost never fails on a healthy Mac), we still try the
+        // osascript below. The error from there will be more informative.
+    }
+}
+/**
+ * Run an AppleScript against Contacts.app and return its stdout. Shared
+ * helper used by every read/write in this file. On failure — which
+ * includes both TCC denials and actual script errors — throws an Error
+ * with the stderr/message for the caller to classify.
+ */
+async function runContactsScript(script) {
+    await ensureContactsLaunched();
+    const { stdout } = await execFileAsync("osascript", ["-e", script], {
+        maxBuffer: 10 * 1024 * 1024,
+        timeout: getContactsScriptTimeoutMs(),
+        killSignal: "SIGTERM",
+    });
+    return stdout;
+}
+/**
+ * Parse the tab-delimited output of the full-contacts dump. One row per
+ * contact with pipe-separated phone and email lists so the script can
+ * return everything in a single round-trip.
+ *
+ * Row format (tab-delimited):
+ *   `<id>\t<name>\t<firstName>\t<lastName>\t<phones>\t<emails>`
+ * where <phones> is `label1=value1|label2=value2` and same for emails.
+ * Empty fields are empty strings, not missing.
+ */
+function parseFullContactsOutput(raw) {
+    const out = [];
+    if (!raw?.trim())
+        return out;
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const fields = trimmed.split("\t");
+        if (fields.length < 6)
+            continue;
+        const [id, name, firstName, lastName, phonesField, emailsField] = fields;
+        if (!id)
+            continue;
+        const parsePairs = (input) => {
+            if (!input)
+                return [];
+            return input
+                .split("|")
+                .filter(Boolean)
+                .map((pair) => {
+                const eqIdx = pair.indexOf("=");
+                if (eqIdx === -1)
+                    return { label: null, value: pair };
+                return {
+                    label: pair.slice(0, eqIdx) || null,
+                    value: pair.slice(eqIdx + 1),
+                };
+            });
+        };
+        out.push({
+            id,
+            name: name || "",
+            firstName: firstName || null,
+            lastName: lastName || null,
+            phones: parsePairs(phonesField),
+            emails: parsePairs(emailsField),
+        });
+    }
+    return out;
+}
+/**
+ * AppleScript that dumps every contact as a tab-delimited row with
+ * pipe-separated phone and email lists. Matches `parseFullContactsOutput`
+ * above. Runs in a single round-trip against Contacts.app.
+ */
+const FULL_CONTACTS_DUMP_SCRIPT = `
+tell application "Contacts"
+  launch
+  set AppleScript's text item delimiters to tab
+  set outputLines to {}
+  repeat with p in people
+    set personId to id of p
+    set personName to name of p
+    if personName is missing value then set personName to ""
+    set personFirst to first name of p
+    if personFirst is missing value then set personFirst to ""
+    set personLast to last name of p
+    if personLast is missing value then set personLast to ""
+
+    set phoneList to ""
+    repeat with ph in phones of p
+      set phoneValue to value of ph
+      if phoneValue is not missing value then
+        set phoneLabel to label of ph
+        if phoneLabel is missing value then set phoneLabel to ""
+        if phoneList is not "" then set phoneList to phoneList & "|"
+        set phoneList to phoneList & phoneLabel & "=" & phoneValue
+      end if
+    end repeat
+
+    set emailList to ""
+    repeat with em in emails of p
+      set emailValue to value of em
+      if emailValue is not missing value then
+        set emailLabel to label of em
+        if emailLabel is missing value then set emailLabel to ""
+        if emailList is not "" then set emailList to emailList & "|"
+        set emailList to emailList & emailLabel & "=" & emailValue
+      end if
+    end repeat
+
+    set end of outputLines to personId & tab & personName & tab & personFirst & tab & personLast & tab & phoneList & tab & emailList
+  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
+`.trim();
+/**
+ * List every contact in the user's address book as a full `FullContact`
+ * record. Returns an empty array on any failure (permission denied,
+ * script error, etc.) with a warning log.
+ */
+export async function listAllContacts() {
+    try {
+        const stdout = await runContactsScript(FULL_CONTACTS_DUMP_SCRIPT);
+        return parseFullContactsOutput(stdout);
+    }
+    catch (error) {
+        logger.warn(`[imessage] listAllContacts failed: ${error instanceof Error ? error.message : String(error)}`);
+        return [];
+    }
+}
+/**
+ * Create a new contact in Contacts.app. Returns the new person's id on
+ * success, or null on failure (permission denied, validation, etc.).
+ *
+ * Requires Contacts WRITE permission, which macOS prompts for on the
+ * first write call. Read-only sessions never trigger this prompt.
+ */
+export async function addContact(input) {
+    const first = escapeAppleScriptString(input.firstName ?? "");
+    const last = escapeAppleScriptString(input.lastName ?? "");
+    // Build phone + email blocks as separate `make new phone/email` verbs
+    // nested inside a `tell newPerson` block. This lets us set the label
+    // on each one, which the simpler `{phones: {...}}` property syntax
+    // doesn't support.
+    const phoneLines = (input.phones ?? [])
+        .filter((p) => p.value)
+        .map((p) => {
+        const value = escapeAppleScriptString(p.value);
+        const label = escapeAppleScriptString(p.label ?? "mobile");
+        return `make new phone at end of phones with properties {value:"${value}", label:"${label}"}`;
+    })
+        .join("\n    ");
+    const emailLines = (input.emails ?? [])
+        .filter((e) => e.value)
+        .map((e) => {
+        const value = escapeAppleScriptString(e.value);
+        const label = escapeAppleScriptString(e.label ?? "home");
+        return `make new email at end of emails with properties {value:"${value}", label:"${label}"}`;
+    })
+        .join("\n    ");
+    const script = `
+tell application "Contacts"
+  launch
+  set newPerson to make new person with properties {first name:"${first}", last name:"${last}"}
+  tell newPerson
+    ${phoneLines}
+    ${emailLines}
+  end tell
+  save
+  return id of newPerson
+end tell
+  `.trim();
+    try {
+        const stdout = await runContactsScript(script);
+        const id = stdout.trim();
+        if (!id)
+            return null;
+        logger.info(`[imessage] Contact created: ${id}`);
+        return id;
+    }
+    catch (error) {
+        logger.warn(`[imessage] addContact failed: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+export async function updateContact(personId, patch) {
+    const id = escapeAppleScriptString(personId);
+    const fragments = [];
+    if (patch.firstName !== undefined) {
+        fragments.push(`set first name of thePerson to "${escapeAppleScriptString(patch.firstName)}"`);
+    }
+    if (patch.lastName !== undefined) {
+        fragments.push(`set last name of thePerson to "${escapeAppleScriptString(patch.lastName)}"`);
+    }
+    for (const phone of patch.addPhones ?? []) {
+        if (!phone.value)
+            continue;
+        fragments.push(`tell thePerson to make new phone at end of phones with properties {value:"${escapeAppleScriptString(phone.value)}", label:"${escapeAppleScriptString(phone.label ?? "mobile")}"}`);
+    }
+    for (const phoneValue of patch.removePhones ?? []) {
+        if (!phoneValue)
+            continue;
+        fragments.push(`
+    tell thePerson
+      repeat with ph in phones
+        if (value of ph) is "${escapeAppleScriptString(phoneValue)}" then
+          delete ph
+          exit repeat
+        end if
+      end repeat
+    end tell`);
+    }
+    for (const email of patch.addEmails ?? []) {
+        if (!email.value)
+            continue;
+        fragments.push(`tell thePerson to make new email at end of emails with properties {value:"${escapeAppleScriptString(email.value)}", label:"${escapeAppleScriptString(email.label ?? "home")}"}`);
+    }
+    for (const emailValue of patch.removeEmails ?? []) {
+        if (!emailValue)
+            continue;
+        fragments.push(`
+    tell thePerson
+      repeat with em in emails
+        if (value of em) is "${escapeAppleScriptString(emailValue)}" then
+          delete em
+          exit repeat
+        end if
+      end repeat
+    end tell`);
+    }
+    if (fragments.length === 0) {
+        // Nothing to do — treat as a successful no-op.
+        return true;
+    }
+    const script = `
+tell application "Contacts"
+  launch
+  set thePerson to person id "${id}"
+  ${fragments.join("\n  ")}
+  save
+  return "ok"
+end tell
+  `.trim();
+    try {
+        await runContactsScript(script);
+        logger.info(`[imessage] Contact updated: ${personId}`);
+        return true;
+    }
+    catch (error) {
+        logger.warn(`[imessage] updateContact failed for ${personId}: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+/**
+ * Delete a contact by Contacts.app id. Requires write permission.
+ * Returns false on any failure (not found, permission denied, etc.).
+ */
+export async function deleteContact(personId) {
+    const id = escapeAppleScriptString(personId);
+    const script = `
+tell application "Contacts"
+  launch
+  delete (person id "${id}")
+  save
+  return "ok"
+end tell
+  `.trim();
+    try {
+        await runContactsScript(script);
+        logger.info(`[imessage] Contact deleted: ${personId}`);
+        return true;
+    }
+    catch (error) {
+        logger.warn(`[imessage] deleteContact failed for ${personId}: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+//# sourceMappingURL=contacts-reader.js.map

package/dist/contacts-reader.js.map

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

package/dist/index.d.ts

@@ -1,23 +1,23 @@
 /**
- * iMessage Plugin for ElizaOS
+ * iMessage Plugin for elizaOS
  *
- * Provides iMessage integration for ElizaOS agents on macOS.
+ * Provides iMessage integration for Eliza agents on macOS.
  * Uses AppleScript and/or CLI tools to send and receive messages.
  */
-import type { Plugin } from "@elizaos/core";
-import { sendMessage } from "./actions/index.js";
-import { chatContextProvider } from "./providers/index.js";
-import { IMessageService, parseChatsFromAppleScript, parseMessagesFromAppleScript } from "./service.js";
-export * from "./types.js";
-export { IMessageService, parseMessagesFromAppleScript, parseChatsFromAppleScript };
-export { sendMessage };
-export { chatContextProvider };
+import { type Plugin } from "@elizaos/core";
+import { chatDbMessageToPublicShape, IMessageService, parseChatsFromAppleScript, parseMessagesFromAppleScript } from "./service.js";
 export { DEFAULT_ACCOUNT_ID, type IMessageAccountConfig, type IMessageGroupConfig, type IMessageMultiAccountConfig, isIMessageMentionRequired, isIMessageUserAllowed, isMultiAccountEnabled, listEnabledIMessageAccounts, listIMessageAccountIds, normalizeAccountId, type ResolvedIMessageAccount, resolveDefaultIMessageAccountId, resolveIMessageAccount, resolveIMessageGroupConfig, } from "./accounts.js";
+export { appleDateToJsMs, type ChatDbAccessIssue, type ChatDbMessage, type ChatDbReader, createFullDiskAccessAction, DEFAULT_CHAT_DB_PATH, getLastChatDbAccessIssue, MACOS_FULL_DISK_ACCESS_SETTINGS_URL, openChatDb, } from "./chatdb-reader.js";
+export { addContact, type ContactPatch, type ContactsMap, deleteContact, type FullContact, listAllContacts, loadContacts, type NewContactInput, normalizeContactHandle, parseContactsOutput, type ResolvedContact, updateContact, } from "./contacts-reader.js";
 export { createIMessageRpcClient, DEFAULT_PROBE_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, getChatInfo, getContactInfo, getMessages, type IMessageAttachment, type IMessageChat, type IMessageContact, type IMessageMessage, IMessageRpcClient, type IMessageRpcClientOptions, type IMessageRpcError, type IMessageRpcNotification, type IMessageRpcResponse, listChats, listContacts, probeIMessageRpc, sendIMessageRpc, } from "./rpc.js";
+export * from "./types.js";
+export { chatDbMessageToPublicShape, IMessageService, parseChatsFromAppleScript, parseMessagesFromAppleScript, };
 /**
- * iMessage plugin for ElizaOS agents.
+ * iMessage plugin for Eliza agents.
  */
 declare const imessagePlugin: Plugin;
 export default imessagePlugin;
+export { type BlueBubblesRouteState, handleBlueBubblesRoute, resolveBlueBubblesWebhookPath, } from "./api/bluebubbles-routes.js";
+export { handleIMessageRoute, type IMessageRouteState, type ReadJsonBodyOptions as IMessageRouteReadJsonBodyOptions, type RouteHelpers as IMessageRouteHelpers, type RouteRequestMeta as IMessageRouteRequestMeta, } from "./api/imessage-routes.js";
 export type { IMessageConfig, IMessageReactionNotificationMode, } from "./config.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,cAAc,CAAC;AAGtB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAG/B,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,QAAA,MAAM,cAAc,EAAE,MAgCrB,CAAC;AAEF,eAAe,cAAc,CAAC;AAG9B,YAAY,EACV,cAAc,EACd,gCAAgC,GACjC,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAA0D,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAMpG,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,mCAAmC,EACnC,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,WAAW,EAChB,eAAe,EACf,YAAY,EACZ,KAAK,eAAe,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,eAAe,EACpB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,yBAAyB,EACzB,4BAA4B,GAC7B,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,cAAc,EAAE,MAwDrB,CAAC;AAEF,eAAe,cAAc,CAAC;AAE9B,OAAO,EACL,KAAK,qBAAqB,EAC1B,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EACL,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,IAAI,gCAAgC,EAC5D,KAAK,YAAY,IAAI,oBAAoB,EACzC,KAAK,gBAAgB,IAAI,wBAAwB,GAClD,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,cAAc,EACd,gCAAgC,GACjC,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,35 +1,61 @@
 /**
- * iMessage Plugin for ElizaOS
+ * iMessage Plugin for elizaOS
  *
- * Provides iMessage integration for ElizaOS agents on macOS.
+ * Provides iMessage integration for Eliza agents on macOS.
  * Uses AppleScript and/or CLI tools to send and receive messages.
  */
 import { platform } from "node:os";
-import { logger } from "@elizaos/core";
-import { sendMessage } from "./actions/index.js";
-import { chatContextProvider } from "./providers/index.js";
-import { IMessageService, parseChatsFromAppleScript, parseMessagesFromAppleScript, } from "./service.js";
-// Re-export types and service
-export * from "./types.js";
-export { IMessageService, parseMessagesFromAppleScript, parseChatsFromAppleScript };
-export { sendMessage };
-export { chatContextProvider };
+import { getConnectorAccountManager, logger } from "@elizaos/core";
+import { createIMessageConnectorAccountProvider } from "./connector-account-provider.js";
+// The former iMessage-specific send action duplicated the MessageConnector
+// path. The connector registered by IMessageService.registerSendHandlers is
+// now the canonical delivery path through MESSAGE operation=send. This plugin
+// no longer registers its own send action.
+import { chatDbMessageToPublicShape, IMessageService, parseChatsFromAppleScript, parseMessagesFromAppleScript, } from "./service.js";
+import { imessageSetupRoutes } from "./setup-routes.js";
 // Account management exports
 export { DEFAULT_ACCOUNT_ID, isIMessageMentionRequired, isIMessageUserAllowed, isMultiAccountEnabled, listEnabledIMessageAccounts, listIMessageAccountIds, normalizeAccountId, resolveDefaultIMessageAccountId, resolveIMessageAccount, resolveIMessageGroupConfig, } from "./accounts.js";
+// chat.db reader (bun:sqlite-backed inbound polling)
+export { appleDateToJsMs, createFullDiskAccessAction, DEFAULT_CHAT_DB_PATH, getLastChatDbAccessIssue, MACOS_FULL_DISK_ACCESS_SETTINGS_URL, openChatDb, } from "./chatdb-reader.js";
+// Apple Contacts reader (display-name resolution for inbound handles)
+export { addContact, deleteContact, listAllContacts, loadContacts, normalizeContactHandle, parseContactsOutput, updateContact, } from "./contacts-reader.js";
 // RPC client exports
 export { createIMessageRpcClient, DEFAULT_PROBE_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, getChatInfo, getContactInfo, getMessages, IMessageRpcClient, listChats, listContacts, probeIMessageRpc, sendIMessageRpc, } from "./rpc.js";
+// Re-export types and service
+export * from "./types.js";
+export { chatDbMessageToPublicShape, IMessageService, parseChatsFromAppleScript, parseMessagesFromAppleScript, };
 /**
- * iMessage plugin for ElizaOS agents.
+ * iMessage plugin for Eliza agents.
  */
 const imessagePlugin = {
     name: "imessage",
-    description: "iMessage plugin for ElizaOS agents (macOS only)",
+    description: "iMessage plugin for Eliza agents (macOS only)",
     services: [IMessageService],
-    actions: [sendMessage],
-    providers: [chatContextProvider],
+    actions: [],
+    providers: [],
+    routes: imessageSetupRoutes,
     tests: [],
-    init: async (config, _runtime) => {
+    // Self-declared auto-enable: activate when the "imessage" connector is
+    // configured under config.connectors. The hardcoded CONNECTOR_PLUGINS map
+    // in plugin-auto-enable-engine.ts still serves as a fallback.
+    autoEnable: {
+        connectorKeys: ["imessage"],
+    },
+    init: async (config, runtime) => {
         logger.info("Initializing iMessage plugin...");
+        // Register the iMessage provider with the ConnectorAccountManager so the
+        // HTTP CRUD surface (packages/agent/src/api/connector-account-routes.ts)
+        // can list, create, patch, and delete iMessage accounts.
+        try {
+            const manager = getConnectorAccountManager(runtime);
+            manager.registerProvider(createIMessageConnectorAccountProvider(runtime));
+        }
+        catch (err) {
+            logger.warn({
+                src: "plugin:imessage",
+                err: err instanceof Error ? err.message : String(err),
+            }, "Failed to register iMessage provider with ConnectorAccountManager");
+        }
         const isMacOS = platform() === "darwin";
         logger.info("iMessage plugin configuration:");
         logger.info(`  - Platform: ${platform()}`);
@@ -43,4 +69,10 @@ const imessagePlugin = {
     },
 };
 export default imessagePlugin;
+export { handleBlueBubblesRoute, resolveBlueBubblesWebhookPath, } from "./api/bluebubbles-routes.js";
+// Legacy HTTP route handlers (mounted by the agent's raw HTTP router).
+// These are the moved counterparts of the agent's old api/imessage-routes.ts
+// and api/bluebubbles-routes.ts files. Per the audit, BlueBubbles is treated
+// as part of iMessage, so both live here.
+export { handleIMessageRoute, } from "./api/imessage-routes.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AAEtB,8BAA8B;AAC9B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,6BAA6B;AAC7B,OAAO,EACL,kBAAkB,EAIlB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAElB,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,qBAAqB;AACrB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,WAAW,EACX,cAAc,EACd,WAAW,EAKX,iBAAiB,EAKjB,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,cAAc,GAAW;IAC7B,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,iDAAiD;IAE9D,QAAQ,EAAE,CAAC,eAAe,CAAC;IAC3B,OAAO,EAAE,CAAC,WAAW,CAAC;IACtB,SAAS,EAAE,CAAC,mBAAmB,CAAC;IAChC,KAAK,EAAE,EAAE;IAET,IAAI,EAAE,KAAK,EAAE,MAA8B,EAAE,QAAuB,EAAiB,EAAE;QACrF,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAE/C,MAAM,OAAO,GAAG,QAAQ,EAAE,KAAK,QAAQ,CAAC;QAExC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,iBAAiB,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CACT,iBAAiB,MAAM,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,gBAAgB,EAAE,CACjG,CAAC;QACF,MAAM,CAAC,IAAI,CACT,kBAAkB,MAAM,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS,EAAE,CAC7F,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,2FAA2F,CAC5F,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/providers/index.d.ts

@@ -1,5 +1,4 @@
 /**
- * iMessage plugin providers.
+ * iMessage prompt context is exposed through MESSAGE connector hooks.
  */
-export { chatContextProvider } from "./chatContext.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}