@opencxh/domain 1.52.0 → 1.54.0

package/dist/entities/ai-message/types.d.ts

@@ -1,3 +1,4 @@
+import { ToolTraceEntry } from '../../platform/ai-tools';
 export interface AIMessageInput {
     text: string;
     type: "text";
@@ -17,16 +18,19 @@ export interface AIMessage {
     accountId?: string;
     model?: string;
     externalId?: string;
+    /** Tools the assistant invoked while producing this message (final, persisted trace). */
+    toolTrace?: ToolTraceEntry[];
 }
+/**
+ * Profile-driven ask payload. The selected profile is the source of truth, so
+ * the client sends only `profileId`; the server resolves account/model/
+ * systemPrompt/enabledTools from it.
+ */
 export interface AIMessageAskPayload {
     interactionId: string;
     input: AIMessageInput;
-    model: string;
-    accountId: string;
+    profileId: string;
     previousExternalId?: string;
-    providerConfig?: Record<string, any>;
-    instructions?: string;
-    systemPrompt?: string;
     context?: Record<string, any>;
 }
 export interface AIMessageAskResponse {

package/dist/entities/ai-profile/types.d.ts

@@ -13,4 +13,6 @@ export interface AIProfile<T extends Record<string, any> = Record<string, any>>
     systemPrompt: string;
     contextIds?: string[];
     predefinedPrompts?: PredefinedPrompt[];
+    /** Namespaced tool names this profile may use (default: none enabled). */
+    enabledTools?: string[];
 }

package/dist/entities/interaction/types.d.ts

@@ -8,6 +8,19 @@ export interface ActivityPreview {
     direction: "inbound" | "outbound" | "internal" | "none";
     createdAt: number;
 }
+/** Query for the interaction search endpoint (POST /search/interaction). */
+export interface InteractionSearchQuery {
+    /** Match the counterparty subdocument (exact). */
+    remoteParty?: {
+        scheme?: string;
+        resource?: string;
+    };
+    status?: string;
+    /** Only interactions with activity since this epoch-ms; null = no lower bound. */
+    since?: number | null;
+    page?: number;
+    limit?: number;
+}
 export interface InteractionSource {
     activityId?: string;
     activityType?: string;

package/dist/entities/mcp/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/dist/entities/mcp/types.d.ts

@@ -0,0 +1,12 @@
+/** Configuration for an external MCP (Model Context Protocol) server, per organization. */
+export interface McpServerConfig {
+    id: string;
+    organizationId: string;
+    name: string;
+    /** Only Streamable HTTP transport is supported for server-side connections. */
+    transport: "http";
+    url: string;
+    /** Optional auth/extra headers sent on connect (e.g. `Authorization`). */
+    headers?: Record<string, string>;
+    enabled: boolean;
+}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=140;function i(e){return e.replace(/<style[\s\S]*?<\/style>/gi," ").replace(/<script[\s\S]*?<\/script>/gi," ").replace(/<[^>]+>/g," ").replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'").replace(/\s+/g," ").trim()}function I(e){const t=e.trim();return t.length<=E?t:t.slice(0,E-1).trimEnd()+"…"}function l(e){if(!e||e<0)return"";const t=Math.floor(e/60),n=Math.floor(e%60);return`${t}:${n.toString().padStart(2,"0")}`}function A(e){switch(e.type){case"EMAIL_RECEIVED":case"EMAIL_SENT":{const t=e.payload,n=t.bodySnippet?.trim()||i(t.body??"");return t.subject?`${t.subject} — ${n}`:n}case"CHAT_MESSAGE_SENT":case"CHAT_MESSAGE_RECEIVED":return e.payload.text??"";case"CHAT_RENAMED":return`Hernoemd naar "${e.payload.newName}"`;case"CHAT_MEMBER_JOINED":return`${e.payload.members.map(t=>t.name).join(", ")} toegevoegd`;case"CHAT_MEMBER_LEFT":return`${e.payload.members.map(t=>t.name).join(", ")} verlaten`;case"CHAT_CALL_STARTED":return"Gesprek gestart";case"CHAT_CALL_ENDED":return`Gesprek beëindigd${e.payload.duration?` (${l(e.payload.duration)})`:""}`;case"CHAT_EVENT":return e.payload.text??e.payload.eventType;case"VOICE_CALL_STARTED":case"VIDEO_CALL_STARTED":return"Gesprek gestart";case"VOICE_CALL_ANSWERED":case"VIDEO_CALL_ANSWERED":return"Gesprek aangenomen";case"VOICE_CALL_HOLD":case"VIDEO_CALL_HOLD":return"In de wacht";case"VOICE_CALL_UNHOLD":case"VIDEO_CALL_UNHOLD":return"Hervat";case"VOICE_CALL_ENDED":case"VIDEO_CALL_ENDED":return`Gesprek beëindigd${e.payload.duration?` (${l(e.payload.duration)})`:""}`;case"VOICE_CALL_MISSED":case"VIDEO_CALL_MISSED":return"Gemiste oproep";case"VOICE_CALL_FAILED":case"VIDEO_CALL_FAILED":return"Gesprek mislukt";case"VOICE_CALL_VOICEMAIL":return e.payload.transcription?.trim()?e.payload.transcription:"Voicemail ontvangen";case"TRANSCRIPT_ADDED":return(e.payload.segments??[]).map(t=>t.text).join(" ");case"AI_MESSAGE_ADDED":return e.payload.output?.text??e.payload.input?.text??"";case"MEETING_SCHEDULED":return`Vergadering gepland: ${e.payload.title}`;case"MEETING_STARTED":return`Vergadering gestart: ${e.payload.title}`;case"MEETING_ENDED":return`Vergadering beëindigd${e.payload.duration?` (${l(e.payload.duration)})`:""}`;case"MEETING_PARTICIPANT_JOINED":return`${e.payload.name} deelgenomen`;case"MEETING_PARTICIPANT_LEFT":return`${e.payload.name} verlaten`;case"COMMENT_ADDED":return e.payload.text??"";case"FILE_UPLOADED":return`Bestand: ${e.payload.fileName}`;case"INTERACTION_CREATED":return"Interactie aangemaakt";case"INTERACTION_STATUS_CHANGED":return`Status: ${e.payload.fromStatus} → ${e.payload.toStatus}`;case"INTERACTION_ASSIGNED":return"Interactie toegewezen";default:return""}}function T(e){return{activityId:e.id,type:e.type,snippet:I(A(e)),authorName:e.author?.name??"",direction:e.direction,createdAt:e.createdAt??Date.now()}}function g(e,t){const n=e.settings?.signatures?.[t];return!n||!n.enabled||!n.body||n.body.trim()===""?null:n}function f(e){return e.endpoints??[]}const _=e=>!!e.assignedUserId||!!e.assignedInboxId,D=e=>e.status==="closed",L=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,C=(e,t=30)=>e.title?.length<=t?e.title:`${e.title.substring(0,t)}...`;function S(e,t){return e.lastActivityAt?!(e.seenBy??[]).includes(t):!1}function u(e,t){const n=new Set(e.disabledIntents??[]),r=e.intentOverrides??{},s=t.intents.filter(a=>!n.has(a.intent)).map(a=>O(a,r[a.intent]));if(!e.extraIntents||e.extraIntents.length===0)return s;const o=new Set(s.map(a=>a.intent));for(const a of e.extraIntents)o.has(a.intent)||(s.push(a),o.add(a.intent));return s}function c(e,t){const n={};for(const r of e.intents){if(!r.togglable)continue;const s=t?.[r.intent];n[r.intent]=s??r.defaultEnabled??!0}return n}function N(e,t){const n=c(e,t);return Object.entries(n).filter(([,r])=>!r).map(([r])=>r)}function O(e,t){return t?{intent:t.intent??e.intent,targetSchemes:t.targetSchemes??e.targetSchemes,transport:t.transport??e.transport}:e}function b(e,t){const n=[];for(const r of e){if(!r.enabled)continue;const s=t[r.providerId];if(s)for(const o of u(r,s))n.push({channel:r,description:s,capability:o})}return n}function R(e,t){return t.filter(n=>n.capability.intent===e)}function p(e,t){return t.filter(n=>n.capability.targetSchemes.includes(e))}function M(e,t){return p(e.scheme,t)}function y(e,t,n){const r=[];for(const s of e)for(const o of n)o.capability.intent===t&&o.capability.targetSchemes.includes(s.scheme)&&r.push({channelIntent:o,endpoint:s});return r}var d=(e=>(e.MAILTO="mailto",e.SIP="sip",e.TEL="tel",e.WEBHOOK="webhook",e.USERNAME="username",e.ID="id",e.CUSTOM="custom",e.URL="url",e.TELEGRAM="telegram",e.WHATSAPP="whatsapp",e.VIBER="viber",e.SMS="sms",e.FAX="fax",e.TEAMS="teams",e.CALENDAR="calendar",e))(d||{});const P={FROM:"from",TO:"to",CC:"cc",BCC:"bcc",ORGANIZER:"organizer",PRESENTER:"presenter",ATTENDEE:"attendee",OWNER:"owner",MEMBER:"member",GUEST:"guest",HOST:"host",PARTICIPANT:"participant"},m=(e,t)=>({intent:e,...t}),V={ok:!1,code:"UNSUPPORTED",message:"Provider does not support this op"},h="installation-id";exports.CommunicationScheme=d;exports.INSTALLATION_HEADER=h;exports.InteractionParticipantRole=P;exports.UNSUPPORTED=V;exports.buildActivityPreview=T;exports.buildChannelIntents=b;exports.defineIntent=m;exports.disabledIntentsFromCapabilities=N;exports.filterByEndpoint=M;exports.filterByIntent=R;exports.filterByTargetScheme=p;exports.getContactEndpoints=f;exports.getShortTitle=C;exports.getUrgencyScore=L;exports.isAssigned=_;exports.isClosed=D;exports.isInteractionUnseen=S;exports.matchContactToIntents=y;exports.resolveAccountCapabilities=c;exports.resolveChannelIntents=u;exports.resolveSignature=g;exports.stripHtml=i;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=140;function i(e){return e.replace(/<style[\s\S]*?<\/style>/gi," ").replace(/<script[\s\S]*?<\/script>/gi," ").replace(/<[^>]+>/g," ").replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'").replace(/\s+/g," ").trim()}function A(e){const t=e.trim();return t.length<=l?t:t.slice(0,l-1).trimEnd()+"…"}function E(e){if(!e||e<0)return"";const t=Math.floor(e/60),n=Math.floor(e%60);return`${t}:${n.toString().padStart(2,"0")}`}function I(e){switch(e.type){case"EMAIL_RECEIVED":case"EMAIL_SENT":{const t=e.payload,n=t.bodySnippet?.trim()||i(t.body??"");return t.subject?`${t.subject} — ${n}`:n}case"CHAT_MESSAGE_SENT":case"CHAT_MESSAGE_RECEIVED":return e.payload.text??"";case"CHAT_RENAMED":return`Hernoemd naar "${e.payload.newName}"`;case"CHAT_MEMBER_JOINED":return`${e.payload.members.map(t=>t.name).join(", ")} toegevoegd`;case"CHAT_MEMBER_LEFT":return`${e.payload.members.map(t=>t.name).join(", ")} verlaten`;case"CHAT_CALL_STARTED":return"Gesprek gestart";case"CHAT_CALL_ENDED":return`Gesprek beëindigd${e.payload.duration?` (${E(e.payload.duration)})`:""}`;case"CHAT_EVENT":return e.payload.text??e.payload.eventType;case"VOICE_CALL_STARTED":case"VIDEO_CALL_STARTED":return"Gesprek gestart";case"VOICE_CALL_ANSWERED":case"VIDEO_CALL_ANSWERED":return"Gesprek aangenomen";case"VOICE_CALL_HOLD":case"VIDEO_CALL_HOLD":return"In de wacht";case"VOICE_CALL_UNHOLD":case"VIDEO_CALL_UNHOLD":return"Hervat";case"VOICE_CALL_ENDED":case"VIDEO_CALL_ENDED":return`Gesprek beëindigd${e.payload.duration?` (${E(e.payload.duration)})`:""}`;case"VOICE_CALL_MISSED":case"VIDEO_CALL_MISSED":return"Gemiste oproep";case"VOICE_CALL_FAILED":case"VIDEO_CALL_FAILED":return"Gesprek mislukt";case"VOICE_CALL_VOICEMAIL":return e.payload.transcription?.trim()?e.payload.transcription:"Voicemail ontvangen";case"TRANSCRIPT_ADDED":return(e.payload.segments??[]).map(t=>t.text).join(" ");case"AI_MESSAGE_ADDED":return e.payload.output?.text??e.payload.input?.text??"";case"MEETING_SCHEDULED":return`Vergadering gepland: ${e.payload.title}`;case"MEETING_STARTED":return`Vergadering gestart: ${e.payload.title}`;case"MEETING_ENDED":return`Vergadering beëindigd${e.payload.duration?` (${E(e.payload.duration)})`:""}`;case"MEETING_PARTICIPANT_JOINED":return`${e.payload.name} deelgenomen`;case"MEETING_PARTICIPANT_LEFT":return`${e.payload.name} verlaten`;case"COMMENT_ADDED":return e.payload.text??"";case"FILE_UPLOADED":return`Bestand: ${e.payload.fileName}`;case"INTERACTION_CREATED":return"Interactie aangemaakt";case"INTERACTION_STATUS_CHANGED":return`Status: ${e.payload.fromStatus} → ${e.payload.toStatus}`;case"INTERACTION_ASSIGNED":return"Interactie toegewezen";default:return""}}function T(e){return{activityId:e.id,type:e.type,snippet:A(I(e)),authorName:e.author?.name??"",direction:e.direction,createdAt:e.createdAt??Date.now()}}function _(e,t){const n=e.settings?.signatures?.[t];return!n||!n.enabled||!n.body||n.body.trim()===""?null:n}function g(e){return e.endpoints??[]}const f=e=>!!e.assignedUserId||!!e.assignedInboxId,D=e=>e.status==="closed",S=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,L=(e,t=30)=>e.title?.length<=t?e.title:`${e.title.substring(0,t)}...`;function C(e,t){return e.lastActivityAt?!(e.seenBy??[]).includes(t):!1}function u(e,t){const n=new Set(e.disabledIntents??[]),r=e.intentOverrides??{},s=t.intents.filter(a=>!n.has(a.intent)).map(a=>R(a,r[a.intent]));if(!e.extraIntents||e.extraIntents.length===0)return s;const o=new Set(s.map(a=>a.intent));for(const a of e.extraIntents)o.has(a.intent)||(s.push(a),o.add(a.intent));return s}function p(e,t){const n={};for(const r of e.intents){if(!r.togglable)continue;const s=t?.[r.intent];n[r.intent]=s??r.defaultEnabled??!0}return n}function N(e,t){const n=p(e,t);return Object.entries(n).filter(([,r])=>!r).map(([r])=>r)}function R(e,t){return t?{intent:t.intent??e.intent,targetSchemes:t.targetSchemes??e.targetSchemes,transport:t.transport??e.transport}:e}function O(e,t){const n=[];for(const r of e){if(!r.enabled)continue;const s=t[r.providerId];if(s)for(const o of u(r,s))n.push({channel:r,description:s,capability:o})}return n}function b(e,t){return t.filter(n=>n.capability.intent===e)}function d(e,t){return t.filter(n=>n.capability.targetSchemes.includes(e))}function M(e,t){return d(e.scheme,t)}function P(e,t,n){const r=[];for(const s of e)for(const o of n)o.capability.intent===t&&o.capability.targetSchemes.includes(s.scheme)&&r.push({channelIntent:o,endpoint:s});return r}var c=(e=>(e.MAILTO="mailto",e.SIP="sip",e.TEL="tel",e.WEBHOOK="webhook",e.USERNAME="username",e.ID="id",e.CUSTOM="custom",e.URL="url",e.TELEGRAM="telegram",e.WHATSAPP="whatsapp",e.MESSENGER="messenger",e.INSTAGRAM="instagram",e.VIBER="viber",e.SMS="sms",e.FAX="fax",e.TEAMS="teams",e.CALENDAR="calendar",e))(c||{});const V="message_window",y="message_templates",G={FROM:"from",TO:"to",CC:"cc",BCC:"bcc",ORGANIZER:"organizer",PRESENTER:"presenter",ATTENDEE:"attendee",OWNER:"owner",MEMBER:"member",GUEST:"guest",HOST:"host",PARTICIPANT:"participant"},m=(e,t)=>({intent:e,...t}),U={ok:!1,code:"UNSUPPORTED",message:"Provider does not support this op"},H="installation-id";exports.CommunicationScheme=c;exports.INSTALLATION_HEADER=H;exports.InteractionParticipantRole=G;exports.PROVIDER_FEATURE_MESSAGE_TEMPLATES=y;exports.PROVIDER_FEATURE_MESSAGE_WINDOW=V;exports.UNSUPPORTED=U;exports.buildActivityPreview=T;exports.buildChannelIntents=O;exports.defineIntent=m;exports.disabledIntentsFromCapabilities=N;exports.filterByEndpoint=M;exports.filterByIntent=b;exports.filterByTargetScheme=d;exports.getContactEndpoints=g;exports.getShortTitle=L;exports.getUrgencyScore=S;exports.isAssigned=f;exports.isClosed=D;exports.isInteractionUnseen=C;exports.matchContactToIntents=P;exports.resolveAccountCapabilities=p;exports.resolveChannelIntents=u;exports.resolveSignature=_;exports.stripHtml=i;

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './entities/ai-account';
 export * from './entities/ai-context';
 export * from './entities/ai-message';
 export * from './entities/ai-profile';
+export * from './entities/mcp';
 export * from './entities/channel';
 export * from './entities/communication';
 export * from './entities/contact';
@@ -18,6 +19,7 @@ export * from './entities/organization';
 export * from './entities/shopify';
 export * from './entities/transcript';
 export * from './entities/user';
+export * from './platform/ai-tools';
 export * from './platform/api';
 export * from './platform/common';
 export * from './platform/capabilities';

package/dist/index.js

@@ -1,7 +1,7 @@
-function u(e) {
+function l(e) {
   return e.replace(/<style[\s\S]*?<\/style>/gi, " ").replace(/<script[\s\S]*?<\/script>/gi, " ").replace(/<[^>]+>/g, " ").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/\s+/g, " ").trim();
 }
-function l(e) {
+function u(e) {
   const t = e.trim();
   return t.length <= 140 ? t : t.slice(0, 139).trimEnd() + "…";
 }
@@ -14,7 +14,7 @@ function p(e) {
   switch (e.type) {
     case "EMAIL_RECEIVED":
     case "EMAIL_SENT": {
-      const t = e.payload, n = t.bodySnippet?.trim() || u(t.body ?? "");
+      const t = e.payload, n = t.bodySnippet?.trim() || l(t.body ?? "");
       return t.subject ? `${t.subject} — ${n}` : n;
     }
     case "CHAT_MESSAGE_SENT":
@@ -83,17 +83,17 @@ function p(e) {
       return "";
   }
 }
-function T(e) {
+function _(e) {
   return {
     activityId: e.id,
     type: e.type,
-    snippet: l(p(e)),
+    snippet: u(p(e)),
     authorName: e.author?.name ?? "",
     direction: e.direction,
     createdAt: e.createdAt ?? Date.now()
   };
 }
-function _(e, t) {
+function T(e, t) {
   const n = e.settings?.signatures?.[t];
   return !n || !n.enabled || !n.body || n.body.trim() === "" ? null : n;
 }
@@ -106,11 +106,11 @@ const f = (e) => !!e.assignedUserId || !!e.assignedInboxId, D = (e) => e.status
   normal: 2,
   low: 1
 })[e.priority] || 0, N = (e, t = 30) => e.title?.length <= t ? e.title : `${e.title.substring(0, t)}...`;
-function C(e, t) {
+function S(e, t) {
   return e.lastActivityAt ? !(e.seenBy ?? []).includes(t) : !1;
 }
 function d(e, t) {
-  const n = new Set(e.disabledIntents ?? []), r = e.intentOverrides ?? {}, s = t.intents.filter((a) => !n.has(a.intent)).map((a) => i(a, r[a.intent]));
+  const n = new Set(e.disabledIntents ?? []), r = e.intentOverrides ?? {}, s = t.intents.filter((a) => !n.has(a.intent)).map((a) => A(a, r[a.intent]));
   if (!e.extraIntents || e.extraIntents.length === 0) return s;
   const o = new Set(s.map((a) => a.intent));
   for (const a of e.extraIntents)
@@ -126,11 +126,11 @@ function c(e, t) {
   }
   return n;
 }
-function S(e, t) {
+function C(e, t) {
   const n = c(e, t);
   return Object.entries(n).filter(([, r]) => !r).map(([r]) => r);
 }
-function i(e, t) {
+function A(e, t) {
   return t ? {
     intent: t.intent ?? e.intent,
     targetSchemes: t.targetSchemes ?? e.targetSchemes,
@@ -151,21 +151,21 @@ function O(e, t) {
 function R(e, t) {
   return t.filter((n) => n.capability.intent === e);
 }
-function A(e, t) {
+function i(e, t) {
   return t.filter((n) => n.capability.targetSchemes.includes(e));
 }
-function b(e, t) {
-  return A(e.scheme, t);
+function M(e, t) {
+  return i(e.scheme, t);
 }
-function M(e, t, n) {
+function b(e, t, n) {
   const r = [];
   for (const s of e)
     for (const o of n)
       o.capability.intent === t && o.capability.targetSchemes.includes(s.scheme) && r.push({ channelIntent: o, endpoint: s });
   return r;
 }
-var I = /* @__PURE__ */ ((e) => (e.MAILTO = "mailto", e.SIP = "sip", e.TEL = "tel", e.WEBHOOK = "webhook", e.USERNAME = "username", e.ID = "id", e.CUSTOM = "custom", e.URL = "url", e.TELEGRAM = "telegram", e.WHATSAPP = "whatsapp", e.VIBER = "viber", e.SMS = "sms", e.FAX = "fax", e.TEAMS = "teams", e.CALENDAR = "calendar", e))(I || {});
-const P = {
+var I = /* @__PURE__ */ ((e) => (e.MAILTO = "mailto", e.SIP = "sip", e.TEL = "tel", e.WEBHOOK = "webhook", e.USERNAME = "username", e.ID = "id", e.CUSTOM = "custom", e.URL = "url", e.TELEGRAM = "telegram", e.WHATSAPP = "whatsapp", e.MESSENGER = "messenger", e.INSTAGRAM = "instagram", e.VIBER = "viber", e.SMS = "sms", e.FAX = "fax", e.TEAMS = "teams", e.CALENDAR = "calendar", e))(I || {});
+const P = "message_window", V = "message_templates", G = {
   // E-mail
   FROM: "from",
   TO: "to",
@@ -182,28 +182,30 @@ const P = {
   // Voice/conference
   HOST: "host",
   PARTICIPANT: "participant"
-}, V = (e, t) => ({ intent: e, ...t }), H = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, $ = "installation-id";
+}, H = (e, t) => ({ intent: e, ...t }), $ = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, y = "installation-id";
 export {
   I as CommunicationScheme,
-  $ as INSTALLATION_HEADER,
-  P as InteractionParticipantRole,
-  H as UNSUPPORTED,
-  T as buildActivityPreview,
+  y as INSTALLATION_HEADER,
+  G as InteractionParticipantRole,
+  V as PROVIDER_FEATURE_MESSAGE_TEMPLATES,
+  P as PROVIDER_FEATURE_MESSAGE_WINDOW,
+  $ as UNSUPPORTED,
+  _ as buildActivityPreview,
   O as buildChannelIntents,
-  V as defineIntent,
-  S as disabledIntentsFromCapabilities,
-  b as filterByEndpoint,
+  H as defineIntent,
+  C as disabledIntentsFromCapabilities,
+  M as filterByEndpoint,
   R as filterByIntent,
-  A as filterByTargetScheme,
+  i as filterByTargetScheme,
   g as getContactEndpoints,
   N as getShortTitle,
   L as getUrgencyScore,
   f as isAssigned,
   D as isClosed,
-  C as isInteractionUnseen,
-  M as matchContactToIntents,
+  S as isInteractionUnseen,
+  b as matchContactToIntents,
   c as resolveAccountCapabilities,
   d as resolveChannelIntents,
-  _ as resolveSignature,
-  u as stripHtml
+  T as resolveSignature,
+  l as stripHtml
 };

package/dist/platform/ai-tools.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Provider-agnostic tool-use contracts for the AI assistant.
+ *
+ * A tool is described once in this neutral shape; each AI provider adapter
+ * translates it to/from its own native function-calling format. Tools can come
+ * from internal apps (via the "ai-tool" provider role) or external MCP servers —
+ * both surface through the same {@link AiTool} shape.
+ */
+/** JSON-Schema object describing a tool's arguments. */
+export interface AiToolParameterSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required?: string[];
+}
+/** A callable tool advertised to the model. */
+export interface AiTool {
+    /** Namespaced, model-facing name, e.g. `kb__kb_search` or `mcp__<server>__<tool>`. */
+    name: string;
+    description: string;
+    parameters: AiToolParameterSchema;
+}
+/** A model's request to call a tool. */
+export interface AiToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** The result of executing a tool call, fed back to the model. */
+export interface AiToolResult {
+    id: string;
+    content: string;
+    isError?: boolean;
+}
+/** Returned by an app's `GET /provider/ai-tools/describe`. */
+export type AiToolDescriptor = AiTool;
+/** One step in the assistant's tool-use trace, persisted on the message. */
+export interface ToolTraceEntry {
+    call: AiToolCall;
+    state: "running" | "done" | "error";
+    result?: AiToolResult;
+}

package/dist/platform/communication.d.ts

@@ -57,6 +57,8 @@ export declare enum CommunicationScheme {
     URL = "url",
     TELEGRAM = "telegram",
     WHATSAPP = "whatsapp",
+    MESSENGER = "messenger",
+    INSTAGRAM = "instagram",
     VIBER = "viber",
     SMS = "sms",
     FAX = "fax",
@@ -141,6 +143,62 @@ export interface ProviderDescription {
     /** Provider feature flags — separate from routing. */
     features: ProviderFeature[];
 }
+/**
+ * Provider-feature names die de composer generiek interpreteert (geen
+ * hardcoding per-provider). Een provider die `message_window` adverteert
+ * heeft een tijdgebonden messaging-venster; `message_templates` betekent dat
+ * er pre-approved templates beschikbaar zijn buiten dat venster.
+ */
+export declare const PROVIDER_FEATURE_MESSAGE_WINDOW = "message_window";
+export declare const PROVIDER_FEATURE_MESSAGE_TEMPLATES = "message_templates";
+/**
+ * Eén variabele in een provider-template (bv. WhatsApp HSM body-param `{{1}}`).
+ */
+export interface ProviderMessageTemplateVariable {
+    /** Stabiele key — voor WhatsApp de 1-based index als string ("1", "2", …). */
+    key: string;
+    /** Optioneel voorbeeld/placeholder uit de provider. */
+    example?: string;
+    label?: string;
+}
+/**
+ * Pre-approved provider-template (WhatsApp HSM). De composer rendert per
+ * `variables` een invoerveld; submit stuurt `templateId` + ingevulde waarden
+ * mee. Los van de user-gemaakte canned-reply {@link MessageTemplate}.
+ */
+export interface ProviderMessageTemplate {
+    id: string;
+    name: string;
+    language?: string;
+    /** Voorbeeld van de samengestelde body (variabelen als placeholders). */
+    bodyPreview?: string;
+    category?: string;
+    variables: ProviderMessageTemplateVariable[];
+}
+/**
+ * Geldige tag waarmee buiten het standaard-venster tóch een vrij-tekst bericht
+ * verstuurd mag worden (Messenger/Instagram message-tags, human-agent-tag).
+ */
+export interface MessageTag {
+    id: string;
+    label: string;
+    description?: string;
+}
+/**
+ * Antwoord van `provider/message-context` (read-route op een dispatch-provider
+ * met `message_window`/`message_templates`-features). Per interaction vertelt
+ * dit de composer of vrij-tekst mag, en zo niet welke templates/tags er zijn.
+ */
+export interface MessageContext {
+    /** Vrij-tekst toegestaan? false ⇒ composer forceert template of tag. */
+    windowOpen: boolean;
+    /** Epoch-ms waarop het venster sluit (indien open en bekend). */
+    windowExpiresAt?: number;
+    /** Beschikbare pre-approved templates (WhatsApp). */
+    templates?: ProviderMessageTemplate[];
+    /** Geldige message-tags (Messenger/Instagram). */
+    tags?: MessageTag[];
+}
 export interface PersonalAuthOption {
     id: string;
     label: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.52.0",
+  "version": "1.54.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",