@opencxh/domain 1.83.0 → 1.85.0

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

@@ -161,6 +161,8 @@ export type FileUploadedPayload = {
     fileUrl: string;
     fileType: string;
     size: number;
+    /** Storage FilePointer id, when the file lives in the storage app (download via storage.file.{id}.download). */
+    fileId?: string;
 };
 export type InteractionStatusChangedPayload = {
     fromStatus: "open" | "pending" | "closed";

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

@@ -1,3 +1,4 @@
+import { OwnerScope } from '../contact/types';
 export interface PredefinedPrompt {
     name: string;
     prompt: string;
@@ -5,6 +6,12 @@ export interface PredefinedPrompt {
 export interface AIProfile<T extends Record<string, any> = Record<string, any>> {
     id: string;
     organizationId: string;
+    /**
+     * Who may use this profile. Company-wide (`org`) or bound to a `team`; profiles
+     * are never personal. Optional only during the migration window - the server
+     * defaults new profiles to `org` and backfills existing ones.
+     */
+    ownerScope?: OwnerScope;
     name: string;
     description?: string;
     accountId: string;

package/dist/entities/contact/provider.d.ts

@@ -4,6 +4,15 @@ export interface ContactSearchQuery {
     text?: string;
     scope?: OwnerScope[];
     limit?: number;
+    /**
+     * Channels whose identities the search should cover. The composer passes the
+     * one acting channel; the intent starter passes every channel the user can
+     * act as. Providers search each identity they own among these and merge —
+     * e.g. Microsoft searches the relevant people of every shared mailbox in the
+     * list. Order matters: providers may cap the fan-out, so pass most-relevant
+     * first.
+     */
+    channelIds?: string[];
 }
 export interface ContactProvider {
     id: string;

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,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;
+"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 o(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?` (${o(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?` (${o(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?` (${o(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 _(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 T(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,S=e=>e.status==="closed",f=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,N=(e,t=30)=>e.title?.length<=t?e.title:`${e.title.substring(0,t)}...`;function R(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 E=new Set(s.map(a=>a.intent));for(const a of e.extraIntents)E.has(a.intent)||(s.push(a),E.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 L(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 C(e,t){const n=[];for(const r of e){if(!r.enabled)continue;const s=t[r.providerId];if(s)for(const E of u(r,s))n.push({channel:r,description:s,capability:E})}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 E of n)E.capability.intent===t&&E.capability.targetSchemes.includes(s.scheme)&&r.push({channelIntent:E,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"},$=9e4,F="installation-id";exports.CommunicationScheme=p;exports.FEATURE_FOLDER_MANAGEMENT=y;exports.FEATURE_REMOTE_SEARCH=H;exports.INSTALLATION_HEADER=F;exports.InteractionParticipantRole=V;exports.PRESENCE_ONLINE_WINDOW_MS=$;exports.PROVIDER_FEATURE_MESSAGE_TEMPLATES=U;exports.PROVIDER_FEATURE_MESSAGE_WINDOW=G;exports.UNSUPPORTED=h;exports.buildActivityPreview=_;exports.buildChannelIntents=C;exports.defineIntent=m;exports.disabledIntentsFromCapabilities=L;exports.filterByEndpoint=b;exports.filterByIntent=M;exports.filterByTargetScheme=d;exports.getContactEndpoints=g;exports.getShortTitle=N;exports.getUrgencyScore=f;exports.isAssigned=D;exports.isClosed=S;exports.isInteractionUnseen=R;exports.matchContactToIntents=P;exports.resolveAccountCapabilities=c;exports.resolveChannelIntents=u;exports.resolveSignature=T;exports.stripHtml=i;

package/dist/index.d.ts

@@ -44,5 +44,6 @@ export * from './platform/ui';
 export * from './platform/media';
 export * from './platform/provider';
 export * from './platform/push';
+export * from './platform/presence';
 export * from './platform/installation';
 export * from './platform/storage';

package/dist/index.js

@@ -100,7 +100,7 @@ function T(e, t) {
 function g(e) {
   return e.endpoints ?? [];
 }
-const f = (e) => !!e.assignedUserId || !!e.assignedInboxId, D = (e) => e.status === "closed", L = (e) => ({
+const D = (e) => !!e.assignedUserId || !!e.assignedInboxId, f = (e) => e.status === "closed", L = (e) => ({
   urgent: 10,
   high: 5,
   normal: 2,
@@ -137,7 +137,7 @@ function A(e, t) {
     transport: t.transport ?? e.transport
   } : e;
 }
-function C(e, t) {
+function O(e, t) {
   const n = [];
   for (const r of e) {
     if (!r.enabled) continue;
@@ -148,7 +148,7 @@ function C(e, t) {
   }
   return n;
 }
-function O(e, t) {
+function C(e, t) {
   return t.filter((n) => n.capability.intent === e);
 }
 function i(e, t) {
@@ -182,28 +182,29 @@ const P = "message_window", V = "message_templates", G = {
   // Voice/conference
   HOST: "host",
   PARTICIPANT: "participant"
-}, 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";
+}, H = (e, t) => ({ intent: e, ...t }), $ = "folder_management", y = "remote_search", U = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, m = 9e4, h = "installation-id";
 export {
   I as CommunicationScheme,
   $ as FEATURE_FOLDER_MANAGEMENT,
   y as FEATURE_REMOTE_SEARCH,
-  m as INSTALLATION_HEADER,
+  h as INSTALLATION_HEADER,
   G as InteractionParticipantRole,
+  m as PRESENCE_ONLINE_WINDOW_MS,
   V as PROVIDER_FEATURE_MESSAGE_TEMPLATES,
   P as PROVIDER_FEATURE_MESSAGE_WINDOW,
   U as UNSUPPORTED,
   _ as buildActivityPreview,
-  C as buildChannelIntents,
+  O as buildChannelIntents,
   H as defineIntent,
   R as disabledIntentsFromCapabilities,
   M as filterByEndpoint,
-  O as filterByIntent,
+  C as filterByIntent,
   i as filterByTargetScheme,
   g as getContactEndpoints,
   N as getShortTitle,
   L as getUrgencyScore,
-  f as isAssigned,
-  D as isClosed,
+  D as isAssigned,
+  f as isClosed,
   S as isInteractionUnseen,
   b as matchContactToIntents,
   c as resolveAccountCapabilities,

package/dist/platform/communication.d.ts

@@ -5,6 +5,13 @@ export interface Session {
     providerId: string;
     direction: 'inbound' | 'outbound';
     remoteIdentity: string;
+    /**
+     * Number of remote participants, when the provider can report it. Used by
+     * transcript labeling: with more than one remote party the audio is a single
+     * mixed stream, so `remoteIdentity` can't be trusted to name the speaker and
+     * the label falls back to a generic one. Absent/1 = single remote party.
+     */
+    remoteParticipantCount?: number;
     state: SessionState;
     startTime?: number;
     hasVideo: boolean;
@@ -287,6 +294,49 @@ export interface RemoteStreamEvent {
     speaker?: 'local' | 'remote';
     label?: string;
 }
+/**
+ * Peer-to-peer WebRTC signaling envelope. Exchanged between two users in the
+ * same tenant to negotiate a direct call — the media (audio) flows P2P; only
+ * these small SDP/ICE setup messages transit the server (relayed 1:1 via
+ * `Bridge.sse.push`). Transient: never persisted.
+ *
+ *  - `offer`/`answer` → `data` is an `RTCSessionDescriptionInit`.
+ *  - `ice`            → `data` is an `RTCIceCandidateInit` (or `null` = end-of-candidates).
+ *  - `bye`            → `data` omitted; the sender tore the call down.
+ */
+export type WebRtcSignalKind = "offer" | "answer" | "ice" | "bye" | "request";
+/** Request body the initiator/answerer POSTs to the signaling relay. */
+export interface WebRtcSignalRequest {
+    /** Target userId (the peer this signal is meant for). */
+    to: string;
+    /** Stable call id, minted by the caller on invite. */
+    sessionId: string;
+    kind: WebRtcSignalKind;
+    data?: unknown;
+    /** Sender display name, so the peer can label the call UI without a lookup. */
+    fromName?: string;
+    /**
+     * Which peer connection this signal belongs to. `call` (default) is an audio
+     * session handled by the transport provider; `file` is an AirDrop-style
+     * RTCDataChannel transfer handled by the file-beam service; `monitor` is a
+     * one-way "listen along" forward handled by the call-monitor service. Lets
+     * one relay serve all three without the connection types colliding.
+     */
+    channel?: "call" | "file" | "monitor";
+}
+/**
+ * Broadcast (event `webrtc:callstate`) telling the tenant whether a user is
+ * currently on a call, so a supervisor can see who is available to listen in.
+ */
+export interface CallStateChange {
+    userId: string;
+    inCall: boolean;
+}
+/** What the callee receives over SSE — same envelope, server stamps `from`. */
+export interface WebRtcSignalEvent extends WebRtcSignalRequest {
+    /** Sender userId, stamped by the relay from the authenticated subject. */
+    from: string;
+}
 /**
  * Helper voor compactere intent-declaraties in `/provider/describe`.
  *   defineIntent("mail", { targetSchemes: [MAILTO], transport: { kind: "dispatch" } })

package/dist/platform/presence.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Presence — derived, not stored as its own entity. Online status is computed
+ * from `InstallationEntity.lastSeenAt`: a user is online when any of their
+ * non-revoked installations was seen within the freshness window. A light
+ * client heartbeat (~45s while the WebSocket is connected) keeps `lastSeenAt`
+ * fresh enough to reflect real reachability for calling.
+ */
+/** How recently a user's last device activity must be to count as online (ms). */
+export declare const PRESENCE_ONLINE_WINDOW_MS = 90000;
+/** One tenant user with their derived online status, as returned by GET /presence. */
+export interface PresenceEntry {
+    userId: string;
+    name?: string;
+    email?: string;
+    /** Max `lastSeenAt` across the user's non-revoked installations (ms epoch). */
+    lastSeenAt: number;
+    /** `now - lastSeenAt < PRESENCE_ONLINE_WINDOW_MS` at the time of the read. */
+    online: boolean;
+}
+/** SSE payload pushed on an offline->online transition (event `presence:changed`). */
+export interface PresenceChange {
+    userId: string;
+    online: boolean;
+    lastSeenAt: number;
+}

package/dist/platform/storage.d.ts

@@ -1,10 +1,26 @@
+import { OwnerScope } from '../entities/contact/types';
+/**
+ * A virtual folder: a named, scoped root that binds to a storage backend
+ * (a StorageAccount on a storage provider) at a base path. Its `ownerScope`
+ * decides who can see and use it (personal / team / org). Files live inside it.
+ *
+ * Kept named `VirtualMount` for continuity with existing consumers (ui-kit
+ * StorageInput, platform-api); surfaced to users as a "folder".
+ */
 export interface VirtualMount {
     id: string;
+    organizationId?: string;
     name: string;
+    /** Storage provider id (e.g. base64("s3:storage")). */
     providerId: string;
+    /** StorageAccount id backing this folder. Falls back to the provider default when omitted. */
+    accountId?: string;
     basePath: string;
-    policyId: string;
+    /** Who may see and use this folder. */
+    ownerScope: OwnerScope;
     metadata?: Record<string, any>;
+    createdAt?: number;
+    updatedAt?: number;
 }
 export interface FilePointer {
     id: string;
@@ -19,15 +35,38 @@ export interface FilePointer {
     createdAt?: number;
     tags?: string[];
 }
-export type FileAction = 'file:Read' | 'file:Write' | 'file:Delete' | 'file:List' | 'file:Share';
-export interface FilePolicyStatement {
-    effect: 'Allow' | 'Deny';
-    principal: string[];
-    action: FileAction[];
-    resource: string[];
+/**
+ * A field a storage provider needs to connect an account. Providers declare
+ * these (via /provider/describe); the accounts UI renders the form from them,
+ * so a new backend needs no UI changes.
+ */
+export interface StorageAccountField {
+    name: string;
+    label: string;
+    type: "text" | "password" | "number" | "checkbox";
+    required?: boolean;
+    placeholder?: string;
 }
-export interface FilePolicy {
+/** A connectable storage provider + the fields needed to connect an account. */
+export interface StorageProviderInfo {
+    /** Storage-role provider id (e.g. base64("ftp:storage")). */
     id: string;
-    name: string;
-    statements: FilePolicyStatement[];
+    displayName: string;
+    accountFields: StorageAccountField[];
+}
+/**
+ * A linked storage backend account (credentials to an S3 bucket, an FTP host, …).
+ * Backed by the canonical ManagedAccount store, mirroring the AI app's account
+ * pattern. Secrets never reach the UI — this is the public view.
+ */
+export interface StorageAccount {
+    id: string;
+    organizationId: string;
+    /** Account-provider id, e.g. base64("s3:account"). */
+    providerId: string;
+    displayName: string;
+    /** Whether this is the org's default account for its provider. */
+    isDefault?: boolean;
+    /** Provider-specific, non-secret fields (region, bucket, basePath, …). */
+    metadata?: Record<string, any>;
 }

package/package.json

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