@elizaos/plugin-imessage 2.0.0-beta.1 → 2.0.3-beta.3

package/dist/contacts-reader.d.ts

@@ -10,20 +10,16 @@
  *
  * ---
  *
- * 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.
+ * Backend: **CNContactStore** through the shared native macOS dylib. This
+ * keeps the feature aligned with the macOS Contacts privacy grant and avoids
+ * asking for Automation access to the Contacts app.
  *
- * 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.
+ * The service calls this lazily when it actually needs name resolution or
+ * contact CRUD. Contacts rarely change mid-session, so the iMessage service
+ * caches the returned map for v1.
  *
  * Graceful degradation: if Contacts is not authorized, or returns no
- * rows, or AppleScript fails for any other reason, the reader returns
+ * rows, or the native bridge 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.
  */
@@ -33,7 +29,7 @@
  * same name can appear under multiple handles.
  */
 export interface ResolvedContact {
-    /** The contact's display name as stored in Contacts.app. */
+    /** The contact's display name as stored in Apple Contacts. */
     name: string;
 }
 /**
@@ -43,6 +39,8 @@ export interface ResolvedContact {
  * {@link normalizeContactHandle} before querying.
  */
 export type ContactsMap = Map<string, ResolvedContact>;
+type ContactsFailure = "bridge_unavailable" | "native_error" | "permission" | null;
+export declare function getLastContactsFailure(): ContactsFailure;
 /**
  * Normalize a handle to the canonical form used as a key in the
  * ContactsMap. Strips whitespace, parentheses, hyphens, and dots from
@@ -50,34 +48,30 @@ export type ContactsMap = Map<string, ResolvedContact>;
  */
 export declare function normalizeContactHandle(raw: string): string;
 /**
- * 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.
+ * Parse legacy tab-delimited contact fixture output into a ContactsMap.
+ * Exported so tests can exercise normalization without a live address book.
  *
  * 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).
+ * Empty handles are skipped. Duplicate handles keep the first entry.
  */
 export declare function parseContactsOutput(raw: string): ContactsMap;
 /**
- * Run the contacts dump AppleScript and return a ContactsMap. Returns
+ * Read Apple Contacts through CNContactStore 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.
+ * user hasn't authorized Contacts access yet.
  */
 export declare function loadContacts(): Promise<ContactsMap>;
 /**
  * A full contact record, richer than ContactsMap's handle-keyed entries.
  * Returned by `listAllContacts` and the single-contact CRUD helpers.
- * Each phone/email carries its Contacts.app label when available
+ * Each phone/email carries its Apple Contacts label when available
  * (`home`, `work`, `mobile`, etc.) so the UI can surface context.
  */
 export interface FullContact {
-    /** Contacts.app stable person id (UUID-ish). Used for update/delete. */
+    /** Apple Contacts stable person id. Used for update/delete. */
     id: string;
-    /** Display name as stored in Contacts.app (composed by the app). */
+    /** Display name as stored in Apple Contacts. */
     name: string;
     firstName: string | null;
     lastName: string | null;
@@ -106,15 +100,14 @@ export interface NewContactInput {
 /**
  * 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.
+ * native bridge error, etc.) with a warning log.
  */
 export declare function listAllContacts(): Promise<FullContact[]>;
 /**
- * Create a new contact in Contacts.app. Returns the new person's id on
+ * Create a new Apple Contacts record. 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.
+ * Requires the Contacts privacy grant.
  */
 export declare function addContact(input: NewContactInput): Promise<string | null>;
 /**
@@ -140,8 +133,9 @@ export interface ContactPatch {
 }
 export declare function updateContact(personId: string, patch: ContactPatch): Promise<boolean>;
 /**
- * Delete a contact by Contacts.app id. Requires write permission.
+ * Delete a contact by Apple Contacts id. Requires the Contacts privacy grant.
  * Returns false on any failure (not found, permission denied, etc.).
  */
 export declare function deleteContact(personId: string): Promise<boolean>;
+export {};
 //# sourceMappingURL=contacts-reader.d.ts.map

package/dist/contacts-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contacts-reader.d.ts","sourceRoot":"","sources":["../src/contacts-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AASH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAa1D;AAqCD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAsB5D;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CAsBzD;AAkBD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AA4KD;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAU9D;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmD/E;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CA0E3F;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBtE"}
+{"version":3,"file":"contacts-reader.d.ts","sourceRoot":"","sources":["../src/contacts-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAWH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAUvD,KAAK,eAAe,GAAG,oBAAoB,GAAG,cAAc,GAAG,YAAY,GAAG,IAAI,CAAC;AAanF,wBAAgB,sBAAsB,IAAI,eAAe,CAExD;AA8GD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAsB5D;AAmBD;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CA8BzD;AAgBD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAiCD;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAiB9D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkB/E;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAiC3F;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBtE"}