imsg-mcp 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and follows [Semantic Versioning](https://semver.org/).
 
+# [1.9.0](https://github.com/george43g/imsg-mcp/compare/v1.8.0...v1.9.0) (2026-07-21)
+
+
+### Features
+
+* **db:** extract Apple-native voice-note transcripts, Genmoji & reply kinds ([6b9d715](https://github.com/george43g/imsg-mcp/commit/6b9d715dd6c356a337b8bb0b3ef96ff40419a73a))
+
 # [1.8.0](https://github.com/george43g/imsg-mcp/compare/v1.7.0...v1.8.0) (2026-07-20)
 
 

package/README.md

@@ -108,7 +108,7 @@ Full reference (CLI subcommands + MCP tools + every flag): [**docs/TOOLS.md**](d
 imsg tui
 ```
 
-Vim-style: `j/k` move, `gg/G` jump, `Enter` drawer, `o` Quick Look an attachment, `:` jump to date, `V` visual select, `e` export, `S` send via other app, `y` copy slug, `c` compose in current thread, `N` compose to new recipient (phone / email / contact name), `q` quit.
+Vim-style: `j/k` move, `gg/G` jump, `Enter` drawer, `i` per-thread info + attachment browser, `o` Quick Look an attachment, `:` jump to date, `V` visual select, `e` export, `S` send via other app, `y` copy slug, `c` compose in current thread, `N` compose to new recipient (phone / email / contact name), `q` quit.
 
 Themes (`safe` / `powerline`) and a single accent color drive the whole palette. See [docs/TOOLS.md#tui-configuration](docs/TOOLS.md#tui-configuration).
 

package/dist/cli.js

@@ -4,7 +4,7 @@ import { createInterface } from "node:readline";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { Command } from "commander";
 import { c as checkLocalAccess, f as formatAccessReport, J as IMPLEMENTED_TYPES, K as ANALYTIC_INFO, w as installShutdownHandlers, x as registerCleanup, L as looksLikeThreadSlug } from "./shutdown-CQ9wzrxA.js";
-import { A as APP_VERSION, t as toYaml } from "./meta-DSkZz63Q.js";
+import { A as APP_VERSION, t as toYaml } from "./meta-BrYyl7Ls.js";
 import { spawn } from "node:child_process";
 import { join, dirname } from "node:path";
 function distRoot() {
@@ -447,7 +447,7 @@ async function runExportCommand(target, opts) {
   const { homedir } = await import("node:os");
   const { dirname: dirname2, join: join2, isAbsolute, resolve } = await import("node:path");
   const { getContactsDbPaths, getImsgDbPath, getSlugsDbPath } = await import("./shutdown-CQ9wzrxA.js").then((n) => n.a0);
-  const { IMessageDB } = await import("./imessage-db-BXrBHlvx.js").then((n) => n.i);
+  const { IMessageDB } = await import("./imessage-db-vrzopRGT.js").then((n) => n.i);
   const { streamExport } = await import("./exportStream-DgPVRZTZ.js");
   const { parseUserDate } = await import("./date-parse-DJXMfq3a.js");
   const format = normalizeFormat(opts.format ?? "md");

package/dist/{imessage-db-BXrBHlvx.js → imessage-db-vrzopRGT.js}

@@ -767,6 +767,47 @@ function scoreCandidate(text) {
   return score;
 }
 const STRUCTURED_BOOST = 500;
+const AUDIO_TRANSCRIPTION_MARKER = Buffer.from("IMAudioTranscription", "ascii");
+const AUDIO_VALUE_FRAMING = Buffer.from([134, 146, 132, 150, 150]);
+function extractAudioTranscription(blob) {
+  if (!blob) return void 0;
+  const markerAt = blob.indexOf(AUDIO_TRANSCRIPTION_MARKER);
+  if (markerAt === -1) return void 0;
+  let pos = markerAt + AUDIO_TRANSCRIPTION_MARKER.length;
+  if (blob.subarray(pos, pos + AUDIO_VALUE_FRAMING.length).equals(AUDIO_VALUE_FRAMING)) {
+    pos += AUDIO_VALUE_FRAMING.length;
+  } else {
+    const scanEnd = Math.min(pos + 8, blob.length);
+    let found = -1;
+    for (let i = pos; i < scanEnd; i++) {
+      const b = blob[i];
+      if (b === 129 || b === 130 || b <= 128) {
+        found = i;
+        break;
+      }
+    }
+    if (found === -1) return void 0;
+    pos = found;
+  }
+  if (pos >= blob.length) return void 0;
+  const lenByte = blob[pos++];
+  let length;
+  if (lenByte === 129) {
+    if (pos + 2 > blob.length) return void 0;
+    length = blob.readUInt16LE(pos);
+    pos += 2;
+  } else if (lenByte === 130) {
+    if (pos + 4 > blob.length) return void 0;
+    length = blob.readUInt32LE(pos);
+    pos += 4;
+  } else {
+    length = lenByte;
+  }
+  if (length <= 0 || pos + length > blob.length) return void 0;
+  const text = blob.toString("utf8", pos, pos + length).trim();
+  if (!text || !/[\p{L}\p{N}]/u.test(text)) return void 0;
+  return text;
+}
 function extractAttributedBodyText(blob) {
   if (!blob) return void 0;
   const native = getNativeParser();
@@ -819,6 +860,63 @@ function extractAttributedBodyText(blob) {
   const best = [...candidates.entries()].sort((a, b) => b[1] - a[1])[0];
   return best?.[0];
 }
+function mergeDuplicateConversations(prepared) {
+  const merged = [];
+  const indexByKey = /* @__PURE__ */ new Map();
+  for (const entry of prepared) {
+    const existingIndex = indexByKey.get(entry.mergeKey);
+    if (existingIndex === void 0) {
+      indexByKey.set(entry.mergeKey, merged.length);
+      merged.push(entry);
+      continue;
+    }
+    merged[existingIndex] = mergeConversationEntries(merged[existingIndex], entry);
+  }
+  return merged;
+}
+function mergeConversationEntries(left, right) {
+  const preferred = pickPreferredConversationEntry(left, right);
+  const other = preferred === left ? right : left;
+  const sameIdentifier = preferred.conversation.chatIdentifier === other.conversation.chatIdentifier;
+  return {
+    mergeKey: preferred.mergeKey,
+    last: preferred.last ?? other.last,
+    conversation: {
+      ...preferred.conversation,
+      displayName: preferred.conversation.displayName ?? other.conversation.displayName,
+      participants: [
+        .../* @__PURE__ */ new Set([...preferred.conversation.participants, ...other.conversation.participants])
+      ],
+      unreadCount: sameIdentifier ? Math.max(preferred.conversation.unreadCount, other.conversation.unreadCount) : preferred.conversation.unreadCount + other.conversation.unreadCount
+    }
+  };
+}
+function pickPreferredConversationEntry(left, right) {
+  const leftTime = left.conversation.lastMessageDate?.getTime() ?? 0;
+  const rightTime = right.conversation.lastMessageDate?.getTime() ?? 0;
+  if (leftTime !== rightTime) {
+    return leftTime > rightTime ? left : right;
+  }
+  const preferredService = left.last?.lastService ?? right.last?.lastService ?? null;
+  if (preferredService) {
+    const preferredType = preferredService.toLowerCase().includes("sms") ? "SMS" : "iMessage";
+    if (left.conversation.serviceType === preferredType && right.conversation.serviceType !== preferredType) {
+      return left;
+    }
+    if (right.conversation.serviceType === preferredType && left.conversation.serviceType !== preferredType) {
+      return right;
+    }
+  }
+  if (left.conversation.displayName && !right.conversation.displayName) return left;
+  if (right.conversation.displayName && !left.conversation.displayName) return right;
+  if (left.conversation.serviceType === "iMessage" && right.conversation.serviceType === "SMS") {
+    return left;
+  }
+  if (right.conversation.serviceType === "iMessage" && left.conversation.serviceType === "SMS") {
+    return right;
+  }
+  return left;
+}
 function normalizeSnippetText(text) {
   if (!text) return null;
   const attachmentMarker = new RegExp(
@@ -1162,6 +1260,8 @@ class IMessageDB {
    * other clear site. Add one if you introduce a read path that bypasses it.
    */
   cachedReactionsByChat = /* @__PURE__ */ new Map();
+  /** Per-table column-name sets, for optional-column guards (schema drift / synthetic fixtures). */
+  columnCache = /* @__PURE__ */ new Map();
   backgroundSyncNeeded = true;
   backgroundRefreshScheduled = false;
   /** Set on close() so background chunked work stops touching a closed DB. */
@@ -1771,12 +1871,12 @@ class IMessageDB {
     const CHUNK = Math.max(limit, 200);
     const prepared = [];
     let cursor = 0;
-    let deduped = this.mergeDuplicateConversations(prepared);
+    let deduped = mergeDuplicateConversations(prepared);
     while (deduped.length < limit && cursor < sortEntries.length) {
       const chunk = sortEntries.slice(cursor, cursor + CHUNK);
       cursor += chunk.length;
       for (const entry of chunk) prepared.push(enrich(entry));
-      deduped = this.mergeDuplicateConversations(prepared);
+      deduped = mergeDuplicateConversations(prepared);
     }
     const selected = deduped.slice(0, limit);
     const result = selected.map(({ conversation, last }) => ({
@@ -2091,63 +2191,6 @@ class IMessageDB {
     }
     return null;
   }
-  mergeDuplicateConversations(prepared) {
-    const merged = [];
-    const indexByKey = /* @__PURE__ */ new Map();
-    for (const entry of prepared) {
-      const existingIndex = indexByKey.get(entry.mergeKey);
-      if (existingIndex === void 0) {
-        indexByKey.set(entry.mergeKey, merged.length);
-        merged.push(entry);
-        continue;
-      }
-      merged[existingIndex] = this.mergeConversationEntries(merged[existingIndex], entry);
-    }
-    return merged;
-  }
-  mergeConversationEntries(left, right) {
-    const preferred = this.pickPreferredConversationEntry(left, right);
-    const other = preferred === left ? right : left;
-    const sameIdentifier = preferred.conversation.chatIdentifier === other.conversation.chatIdentifier;
-    return {
-      mergeKey: preferred.mergeKey,
-      last: preferred.last ?? other.last,
-      conversation: {
-        ...preferred.conversation,
-        displayName: preferred.conversation.displayName ?? other.conversation.displayName,
-        participants: [
-          .../* @__PURE__ */ new Set([...preferred.conversation.participants, ...other.conversation.participants])
-        ],
-        unreadCount: sameIdentifier ? Math.max(preferred.conversation.unreadCount, other.conversation.unreadCount) : preferred.conversation.unreadCount + other.conversation.unreadCount
-      }
-    };
-  }
-  pickPreferredConversationEntry(left, right) {
-    const leftTime = left.conversation.lastMessageDate?.getTime() ?? 0;
-    const rightTime = right.conversation.lastMessageDate?.getTime() ?? 0;
-    if (leftTime !== rightTime) {
-      return leftTime > rightTime ? left : right;
-    }
-    const preferredService = left.last?.lastService ?? right.last?.lastService ?? null;
-    if (preferredService) {
-      const preferredType = preferredService.toLowerCase().includes("sms") ? "SMS" : "iMessage";
-      if (left.conversation.serviceType === preferredType && right.conversation.serviceType !== preferredType) {
-        return left;
-      }
-      if (right.conversation.serviceType === preferredType && left.conversation.serviceType !== preferredType) {
-        return right;
-      }
-    }
-    if (left.conversation.displayName && !right.conversation.displayName) return left;
-    if (right.conversation.displayName && !left.conversation.displayName) return right;
-    if (left.conversation.serviceType === "iMessage" && right.conversation.serviceType === "SMS") {
-      return left;
-    }
-    if (right.conversation.serviceType === "iMessage" && left.conversation.serviceType === "SMS") {
-      return right;
-    }
-    return left;
-  }
   getConversationMergeKey(chatIdentifier, chatGuid, isGroup) {
     const cacheKey = `${chatIdentifier}::${chatGuid}::${isGroup}`;
     const cached = this.cachedMergeKeys.get(cacheKey);
@@ -2486,11 +2529,7 @@ class IMessageDB {
     const isReply = Boolean(ext.thread_originator_guid);
     let replyTo;
     if (isReply && ext.thread_originator_guid) {
-      const originalText = this.getMessageTextByGuid(ext.thread_originator_guid);
-      replyTo = {
-        replyToGuid: ext.thread_originator_guid,
-        replyToText: originalText
-      };
+      replyTo = this.getReplyContextByGuid(ext.thread_originator_guid);
     }
     const richContentType = getRichContentType(ext.balloon_bundle_id || null);
     const hasAttachments = Boolean(ext.cache_has_attachments);
@@ -2520,6 +2559,7 @@ class IMessageDB {
       associatedMessageType: associatedType,
       hasAttachments
     });
+    const appleAudioTranscript = extractAudioTranscription(raw.attributedBody ?? null);
     return {
       id: raw.ROWID,
       guid: raw.guid,
@@ -2547,6 +2587,7 @@ class IMessageDB {
       richContentSummary,
       isEdited: !isUnsent && Boolean(ext.date_edited && ext.date_edited > 0),
       isRetracted: isUnsent || Boolean(ext.date_retracted && ext.date_retracted > 0),
+      appleAudioTranscript,
       hasAttachments,
       attachments
     };
@@ -2674,6 +2715,24 @@ class IMessageDB {
     }
     return result;
   }
+  /**
+   * Whether `table` has `column` in the current chat.db schema (cached per table).
+   * Guards columns that are absent on older macOS DBs or synthetic fixtures
+   * (e.g. `message.is_audio_message`, `attachment.emoji_image_short_description`).
+   */
+  hasColumn(table, column) {
+    let cols = this.columnCache.get(table);
+    if (!cols) {
+      try {
+        const rows = this.raw.prepare(`PRAGMA table_info(${table})`).all();
+        cols = new Set(rows.map((r) => r.name));
+      } catch {
+        cols = /* @__PURE__ */ new Set();
+      }
+      this.columnCache.set(table, cols);
+    }
+    return cols.has(column);
+  }
   /** Max ROWID currently in the message table — used as a cache key. */
   getMaxMessageRowId() {
     const row = this.raw.prepare(`SELECT COALESCE(MAX(ROWID), 0) AS m FROM ${Tables.MESSAGE}`).get();
@@ -2869,13 +2928,14 @@ class IMessageDB {
    * Fetch attachments for a message
    */
   fetchAttachments(messageRowId) {
+    const emojiCol = this.hasColumn("attachment", "emoji_image_short_description") ? ", a.emoji_image_short_description as emoji_desc" : "";
     const stmt = this.raw.prepare(`
-      SELECT 
+      SELECT
         a.ROWID as row_id,
         a.filename,
         a.mime_type,
         a.transfer_name,
-        a.total_bytes
+        a.total_bytes${emojiCol}
       FROM ${Tables.ATTACHMENT} a
       JOIN ${Tables.MESSAGE_ATTACHMENT_JOIN} maj ON a.ROWID = maj.attachment_id
       WHERE maj.message_id = ?
@@ -2886,7 +2946,8 @@ class IMessageDB {
       filename: r.filename || "",
       mimeType: r.mime_type,
       transferName: r.transfer_name,
-      totalBytes: r.total_bytes || 0
+      totalBytes: r.total_bytes || 0,
+      emojiDescription: r.emoji_desc ?? null
     }));
   }
   /**
@@ -2998,9 +3059,53 @@ class IMessageDB {
     const row = this.raw.prepare(`SELECT ROWID, text, attributedBody FROM ${Tables.MESSAGE} WHERE ROWID = ? LIMIT 1`).get(rowId);
     return this.extractMessageText(row);
   }
-  getMessageTextByGuid(guid) {
-    const row = this.raw.prepare(`SELECT ROWID, text, attributedBody FROM ${Tables.MESSAGE} WHERE guid = ? LIMIT 1`).get(guid);
-    return this.extractMessageText(row);
+  /**
+   * Build reply context for the message being replied to, by GUID. Beyond the
+   * plain text, this resolves what KIND of message it was when it carries no text
+   * of its own — a voice note (surfacing Apple's transcript), image, video, or
+   * file — so the UI renders "↩ voice note: '…'" instead of a bare "(unknown)".
+   */
+  getReplyContextByGuid(guid) {
+    const audioCol = this.hasColumn("message", "is_audio_message") ? "is_audio_message" : "0 AS is_audio_message";
+    const row = this.raw.prepare(
+      `SELECT ROWID, text, attributedBody, ${audioCol}, cache_has_attachments
+         FROM ${Tables.MESSAGE} WHERE guid = ? LIMIT 1`
+    ).get(guid);
+    const ctx = { replyToGuid: guid };
+    if (!row) return ctx;
+    if (row.is_audio_message) {
+      ctx.replyToKind = "voice-note";
+      ctx.replyToText = extractAudioTranscription(row.attributedBody) ?? null;
+      return ctx;
+    }
+    const text = this.extractMessageText(row);
+    if (text) {
+      ctx.replyToText = text;
+      return ctx;
+    }
+    if (row.cache_has_attachments) {
+      ctx.replyToKind = this.deriveAttachmentReplyKind(row.ROWID);
+      ctx.replyToText = null;
+      return ctx;
+    }
+    ctx.replyToText = null;
+    return ctx;
+  }
+  /** Map a message's first (non-sticker) attachment mime/uti to a reply-kind label. */
+  deriveAttachmentReplyKind(messageRowId) {
+    const utiCol = this.hasColumn("attachment", "uti") ? "a.uti" : "NULL AS uti";
+    const row = this.raw.prepare(
+      `SELECT a.mime_type, ${utiCol}
+         FROM ${Tables.ATTACHMENT} a
+         JOIN ${Tables.MESSAGE_ATTACHMENT_JOIN} maj ON a.ROWID = maj.attachment_id
+         WHERE maj.message_id = ? AND a.is_sticker = 0
+         ORDER BY a.ROWID LIMIT 1`
+    ).get(messageRowId);
+    const mime = (row?.mime_type ?? "").toLowerCase();
+    const uti = (row?.uti ?? "").toLowerCase();
+    if (mime.startsWith("image/") || uti.includes("image")) return "image";
+    if (mime.startsWith("video/") || uti.includes("movie") || uti.includes("video")) return "video";
+    return "file";
   }
   extractMessageText(row) {
     if (!row) return null;
@@ -3019,4 +3124,4 @@ export {
   normalizedPhoneVariants as n,
   rankFuzzy as r
 };
-//# sourceMappingURL=imessage-db-BXrBHlvx.js.map
+//# sourceMappingURL=imessage-db-vrzopRGT.js.map