imsg-mcp 1.18.0 → 1.19.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.19.0](https://github.com/george43g/imsg-mcp/compare/v1.18.0...v1.19.0) (2026-07-25)
+
+
+### Features
+
+* **contacts:** attach a normalized identity block to get_contact + resolve_handle ([99dfc72](https://github.com/george43g/imsg-mcp/commit/99dfc723e2a5bf8508f1b3940a63a0aeb684d120))
+
 # [1.18.0](https://github.com/george43g/imsg-mcp/compare/v1.17.0...v1.18.0) (2026-07-25)
 
 

package/dist/cli.js

@@ -4,7 +4,7 @@ import { createInterface } from "node:readline";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { Command } from "commander";
 import { d as checkLocalAccess, f as formatAccessReport, I as IMPLEMENTED_TYPES, A as ANALYTIC_INFO, i as installShutdownHandlers, r as registerCleanup, l as looksLikeThreadSlug } from "./shutdown-0TCv4XJB.js";
-import { A as APP_VERSION, t as toYaml } from "./meta-CZmUZHTh.js";
+import { A as APP_VERSION, t as toYaml } from "./meta-CD2uvSHu.js";
 import { spawn } from "node:child_process";
 import { join, dirname } from "node:path";
 function distRoot() {

package/dist/index.js

@@ -14,11 +14,11 @@ import { ensureAttachmentDownloaded } from "./attachment-sync-DMvlT8Zk.js";
 import { n as normalizedPhoneVariants, h as hasNativeModule, I as IMessageDB, r as rankFuzzy } from "./imessage-db-CHbdUXk3.js";
 import { parseUserDate } from "./date-parse-DJXMfq3a.js";
 import { streamExport, ExportInterpretGuardError } from "./exportStream-BFxilSlL.js";
-import { r as renderAnalyticText, A as APP_VERSION, a as APP_NAME } from "./meta-CZmUZHTh.js";
+import { n as normalizePhoneToE164, m as minMessageId, a as resolveRecipient, d as defaultCountryFromEnv, i as installWatchdog, b as noteActivity, r as readWatchdogState } from "./watchdog-D54vuRzh.js";
+import { r as renderAnalyticText, A as APP_VERSION, a as APP_NAME } from "./meta-CD2uvSHu.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { a as applyInlineInterpretations, i as imageBlockFromFile, v as videoPosterFrame, m as mediaMetadata, b as refForAttachment, T as TRANSCRIBE_MAX_BYTES, g as getInterpretRuntime, t as transcriptSourceEnum, d as detectTranscriber } from "./media-intel-runtime-BkxG4bmW.js";
-import { m as minMessageId, a as resolveRecipient, d as defaultCountryFromEnv, i as installWatchdog, n as noteActivity, r as readWatchdogState } from "./watchdog-CW2SEAmu.js";
 const DEFAULT_TTL_MS = 24 * 60 * 60 * 1e3;
 let dbPath = join(homedir(), ".imsg-mcp", "analytics-cache.db");
 let db = null;
@@ -323,6 +323,37 @@ function humansHintText(hint) {
 _Relationship file(s): ${list}_
 _${hint.guidance}_`;
 }
+function dedupe(items) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const item of items) {
+    if (item && !seen.has(item)) {
+      seen.add(item);
+      out.push(item);
+    }
+  }
+  return out;
+}
+function normalizeEmail(email) {
+  return email.trim().toLowerCase();
+}
+function e164OrOriginal(phone, country) {
+  return normalizePhoneToE164(phone, country) ?? phone.trim();
+}
+function buildIdentity(canonicalName, phoneNumbers, emails, country) {
+  const phones = dedupe(phoneNumbers.map((p) => e164OrOriginal(p, country)));
+  const mails = dedupe(emails.map(normalizeEmail));
+  return {
+    canonicalName,
+    phones,
+    emails: mails,
+    handles: dedupe([...phones, ...mails])
+  };
+}
+function buildIdentityFromHandle(handle, name, country) {
+  const isEmail = handle.includes("@");
+  return buildIdentity(name ?? handle, isEmail ? [] : [handle], isEmail ? [handle] : [], country);
+}
 const INSTRUCTIONS_UUID = randomUUID();
 function wrapUntrusted(text) {
   if (text == null || text === "") return "";
@@ -2001,8 +2032,16 @@ const GetContactSchema = z.object({
 }).refine((v) => v.handle !== void 0 || v.id !== void 0, {
   message: "Provide either `handle` or `id`."
 });
+const IdentitySchema = z.object({
+  canonicalName: z.string().describe("Best display name for this person (or the handle itself)."),
+  phones: z.array(z.string()).describe("Phone handles, E.164-normalized where derivable."),
+  emails: z.array(z.string()).describe("Email handles, trimmed + lowercased."),
+  handles: z.array(z.string()).describe("Every reachable handle, deduped — phones first, then emails.")
+});
 const GetContactOutputSchema = z.object({
   contact: ContactSchema.nullable(),
+  /** Normalized cross-tool handle view (E.164 phones, lowercased emails). */
+  identity: IdentitySchema.optional(),
   /** Per-handle conversation mapping: which thread slug each handle chats under. */
   threads: z.array(
     z.object({
@@ -2041,7 +2080,9 @@ const ResolveHandleOutputSchema = z.object({
   displayName: z.string(),
   contactId: z.number().int().nullable(),
   label: z.string().nullable(),
-  resolved: z.boolean()
+  resolved: z.boolean(),
+  /** Normalized cross-tool handle view — populated even when unresolved. */
+  identity: IdentitySchema.optional()
 });
 const CheckImessageAvailabilitySchema = z.object({
   handle: nonEmptyString("Phone number or email to preflight-check for reachability.")
@@ -2439,7 +2480,7 @@ const TOOLS = [
   },
   {
     name: "get_contact",
-    description: "Fetch a single contact by handle (phone/email) or by numeric id, including each handle's thread slug (for send_message/get_messages). Returns null if not found. Includes `humansFile` — the path to this person's humans/v1 relationship file if one exists (read it for relationship context; init_human scaffolds one otherwise).",
+    description: "Fetch a single contact by handle (phone/email) or by numeric id, including each handle's thread slug (for send_message/get_messages) and an `identity` block (canonicalName + E.164-normalized phones + lowercased emails + deduped handles). Returns null if not found. Includes `humansFile` — the path to this person's humans/v1 relationship file if one exists (read it for relationship context; init_human scaffolds one otherwise).",
     annotations: annotations.read,
     inputSchema: {
       type: "object",
@@ -2469,7 +2510,7 @@ const TOOLS = [
   },
   {
     name: "resolve_handle",
-    description: "Resolve a phone number or email to its contact display name. Pass-through if unknown.",
+    description: "Resolve a phone number or email to its contact display name. Pass-through if unknown. Always returns an `identity` block (canonicalName + E.164-normalized phones + lowercased emails + deduped handles) — even for an unknown handle, so you get it in canonical form.",
     annotations: annotations.read,
     inputSchema: {
       type: "object",
@@ -3688,10 +3729,17 @@ ${withThreads.map((t) => `  ${t.handle} → ${t.threadSlug}`).join("\n")}` : "";
     const humansLine = humansHint ? humansHintText(humansHint) : `
 
 _${HUMANS_INIT_HINT}_`;
+    const identity = buildIdentity(
+      contact.displayName,
+      contact.phoneNumbers,
+      contact.emails,
+      defaultCountryFromEnv()
+    );
     return toolText(
       `${sanitizeUserText(contact.displayName)} (id ${contact.id})${phones}${emails}${org}${threadLines}${humansLine}`,
       {
         contact,
+        identity,
         threads,
         humansFile,
         humansGuidance: humansHint?.guidance ?? HUMANS_INIT_HINT
@@ -3749,13 +3797,17 @@ ${lines}${hint}`,
     const selectorHit = resolveContactSelector(handle);
     const effectiveHandle = selectorHit?.handle ?? handle;
     const lookup = this.db.contacts.lookupContact(effectiveHandle);
+    const country = defaultCountryFromEnv();
     if (lookup) {
+      const contact = this.db.contacts.getContact(lookup.contactId);
+      const identity = contact ? buildIdentity(contact.displayName, contact.phoneNumbers, contact.emails, country) : buildIdentityFromHandle(effectiveHandle, lookup.displayName, country);
       return toolText(`${handle} → ${sanitizeUserText(lookup.displayName)}`, {
         handle,
         displayName: lookup.displayName,
         contactId: lookup.contactId,
         label: lookup.label ?? null,
-        resolved: true
+        resolved: true,
+        identity
       });
     }
     return toolText(`No contact for ${handle}.`, {
@@ -3763,7 +3815,8 @@ ${lines}${hint}`,
       displayName: handle,
       contactId: null,
       label: null,
-      resolved: false
+      resolved: false,
+      identity: buildIdentityFromHandle(effectiveHandle, null, country)
     });
   }
   async handleCheckImessageAvailability(args) {