@xuda.io/ai_module 1.1.5640 → 1.1.5641

package/index.mjs

@@ -308,6 +308,30 @@ const { init, check, check_structure, get_zod_schema, get_fields_z_schema } = aw
 const { get_xuda_couch } = _common;
 
 const db_module = await import(`${module_path}/db_module/index.mjs`);
+
+// Sort keys for the dashboard list tabs, per docType. Each entry is a fallback
+// chain (first defined value wins) because the doc shapes differ: a chat has
+// its own title + date_created_ts, a studio doc carries the name under
+// properties.menuName and may only have ts. See
+// db_module.find_app_couch_sorted_page.
+// `shared` points at the owner's copy: an app/agent shared with you, or bought
+// from the marketplace, is stored locally as a stub with no menuName, so a name
+// sort has to read the source doc. Same two pointers the enrichment follows
+// (get_ai_agents/get_apps: shared_from_app_id + share_item_id, then
+// installed_from_app_id keyed by the doc's own _id).
+const LIST_SORT_PATHS = {
+  chat: { created: ['date_created_ts', 'date_created', 'ts'], updated: ['ts', 'date_created_ts'], name: ['title'] },
+  studio: {
+    created: ['date_created_ts', 'date_created', 'ts'],
+    updated: ['ts', 'date_created_ts'],
+    name: ['properties.menuName', 'studio_meta.name'],
+    shared: [
+      { app_id: 'studio_meta.shared_from_app_id', doc_id: 'studio_meta.share_item_id' },
+      { app_id: 'studio_meta.installed_from_app_id', doc_id: '_id' },
+    ],
+  },
+};
+
 const account_ms = await import(`${module_path}/account_module/index_ms.mjs`);
 const drive_ms = await import(`${module_path}/drive_module/index_ms.mjs`);
 const jobs_ms = await import(`${module_path}/jobs_module/index_ms.mjs`);
@@ -2073,6 +2097,14 @@ export const get_ai_chats = async function (req, job_id, headers) {
         };
       }
 
+      // User-picked order from the dashboard list controls (sort_by date |
+      // updated | name, sort_dir asc | desc). Null when none was asked for,
+      // which leaves the default newest-first path below untouched. Only the
+      // top-level chat list is sortable: with a reference_id these are the
+      // items INSIDE one conversation, which must stay in thread order.
+      const sorted = reference_id || conversation_id ? null : await db_module.find_app_couch_sorted_page(account_profile_info.app_id, opt, req, LIST_SORT_PATHS.chat);
+      if (sorted) return sorted;
+
       let ai_chats = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
       if (!limit || conversation_id) {
         ai_chats.total_docs = ai_chats.docs.length;
@@ -2243,9 +2275,19 @@ export const get_ai_chats = async function (req, job_id, headers) {
       doc.notifications = contact_chat_conversation_count_ret[doc._id] - contact_chat_conversation_read_ret[doc._id];
       doc.chats = doc.interactions;
 
-      doc.user_contact = await get_user_card({ uid, uid_query: doc.uid });
+      // Who WROTE this row. A contact/profile timeline comes back from
+      // get_data_view_conversation_items as a composite { conversation, conversation_item }
+      // that carries no uid of its own, so `doc.uid` was undefined here. get_user_card then
+      // built a selector with contact_uid dropped (JSON.stringify strips undefined) and
+      // matched ANY contact, which is why every note on a contact page was bylined with the
+      // first contact in the book, the person the note is ABOUT, instead of its author.
+      const author_uid = doc.uid || doc.conversation_item?.uid || doc.conversation?.initiator_uid || doc.conversation?.uid;
 
-      doc.privilege = doc.uid === uid || doc?.account_profile_info?.uid === uid;
+      if (author_uid) {
+        doc.user_contact = await get_user_card({ uid, uid_query: author_uid });
+      }
+
+      doc.privilege = author_uid === uid || doc?.account_profile_info?.uid === uid;
 
       if (reference_id && doc.reference_type === 'contact') {
         // only valid for contacts conversation
@@ -2254,6 +2296,17 @@ export const get_ai_chats = async function (req, job_id, headers) {
       docs.push(doc);
     }
 
+    // Calls and SMS belong on the contact's timeline next to the notes rather than behind
+    // their own tabs, so merge them in and order the whole thing by time. Only for a real
+    // contact timeline: the account-wide lists have their own screens.
+    if (reference_id && reference_type === 'contacts') {
+      const voice_rows = await _tl_voice_rows(uid, account_profile_info, reference_id, docs[0]?.user_contact || null);
+      if (voice_rows.length) {
+        const row_ts = (r) => Number(r?.conversation_item?.date_created_ts || r?.conversation?.date_created_ts || r?.date_created_ts || 0);
+        docs = [...docs, ...voice_rows].sort((a, b) => row_ts(a) - row_ts(b));
+      }
+    }
+
     return { code: 2, data: { docs: [...requests_from.docs, ...docs], total_docs: ai_chats.total_docs + requests_from.total_docs } };
   } catch (err) {
     return { code: -2, data: err.message };
@@ -2974,17 +3027,24 @@ export const get_ai_agents = async function (req, job_id, headers) {
 
     let user_agents = { docs: [], total_docs: 0 };
     if (filter_type !== 'pending') {
-      user_agents = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
-      if (!limit || agent_id) {
-        user_agents.total_docs = user_agents.docs.length;
+      // User-picked order from the dashboard list controls, see
+      // db_module.find_app_couch_sorted_page. Null when none was asked for.
+      const sorted = agent_id ? null : await db_module.find_app_couch_sorted_page(account_profile_info.app_id, opt, req, LIST_SORT_PATHS.studio);
+      if (sorted) {
+        user_agents = sorted;
       } else {
-        delete opt.sort;
-        delete opt.skip;
-        opt.limit = 9999;
-        opt.fields = ['_id'];
+        user_agents = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
+        if (!limit || agent_id) {
+          user_agents.total_docs = user_agents.docs.length;
+        } else {
+          delete opt.sort;
+          delete opt.skip;
+          opt.limit = 9999;
+          opt.fields = ['_id'];
 
-        const counter = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
-        user_agents.total_docs = counter.docs.length;
+          const counter = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
+          user_agents.total_docs = counter.docs.length;
+        }
       }
     }
 
@@ -3460,17 +3520,25 @@ export const get_apps = async function (req, job_id, headers) {
 
     let user_apps = { docs: [], total_docs: 0 };
     if (filter_type !== 'pending') {
-      user_apps = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
-      if (!limit || mini_app_id) {
-        user_apps.total_docs = user_apps.docs.length;
+      // User-picked order from the dashboard list controls, see
+      // db_module.find_app_couch_sorted_page. Null when none was asked for,
+      // which leaves the default newest-first path below untouched.
+      const sorted = mini_app_id ? null : await db_module.find_app_couch_sorted_page(account_profile_info.app_id, opt, req, LIST_SORT_PATHS.studio);
+      if (sorted) {
+        user_apps = sorted;
       } else {
-        delete opt.sort;
-        delete opt.skip;
-        opt.limit = 9999;
-        opt.fields = ['_id'];
+        user_apps = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
+        if (!limit || mini_app_id) {
+          user_apps.total_docs = user_apps.docs.length;
+        } else {
+          delete opt.sort;
+          delete opt.skip;
+          opt.limit = 9999;
+          opt.fields = ['_id'];
 
-        const counter = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
-        user_apps.total_docs = counter.docs.length;
+          const counter = await db_module.find_app_couch_query(account_profile_info.app_id, opt);
+          user_apps.total_docs = counter.docs.length;
+        }
       }
     }
 
@@ -5143,6 +5211,85 @@ const process_conversation = async function (uid, conversation_id, account_profi
   // }
 };
 
+// --- contact timeline: calls and SMS -----------------------------------------------------
+// Phone activity lives in xuda_master as voice_call / voice_message docs keyed by
+// owner_uid + phone number, NOT by contact, so it can only be tied to a contact by matching
+// numbers. Digits only, comparing the last 10, so a number written +1 561 235 1675 on an
+// account matches +15612351675 on a call. Same rule as voice_module's own caller matching.
+const _tl_digits = (value) => String(value ?? '').replace(/\D+/g, '');
+const _tl_same_phone = (a, b) => {
+  const x = _tl_digits(a);
+  const y = _tl_digits(b);
+  if (!x || !y) return false;
+  if (x === y) return true;
+  const n = Math.min(10, x.length, y.length);
+  return n >= 7 && x.slice(-n) === y.slice(-n);
+};
+
+// Every number this contact can be reached on. A contact linked to a Xuda user carries no
+// phone on its own doc at all: it lives on their account, which is why matching only the
+// contact doc finds nothing for exactly the contacts that matter most.
+const _tl_contact_phones = async function (app_id, contact_id) {
+  const out = [];
+  let contact = null;
+  try {
+    contact = await db_module.get_app_couch_doc_native(app_id, contact_id);
+    for (const f of ['phone_e164', 'phone', 'telephone', 'phone_number', 'mobile', 'tel']) {
+      if (contact?.[f]) out.push(contact[f]);
+    }
+    if (contact?.contact_uid) {
+      const ret = await db_module.get_couch_doc('xuda_accounts', contact.contact_uid);
+      const info = ret?.code >= 0 ? ret.data?.account_info || {} : {};
+      if (info.phone_number) out.push(info.phone_number);
+      if (info.tel) out.push(info.tel);
+    }
+  } catch (_) { /* no phone is a normal contact, not an error */ }
+  return { phones: out.filter(Boolean), contact };
+};
+
+// Calls and SMS as timeline rows, in the same composite shape the note and email rows use
+// ({ conversation, conversation_item, user_contact }) so the timeline renders them by
+// conversation_type without a second code path.
+const _tl_voice_rows = async function (uid, account_profile_info, contact_id, user_contact) {
+  try {
+    const { phones, contact } = await _tl_contact_phones(account_profile_info.app_id, contact_id);
+    if (!phones.length) return [];
+    const peer = (d) => (d.direction === 'inbound' ? d.from : d.to);
+    // Byline the party who did the thing: an inbound call or SMS came FROM the contact, an
+    // outbound one went out under this account. Bylining every call with the account name
+    // read as if the business had called itself.
+    const card_for = (d) => (d.direction === 'inbound' ? contact || user_contact : user_contact);
+    const [calls, messages] = await Promise.all([
+      db_module.find_couch_query('xuda_master', { selector: { docType: 'voice_call', owner_uid: uid }, limit: 500 }, false, true),
+      db_module.find_couch_query('xuda_master', { selector: { docType: 'voice_message', owner_uid: uid }, limit: 500 }, false, true),
+    ]);
+    const mine = (d) => phones.some((p) => _tl_same_phone(p, peer(d)));
+    const row = (type, doc, text, extra) => ({
+      conversation: { _id: doc._id, docType: 'chat_conversation', conversation_type: type, reference_type: 'contacts', reference_id: contact_id, uid, prompt: text, title: text, date_created_ts: doc.created_ts, ts: doc.created_ts, stat: 3 },
+      conversation_item: { _id: doc._id, docType: 'chat_conversation_item', conversation_type: type, type, text, direction: doc.direction, date_created_ts: doc.created_ts, ts: doc.created_ts, stat: 3, uid },
+      user_contact: card_for(doc),
+      voice: { kind: type, ...extra },
+      privilege: true,
+    });
+
+    const call_rows = (calls?.docs || []).filter((d) => d.status !== 'ringing' && mine(d)).map((d) =>
+      row('call', d, d.direction === 'inbound' ? 'Incoming call' : 'Outgoing call', {
+        status: d.status,
+        duration_sec: d.duration_sec || 0,
+        has_recording: !!d.recording,
+        transcript_turns: (d.transcript || []).length,
+        handled_by: d.handled_by || '',
+      }),
+    );
+    const sms_rows = (messages?.docs || []).filter(mine).map((d) => row('sms', d, d.body || '', { status: d.status, segments: d.segments || 1 }));
+    return [...call_rows, ...sms_rows];
+  } catch (err) {
+    // A phone lookup must never take the whole timeline down with it.
+    console.error('[ai_module] contact voice timeline rows failed:', err.message);
+    return [];
+  }
+};
+
 const contactGuardrailAgent = new Agent({
   name: 'Person Guardrail check',
   instructions: 'Check if the prompt about person.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xuda.io/ai_module",
-  "version": "1.1.5640",
+  "version": "1.1.5641",
   "description": "Xuda AI Module",
   "main": "index.mjs",
   "type": "module",