@opencxh/domain 1.81.0 → 1.83.0

package/dist/entities/ai-conversation/index.d.ts

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

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

@@ -0,0 +1,25 @@
+export type AIConversationVisibility = "shared" | "personal";
+/**
+ * A single assistant conversation (thread). Grouped into the tools-panel tabs by
+ * `scopeKey`; messages, runs and thread-continuity key on the conversation id.
+ *
+ * - `shared`   → tied to the scope, visible to everyone who may see that scope
+ *                (e.g. the interaction's team). `ownerUserId` is unset.
+ * - `personal` → private to `ownerUserId`, even within a shared scope.
+ *
+ * The scope-owning app declares whether a scope's anchor conversation is shared.
+ */
+export interface AIConversation {
+    id: string;
+    organizationId: string;
+    /** "workspace:<userId>" | "interaction:<id>" | future kinds like "contact:<id>". */
+    scopeKey: string;
+    visibility: AIConversationVisibility;
+    /** Set when `visibility === "personal"`. */
+    ownerUserId?: string;
+    title: string;
+    /** "auto" = the scope-anchor conversation; "user" = opened via the + button. */
+    origin: "auto" | "user";
+    createdAt: number;
+    updatedAt: number;
+}

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

@@ -10,7 +10,7 @@ export interface AIMessageOutput {
 export interface AIMessage {
     id: string;
     organizationId: string;
-    interactionId: string;
+    conversationId: string;
     sender: "user" | "assistant" | "system";
     timestamp: number;
     input: AIMessageInput;
@@ -27,7 +27,7 @@ export interface AIMessage {
  * systemPrompt/enabledTools from it.
  */
 export interface AIMessageAskPayload {
-    interactionId: string;
+    conversationId: string;
     input: AIMessageInput;
     profileId: string;
     previousExternalId?: string;

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

@@ -15,4 +15,10 @@ export interface AIProfile<T extends Record<string, any> = Record<string, any>>
     predefinedPrompts?: PredefinedPrompt[];
     /** Namespaced tool names this profile may use (default: none enabled). */
     enabledTools?: string[];
+    /**
+     * Whether the acting user's PERSONAL MCP tools (their own per-user connections)
+     * are available on this profile, on top of the admin-curated `enabledTools`.
+     * "off" (default) = strictly the curated set; "allow" = also include personal.
+     */
+    personalTools?: "off" | "allow";
 }

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

@@ -15,6 +15,13 @@ export interface InteractionSearchQuery {
         scheme?: string;
         resource?: string;
     };
+    /**
+     * Free-text term. Matched case-insensitively (substring) in-memory over the
+     * interaction's title, remoteParty/participants (resource + displayName),
+     * tags, ticketId and last-activity snippet — the datastore has no full-text
+     * operator, so `status`/`since` bound the scan first, then this filters.
+     */
+    text?: string;
     status?: string;
     /** Only interactions with activity since this epoch-ms; null = no lower bound. */
     since?: number | null;

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

@@ -1,3 +1,24 @@
+/** How the AI server authenticates to an MCP server. */
+export type McpAuthMode = "header" | "oauth";
+/** Whether an OAuth-authenticated MCP server uses one shared org account or one per user. */
+export type McpOAuthAccountScope = "user" | "org";
+/**
+ * Client-facing OAuth view for an MCP server. Never carries the client secret
+ * or tokens — those live server-side (entity `oauth.client` / ManagedAccount).
+ */
+export interface McpOAuthClientView {
+    scope: McpOAuthAccountScope;
+    /** Requested scopes (optional override of discovered/default scopes). */
+    scopes?: string[];
+    /** OAuth client_id (manual config or Dynamic Client Registration result). Not secret. */
+    clientId?: string;
+    /** True when a manual client secret is stored (masked; never sent raw). */
+    hasClientSecret?: boolean;
+    /** True when an account exists for the relevant scope/user. */
+    connected?: boolean;
+    /** Health of that account: "connected" (usable), or needs re-auth ("expired"/"error"). */
+    status?: "connected" | "expired" | "error";
+}
 /** Configuration for an external MCP (Model Context Protocol) server, per organization. */
 export interface McpServerConfig {
     id: string;
@@ -6,7 +27,64 @@ export interface McpServerConfig {
     /** Only Streamable HTTP transport is supported for server-side connections. */
     transport: "http";
     url: string;
-    /** Optional auth/extra headers sent on connect (e.g. `Authorization`). */
+    /** Optional auth/extra headers sent on connect (e.g. `Authorization`). Header-mode only. */
     headers?: Record<string, string>;
     enabled: boolean;
+    /** How we authenticate to this server. Defaults to "header" for back-compat. */
+    authMode?: McpAuthMode;
+    /** OAuth settings, present when `authMode === "oauth"`. */
+    oauth?: McpOAuthClientView;
+    /**
+     * Owner of this server DEFINITION: absent/null = org-defined (admin-managed),
+     * set = a user's own custom personal server. Governs who may edit/delete it and
+     * where it is visible; orthogonal to `oauth.scope` (which is about credentials).
+     */
+    ownerUserId?: string;
+    /**
+     * Org-defined servers only: users may connect this personally (the "catalog").
+     * Only meaningful together with `oauth.scope === "user"`.
+     */
+    personalConnect?: boolean;
+}
+/**
+ * Write-only OAuth fields accepted by create/update (not part of the read view).
+ * `clientSecret` is masked on read, mirroring the header-secret pattern.
+ */
+export interface McpServerOAuthInput {
+    scope?: McpOAuthAccountScope;
+    scopes?: string[];
+    clientId?: string;
+    clientSecret?: string;
+}
+/**
+ * A curated, platform-maintained connector template shown in the admin "add from
+ * catalog" picker. Selecting one pre-fills the create endpoint (no secrets - these
+ * providers support Dynamic Client Registration). Not persisted; served read-only.
+ */
+export interface McpCatalogEntry {
+    key: string;
+    name: string;
+    description?: string;
+    /** Grouping label for the catalog picker (e.g. "Project management"). */
+    category?: string;
+    iconUrl?: string;
+    docsUrl?: string;
+    url: string;
+    authMode: McpAuthMode;
+    oauth?: {
+        scope?: McpOAuthAccountScope;
+        scopes?: string[];
+    };
+}
+/** Body accepted by the create/update endpoints (write shape, distinct from the read view). */
+export interface McpServerInput {
+    name?: string;
+    url?: string;
+    enabled?: boolean;
+    /** Header-mode secrets; masked values mean "unchanged". */
+    headers?: Record<string, string>;
+    authMode?: McpAuthMode;
+    oauth?: McpServerOAuthInput;
+    /** Org-defined servers: mark as personally connectable (catalog membership). */
+    personalConnect?: boolean;
 }

package/dist/index.cjs

@@ -1 +1 @@
-"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 D=e=>!!e.assignedUserId||!!e.assignedInboxId,f=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 N(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=>C(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 d(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 R(e,t){const n=d(e,t);return Object.entries(n).filter(([,r])=>!r).map(([r])=>r)}function C(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 M(e,t){return t.filter(n=>n.capability.intent===e)}function p(e,t){return t.filter(n=>n.capability.targetSchemes.includes(e))}function b(e,t){return p(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 G="message_window",V="message_templates",y={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="folder_management",H={ok:!1,code:"UNSUPPORTED",message:"Provider does not support this op"},h="installation-id";exports.CommunicationScheme=c;exports.FEATURE_FOLDER_MANAGEMENT=U;exports.INSTALLATION_HEADER=h;exports.InteractionParticipantRole=y;exports.PROVIDER_FEATURE_MESSAGE_TEMPLATES=V;exports.PROVIDER_FEATURE_MESSAGE_WINDOW=G;exports.UNSUPPORTED=H;exports.buildActivityPreview=T;exports.buildChannelIntents=O;exports.defineIntent=m;exports.disabledIntentsFromCapabilities=R;exports.filterByEndpoint=b;exports.filterByIntent=M;exports.filterByTargetScheme=p;exports.getContactEndpoints=g;exports.getShortTitle=L;exports.getUrgencyScore=S;exports.isAssigned=D;exports.isClosed=f;exports.isInteractionUnseen=N;exports.matchContactToIntents=P;exports.resolveAccountCapabilities=d;exports.resolveChannelIntents=u;exports.resolveSignature=_;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 D=e=>!!e.assignedUserId||!!e.assignedInboxId,f=e=>e.status==="closed",S=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,R=(e,t=30)=>e.title?.length<=t?e.title:`${e.title.substring(0,t)}...`;function L(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=>C(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 C(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 M(e,t){return t.filter(n=>n.capability.intent===e)}function d(e,t){return t.filter(n=>n.capability.targetSchemes.includes(e))}function b(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 p=(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))(p||{});const G="message_window",U="message_templates",V={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}),y="folder_management",H="remote_search",h={ok:!1,code:"UNSUPPORTED",message:"Provider does not support this op"},$="installation-id";exports.CommunicationScheme=p;exports.FEATURE_FOLDER_MANAGEMENT=y;exports.FEATURE_REMOTE_SEARCH=H;exports.INSTALLATION_HEADER=$;exports.InteractionParticipantRole=V;exports.PROVIDER_FEATURE_MESSAGE_TEMPLATES=U;exports.PROVIDER_FEATURE_MESSAGE_WINDOW=G;exports.UNSUPPORTED=h;exports.buildActivityPreview=T;exports.buildChannelIntents=O;exports.defineIntent=m;exports.disabledIntentsFromCapabilities=N;exports.filterByEndpoint=b;exports.filterByIntent=M;exports.filterByTargetScheme=d;exports.getContactEndpoints=g;exports.getShortTitle=R;exports.getUrgencyScore=S;exports.isAssigned=D;exports.isClosed=f;exports.isInteractionUnseen=L;exports.matchContactToIntents=P;exports.resolveAccountCapabilities=c;exports.resolveChannelIntents=u;exports.resolveSignature=_;exports.stripHtml=i;

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './entities/kb';
 export * from './entities/topic';
 export * from './entities/ai-account';
 export * from './entities/ai-context';
+export * from './entities/ai-conversation';
 export * from './entities/ai-message';
 export * from './entities/ai-profile';
 export * from './entities/mcp';
@@ -24,6 +25,7 @@ export * from './platform/ai-tools';
 export * from './platform/api';
 export * from './platform/common';
 export * from './platform/capabilities';
+export * from './platform/context';
 export * from './platform/communication';
 export * from './platform/federated';
 export * from './platform/intents';

package/dist/index.js

@@ -182,15 +182,16 @@ const P = "message_window", V = "message_templates", G = {
   // Voice/conference
   HOST: "host",
   PARTICIPANT: "participant"
-}, H = (e, t) => ({ intent: e, ...t }), $ = "folder_management", y = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, U = "installation-id";
+}, H = (e, t) => ({ intent: e, ...t }), $ = "folder_management", y = "remote_search", U = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, m = "installation-id";
 export {
   I as CommunicationScheme,
   $ as FEATURE_FOLDER_MANAGEMENT,
-  U as INSTALLATION_HEADER,
+  y as FEATURE_REMOTE_SEARCH,
+  m as INSTALLATION_HEADER,
   G as InteractionParticipantRole,
   V as PROVIDER_FEATURE_MESSAGE_TEMPLATES,
   P as PROVIDER_FEATURE_MESSAGE_WINDOW,
-  y as UNSUPPORTED,
+  U as UNSUPPORTED,
   _ as buildActivityPreview,
   C as buildChannelIntents,
   H as defineIntent,

package/dist/platform/api.d.ts

@@ -29,4 +29,6 @@ export interface PaginationMetadata {
     page: number;
     limit: number;
     hasMore?: boolean;
+    /** Set by free-text search when the scan hit its cap and results may be incomplete. */
+    truncated?: boolean;
 }

package/dist/platform/communication.d.ts

@@ -432,6 +432,12 @@ export type ServerOp = {
     kind: "contact.fetch";
     channelId: string;
     externalId: string;
+} | {
+    kind: "mailbox.search";
+    channelId: string;
+    query: string;
+    cursor?: string;
+    limit?: number;
 } | {
     kind: "folder.list";
     channelId: string;
@@ -486,12 +492,31 @@ export interface FolderMessagePage {
     /** Opaque provider-cursor (bv. Graph `@odata.nextLink`). Afwezig = laatste pagina. */
     nextCursor?: string;
 }
+/**
+ * Een zoekbare externe bron (channel) voor de client-fan-out. Retourneerd door
+ * `GET /search/sources`: elke door de user toegankelijke, ingeschakelde channel
+ * waarvan de provider `FEATURE_REMOTE_SEARCH` declareert. De client vuurt per
+ * bron parallel een `POST /search/mailbox` af (non-blocking).
+ */
+export interface MailboxSearchSource {
+    channelId: string;
+    providerId: string;
+    displayName: string;
+}
 /**
  * Well-known `ProviderFeature.name` voor de folder-capability. Een provider die
  * folder.list/messages/import/move ondersteunt zet `{ name: FEATURE_FOLDER_MANAGEMENT, value: true }`
  * in `describe().features`; de client toont dan de Folders-nav voor dat channel.
  */
 export declare const FEATURE_FOLDER_MANAGEMENT = "folder_management";
+/**
+ * Well-known `ProviderFeature.name` voor de remote-search-capability. Een provider
+ * die `mailbox.search` ondersteunt (de externe bron zelf doorzoeken, bv. Outlook
+ * Graph `$search` of IMAP `SEARCH`) zet `{ name: FEATURE_REMOTE_SEARCH, value: true }`
+ * in `describe().features`. De comm-server neemt de channels van zo'n provider mee
+ * in `GET /search/sources`; de client fan-out er parallel op via `POST /search/mailbox`.
+ */
+export declare const FEATURE_REMOTE_SEARCH = "remote_search";
 /**
  * Result-shape voor `IProvider.dispatch` en de comm-server `dispatchToProvider`-
  * helper. Discriminated op `ok`. Bewust niet strict-null-discriminated zodat

package/dist/platform/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Host context resolved for the tools-panel. Any app can contribute one via the
+ * `context.collect` service; the shell picks the highest-priority non-null claim
+ * for the current route and falls back to `{ kind: "global", scopeKey:
+ * "workspace:<userId>" }` when no app claims it.
+ *
+ * `kind` drives tool visibility (`ExtensionConfig.contexts`); `scopeKey` groups
+ * the assistant's conversations; `shared` marks the scope's anchor conversation
+ * as team-shared.
+ */
+export interface HostContext {
+    kind: string;
+    scopeKey: string;
+    /** The scope's anchor conversation is shared with everyone who may see the scope. */
+    shared?: boolean;
+    /** Default title for the anchor conversation. */
+    title?: string;
+    /** Highest wins when multiple apps claim the same route. */
+    priority?: number;
+    /** Extra data providers attach (e.g. interaction, activities, transcripts). */
+    slices?: Record<string, unknown>;
+}

package/dist/platform/ui.d.ts

@@ -57,7 +57,11 @@ export interface ToastConfig {
         variant?: 'primary' | 'secondary';
     }[];
 }
-export type ExtensionContext = 'global' | 'call' | 'interaction';
+/**
+ * Well-known context kinds, kept for autocomplete; any app may declare its own
+ * kind (e.g. "contact") via a context provider, so the type stays open.
+ */
+export type ExtensionContext = 'global' | 'call' | 'interaction' | (string & {});
 export interface ExtensionConfig {
     id: string;
     slot: string;

package/package.json

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