@digisglobal/omnivox-sdk 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -25,13 +25,16 @@ __export(index_exports, {
   createAgentsModule: () => createAgentsModule,
   createApiKeyTokenProvider: () => createApiKeyTokenProvider,
   createAttachmentsModule: () => createAttachmentsModule,
+  createAuditModule: () => createAuditModule,
   createAuthMeModule: () => createAuthMeModule,
   createCannedResponsesModule: () => createCannedResponsesModule,
   createChannelsModule: () => createChannelsModule,
   createContactsModule: () => createContactsModule,
   createConversationsModule: () => createConversationsModule,
+  createDashboardModule: () => createDashboardModule,
   createMessagesModule: () => createMessagesModule,
   createOmnivoxClient: () => createOmnivoxClient,
+  createParticipantsModule: () => createParticipantsModule,
   createSessionTokenProvider: () => createSessionTokenProvider,
   createTemplatesModule: () => createTemplatesModule,
   createTenantsModule: () => createTenantsModule,
@@ -160,6 +163,15 @@ var getConversationsControllerUpdateStatusUrl = (id) => {
 var getConversationsControllerAssignUrl = (id) => {
   return `/api/v1/conversations/${id}/assign`;
 };
+var getConversationsControllerAddParticipantUrl = (id) => {
+  return `/api/v1/conversations/${id}/participants`;
+};
+var getConversationsControllerListParticipantsUrl = (id) => {
+  return `/api/v1/conversations/${id}/participants`;
+};
+var getConversationsControllerRemoveParticipantUrl = (id, agentId) => {
+  return `/api/v1/conversations/${id}/participants/${agentId}`;
+};
 var getConversationsControllerListLobbyUrl = (params) => {
   const normalizedParams = new URLSearchParams();
   Object.entries(params || {}).forEach(([key, value]) => {
@@ -329,6 +341,29 @@ var getAttachmentsControllerUploadUrl = () => {
 var getAttachmentsControllerGetDownloadUrlUrl = (id) => {
   return `/api/v1/attachments/${id}/url`;
 };
+var getDashboardControllerGetStatsUrl = () => {
+  return `/api/v1/dashboard/stats`;
+};
+var getDashboardControllerGetRecentActivityUrl = (params) => {
+  const normalizedParams = new URLSearchParams();
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== void 0) {
+      normalizedParams.append(key, value === null ? "null" : String(value));
+    }
+  });
+  const stringifiedParams = normalizedParams.toString();
+  return stringifiedParams.length > 0 ? `/api/v1/dashboard/recent-activity?${stringifiedParams}` : `/api/v1/dashboard/recent-activity`;
+};
+var getAuditLogControllerListUrl = (params) => {
+  const normalizedParams = new URLSearchParams();
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== void 0) {
+      normalizedParams.append(key, value === null ? "null" : String(value));
+    }
+  });
+  const stringifiedParams = normalizedParams.toString();
+  return stringifiedParams.length > 0 ? `/api/v1/audit-log?${stringifiedParams}` : `/api/v1/audit-log`;
+};
 
 // src/pagination/pagination.ts
 var MAX_PAGE_SIZE = 100;
@@ -745,6 +780,60 @@ function createConversationsModule(options) {
   };
 }
 
+// src/conversations/participants.ts
+function createParticipantsModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit(method, body) {
+    return {
+      method,
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    };
+  }
+  return {
+    /**
+     * Add (or re-add) an agent as a conversation participant with a role.
+     * Idempotent per active membership — re-adding an active participant
+     * updates its role; a second OWNER co-owns (no demotion of other owners).
+     * Calls POST /api/v1/conversations/:id/participants.
+     */
+    async add(conversationId, input) {
+      const path = getConversationsControllerAddParticipantUrl(conversationId);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("POST", input));
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * End an active membership for an agent. Idempotent — removing a
+     * non-participant is a no-op ({ removed: 0 }).
+     * Calls DELETE /api/v1/conversations/:id/participants/:agentId.
+     */
+    async remove(conversationId, agentId) {
+      const path = getConversationsControllerRemoveParticipantUrl(
+        conversationId,
+        agentId
+      );
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("DELETE"));
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * List the ACTIVE (leftAt IS NULL) participants of a conversation.
+     * Calls GET /api/v1/conversations/:id/participants.
+     */
+    async list(conversationId) {
+      const path = getConversationsControllerListParticipantsUrl(conversationId);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("GET"));
+      return parseEnvelopedResponse(res);
+    }
+  };
+}
+
 // src/messages/messages.ts
 function createMessagesModule(options) {
   const baseUrl = options.baseUrl;
@@ -1240,6 +1329,89 @@ function createWhatsAppBusinessAccountsModule(options) {
   };
 }
 
+// src/dashboard/dashboard.ts
+function createDashboardModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit() {
+    return {
+      method: "GET",
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      }
+    };
+  }
+  return {
+    /**
+     * Fetch the tenant dashboard KPIs.
+     * Calls GET /api/v1/dashboard/stats.
+     */
+    async stats() {
+      const path = getDashboardControllerGetStatsUrl();
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * List the tenant's recent conversation/message activity feed
+     * (newest first, paginated). pageSize is clamped to 100 per the API
+     * contract. Calls GET /api/v1/dashboard/recent-activity.
+     */
+    async recentActivity(opts = { page: 1, pageSize: 25 }) {
+      const { page, pageSize } = buildPageParams(opts);
+      const path = getDashboardControllerGetRecentActivityUrl({
+        page,
+        pageSize
+      });
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseResponse(res);
+    }
+  };
+}
+
+// src/audit/audit.ts
+function createAuditModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit() {
+    return {
+      method: "GET",
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      }
+    };
+  }
+  return {
+    /**
+     * List the tenant audit trail (newest first, paginated).
+     * pageSize is clamped to 100 per the API contract.
+     * Calls GET /api/v1/audit-log.
+     */
+    async list(opts = {}) {
+      const { page, pageSize } = buildPageParams({
+        page: opts.page ?? 1,
+        pageSize: opts.pageSize ?? 25
+      });
+      const params = {
+        ...opts.resourceType !== void 0 ? { resourceType: opts.resourceType } : {},
+        ...opts.resourceId !== void 0 ? { resourceId: opts.resourceId } : {},
+        ...opts.actorId !== void 0 ? { actorId: opts.actorId } : {},
+        ...opts.from !== void 0 ? { from: opts.from } : {},
+        ...opts.to !== void 0 ? { to: opts.to } : {},
+        page,
+        pageSize
+      };
+      const path = getAuditLogControllerListUrl(params);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseResponse(res);
+    }
+  };
+}
+
 // src/ws/ws-client.ts
 var import_socket = require("socket.io-client");
 function createWsClient(options) {
@@ -1330,11 +1502,14 @@ function createOmnivoxClient(options) {
     channels: createChannelsModule(moduleOptions),
     contacts: createContactsModule(moduleOptions),
     conversations: createConversationsModule(moduleOptions),
+    participants: createParticipantsModule(moduleOptions),
     messages: createMessagesModule(moduleOptions),
     templates: createTemplatesModule(moduleOptions),
     cannedResponses: createCannedResponsesModule(moduleOptions),
     attachments: createAttachmentsModule(moduleOptions),
     whatsappBusinessAccounts: createWhatsAppBusinessAccountsModule(moduleOptions),
+    dashboard: createDashboardModule(moduleOptions),
+    audit: createAuditModule(moduleOptions),
     /**
      * Creates a WebSocket client connected to the `/ws/chat` namespace.
      *
@@ -1390,13 +1565,16 @@ function createSessionTokenProvider() {
   createAgentsModule,
   createApiKeyTokenProvider,
   createAttachmentsModule,
+  createAuditModule,
   createAuthMeModule,
   createCannedResponsesModule,
   createChannelsModule,
   createContactsModule,
   createConversationsModule,
+  createDashboardModule,
   createMessagesModule,
   createOmnivoxClient,
+  createParticipantsModule,
   createSessionTokenProvider,
   createTemplatesModule,
   createTenantsModule,

package/dist/index.d.cts

@@ -33,6 +33,169 @@ declare function createApiKeyTokenProvider(apiKey: string): TokenProvider;
  */
 declare function createSessionTokenProvider(): TokenProvider;
 
+/**
+ * Audit module — hand-written typed wrapper over the generated client.
+ *
+ * Exposes the F16 audit-log read surface:
+ *   - list(opts) → GET /api/v1/audit-log (pageSize capped at 100)
+ *
+ * Filterable by resourceType, resourceId, actorId and a createdAt time range
+ * (from/to), paginated, newest first. Read requires the AuditEntry read
+ * ability (global ADMIN agent or api_key/system actor).
+ *
+ * Never re-exports symbols from _generated/.
+ * Contains no business logic — typed transport only.
+ */
+
+/** Options to construct the audit module. */
+interface AuditModuleOptions extends TokenProvider {
+    /** Base URL of the Omnivox API (e.g. "https://api.omnivox.io"). */
+    baseUrl: string;
+}
+/** One audit-trail entry returned by GET /api/v1/audit-log. */
+interface AuditEntry {
+    id: string;
+    /** Actor kind that produced the entry (e.g. "agent" | "api_key" | "system"). */
+    actorType: string;
+    /** Acting identity id; null for system-originated entries. */
+    actorId: string | null;
+    /** The audited action (e.g. "contact.update"). */
+    action: string;
+    /** The audited resource kind (e.g. "Contact"). */
+    resourceType: string;
+    /** The audited resource id. */
+    resourceId: string;
+    /** JSON-Patch-array diff of the change (forward-compat shape). */
+    diff: unknown;
+    /** Correlation id linking related entries; null when absent. */
+    correlationId: string | null;
+    createdAt: string;
+    [key: string]: unknown;
+}
+/** Paginated list response. */
+interface PagedList$7<T> {
+    data: T[];
+    meta: {
+        page: number;
+        pageSize: number;
+        total: number;
+        hasNextPage: boolean;
+    };
+}
+/** Filter + pagination options for audit.list(). */
+interface AuditListOpts {
+    /** Filter to entries whose resourceType matches exactly. */
+    resourceType?: string;
+    /** Filter to entries whose resourceId matches exactly. */
+    resourceId?: string;
+    /** Filter to entries produced by this actor id. */
+    actorId?: string;
+    /** Inclusive lower bound on createdAt (ISO 8601 date-time). */
+    from?: string;
+    /** Inclusive upper bound on createdAt (ISO 8601 date-time). */
+    to?: string;
+    /** Page number (1-based, default 1). */
+    page?: number;
+    /** Entries per page (default 25, clamped to 100). */
+    pageSize?: number;
+}
+/**
+ * Creates the audit module — a thin typed wrapper over the generated client.
+ */
+declare function createAuditModule(options: AuditModuleOptions): {
+    /**
+     * List the tenant audit trail (newest first, paginated).
+     * pageSize is clamped to 100 per the API contract.
+     * Calls GET /api/v1/audit-log.
+     */
+    list(opts?: AuditListOpts): Promise<PagedList$7<AuditEntry>>;
+};
+/** Return type of createAuditModule. */
+type AuditModule = ReturnType<typeof createAuditModule>;
+
+/**
+ * Dashboard module — hand-written typed wrapper over the generated client.
+ *
+ * Exposes the F14 dashboard read surface:
+ *   - stats()                 → GET /api/v1/dashboard/stats
+ *   - recentActivity(opts)    → GET /api/v1/dashboard/recent-activity (pageSize capped at 100)
+ *
+ * Never re-exports symbols from _generated/.
+ * Contains no business logic — typed transport only.
+ */
+
+/** Options to construct the dashboard module. */
+interface DashboardModuleOptions extends TokenProvider {
+    /** Base URL of the Omnivox API (e.g. "https://api.omnivox.io"). */
+    baseUrl: string;
+}
+/** Tenant dashboard KPIs returned by GET /api/v1/dashboard/stats. */
+interface DashboardStats {
+    /** Conversations not yet CLOSED (PENDING | OPEN | ON_HOLD). */
+    activeConversationsCount: number;
+    /** All contacts for the tenant. */
+    contactsCount: number;
+    /** OPEN conversations grouped by the linked contact identity's channel type. */
+    openByChannel: {
+        WHATSAPP: number;
+        EMAIL: number;
+    };
+    /**
+     * OPEN conversations where the authenticated agent is an ACTIVE OWNER
+     * participant. 0 for api_key/system actors (no acting agent identity).
+     */
+    myOpenCount: number;
+}
+/** One item in the tenant recent-activity feed. */
+interface RecentActivityItem {
+    /** The underlying Message row's id — stable per-item identity for the feed. */
+    id: string;
+    conversationId: string;
+    /** The parent conversation's CURRENT status (not the status at message time). */
+    conversationStatus: 'PENDING' | 'OPEN' | 'ON_HOLD' | 'CLOSED';
+    /** The linked contact identity's channel type — same values as `openByChannel`. */
+    channelType: 'WHATSAPP' | 'EMAIL';
+    direction: 'INBOUND' | 'OUTBOUND';
+    type: 'TEXT' | 'IMAGE' | 'DOCUMENT' | 'AUDIO' | 'VIDEO' | 'TEMPLATE';
+    status: 'QUEUED' | 'SENT' | 'DELIVERED' | 'READ' | 'FAILED';
+    content: unknown;
+    createdAt: string;
+    [key: string]: unknown;
+}
+/** Paginated list response. */
+interface PagedList$6<T> {
+    data: T[];
+    meta: {
+        page: number;
+        pageSize: number;
+        total: number;
+        hasNextPage: boolean;
+    };
+}
+/** Pagination options for recentActivity(). */
+interface RecentActivityListOpts {
+    page: number;
+    pageSize: number;
+}
+/**
+ * Creates the dashboard module — a thin typed wrapper over the generated client.
+ */
+declare function createDashboardModule(options: DashboardModuleOptions): {
+    /**
+     * Fetch the tenant dashboard KPIs.
+     * Calls GET /api/v1/dashboard/stats.
+     */
+    stats(): Promise<DashboardStats>;
+    /**
+     * List the tenant's recent conversation/message activity feed
+     * (newest first, paginated). pageSize is clamped to 100 per the API
+     * contract. Calls GET /api/v1/dashboard/recent-activity.
+     */
+    recentActivity(opts?: RecentActivityListOpts): Promise<PagedList$6<RecentActivityItem>>;
+};
+/** Return type of createDashboardModule. */
+type DashboardModule = ReturnType<typeof createDashboardModule>;
+
 /**
  * Canned-responses module — hand-written typed wrapper over the generated client.
  *
@@ -582,12 +745,30 @@ interface PickupInput {
     agentId: string;
     [key: string]: unknown;
 }
-/** Conversation resource shape returned by the API. */
+/**
+ * Base conversation resource shape returned by the API. This is what
+ * reopenOrCreate/updateStatus/assign respond with — those routes mutate the
+ * conversation or its participants but do not re-derive ownerAgentIds, so it
+ * is intentionally absent here. Adding it as required on this type would be a
+ * false type guarantee for those three methods.
+ */
 interface ConversationItem {
     id: string;
     status: string;
     [key: string]: unknown;
 }
+/**
+ * LIST/DETAIL conversation resource shape — the base item plus
+ * `ownerAgentIds`, the agentIds of the conversation's ACTIVE OWNER
+ * participants (role=OWNER, leftAt IS NULL), ordered by joinedAt then
+ * agentId. An empty array means the conversation is unassigned. Only the
+ * LIST (`list()`) and DETAIL (`get()`) responses populate this field (FF-A);
+ * ownership lives in ConversationParticipant after F10. Mirrors the API's own
+ * ConversationOwnershipResult split (apps/api/src/conversations/conversations.service.ts).
+ */
+interface ConversationListItem extends ConversationItem {
+    ownerAgentIds: string[];
+}
 /** Lobby entry resource shape returned by the API. */
 interface LobbyEntry {
     id: string;
@@ -648,7 +829,7 @@ declare function createConversationsModule(options: ConversationsModuleOptions):
      * pageSize is clamped to 100 per the API contract.
      * Calls GET /api/v1/conversations.
      */
-    list(opts?: ConversationListOpts): Promise<PagedList$3<ConversationItem>>;
+    list(opts?: ConversationListOpts): Promise<PagedList$3<ConversationListItem>>;
     /**
      * Update a conversation status via the state machine.
      * Calls PATCH /api/v1/conversations/:id/status.
@@ -669,7 +850,7 @@ declare function createConversationsModule(options: ConversationsModuleOptions):
      * Get a single conversation by ID.
      * Calls GET /api/v1/conversations/:id.
      */
-    get(id: string): Promise<ConversationItem>;
+    get(id: string): Promise<ConversationListItem>;
     /**
      * Pick up a lobby entry (atomic 4-step transaction).
      * Returns the resulting conversation + entry ids.
@@ -1038,11 +1219,12 @@ declare function createTenantsModule(options: TenantsModuleOptions): {
 type TenantsModule = ReturnType<typeof createTenantsModule>;
 
 /**
- * WS-only event payload registry — single source of truth for the four
+ * WS-only event payload registry — single source of truth for the six
  * WS-only events that have no REST/openapi counterpart and therefore no
  * orval → _generated pipeline:
  *
- *   typing:indicator  ·  message:read:update  ·  participant:joined  ·  participant:left
+ *   typing:indicator  ·  message:read:update  ·  participant:joined  ·
+ *   participant:left  ·  participant:added  ·  participant:removed
  *
  * The runtime constant {@link WS_EVENT_REGISTRY} must stay byte-identical with
  * ws-event-shapes.fixture.json. Two contract tests enforce this:
@@ -1087,6 +1269,28 @@ interface ParticipantPayload {
     actor: unknown;
     [key: string]: unknown;
 }
+/**
+ * Payload for the `participant:added` server → client event (F10/T08).
+ * Emitted when an agent is added to a conversation's participant set — a
+ * server-side membership mutation, distinct from the `participant:joined`
+ * presence event.
+ */
+interface ParticipantAddedPayload {
+    conversationId: string;
+    agentId: string;
+    role: string;
+    [key: string]: unknown;
+}
+/**
+ * Payload for the `participant:removed` server → client event (F10/T08).
+ * Emitted when an agent is removed from a conversation's participant set; the
+ * removed agent's sockets are also force-evicted from the room server-side.
+ */
+interface ParticipantRemovedPayload {
+    conversationId: string;
+    agentId: string;
+    [key: string]: unknown;
+}
 
 /**
  * WebSocket client — hand-written typed wrapper over socket.io-client.
@@ -1160,6 +1364,8 @@ interface WsEventPayloads {
     'message:read:update': MessageReadUpdatePayload;
     'participant:joined': ParticipantPayload;
     'participant:left': ParticipantPayload;
+    'participant:added': ParticipantAddedPayload;
+    'participant:removed': ParticipantRemovedPayload;
     'typing:indicator': TypingIndicatorPayload;
 }
 /** The WebSocket client returned by {@link createWsClient}. */
@@ -1291,14 +1497,19 @@ declare function createOmnivoxClient(options: OmnivoxClientOptions): {
     };
     conversations: {
         reopenOrCreate(input: ReopenOrCreateInput): Promise<ConversationItem>;
-        list(opts?: ConversationListOpts): Promise<PagedList$3<ConversationItem>>;
+        list(opts?: ConversationListOpts): Promise<PagedList$3<ConversationListItem>>;
         updateStatus(id: string, input: UpdateStatusInput): Promise<ConversationItem>;
         assign(id: string, input: AssignInput): Promise<ConversationItem>;
         listLobby(opts?: LobbyListOpts): Promise<PagedList$3<LobbyEntry>>;
-        get(id: string): Promise<ConversationItem>;
+        get(id: string): Promise<ConversationListItem>;
         pickup(entryId: string, input: PickupInput): Promise<PickupResult>;
         whatsappRecoveryOptions(id: string): Promise<WhatsAppRecoveryOption[]>;
     };
+    participants: {
+        add(conversationId: string, input: AddParticipantInput): Promise<ParticipantItem>;
+        remove(conversationId: string, agentId: string): Promise<RemoveParticipantResult>;
+        list(conversationId: string): Promise<ParticipantItem[]>;
+    };
     messages: {
         send(input: SendMessageInput): Promise<MessageItem>;
         list(opts: MessageListOpts): Promise<PagedList$4<MessageItem>>;
@@ -1344,6 +1555,13 @@ declare function createOmnivoxClient(options: OmnivoxClientOptions): {
             name: string;
         }): Promise<WhatsAppBusinessAccountItem>;
     };
+    dashboard: {
+        stats(): Promise<DashboardStats>;
+        recentActivity(opts?: RecentActivityListOpts): Promise<PagedList$6<RecentActivityItem>>;
+    };
+    audit: {
+        list(opts?: AuditListOpts): Promise<PagedList$7<AuditEntry>>;
+    };
     /**
      * Creates a WebSocket client connected to the `/ws/chat` namespace.
      *
@@ -1639,6 +1857,76 @@ declare function createChannelsModule(options: ChannelsModuleOptions): {
 /** Return type of createChannelsModule. */
 type ChannelsModule = ReturnType<typeof createChannelsModule>;
 
+/**
+ * Conversation participants module — hand-written typed wrapper over the
+ * generated client (F10/T09).
+ *
+ * Exposes the participant-management surface for the conversations resource:
+ *   - add(conversationId, input)       → POST   /api/v1/conversations/:id/participants
+ *   - remove(conversationId, agentId)  → DELETE /api/v1/conversations/:id/participants/:agentId
+ *   - list(conversationId)             → GET    /api/v1/conversations/:id/participants
+ *
+ * All three routes are guarded server-side by CASL abilities (grant for
+ * add/remove, read for list) — a 403 surfaces as an {@link OmnivoxRequestError}
+ * with `status === 403` like any other rejected request.
+ *
+ * Never re-exports symbols from _generated/.
+ * Contains no business logic — typed transport only.
+ */
+
+/** Options to construct the participants module. */
+interface ParticipantsModuleOptions extends TokenProvider {
+    /** Base URL of the Omnivox API (e.g. "https://api.omnivox.io"). */
+    baseUrl: string;
+}
+/** A conversation participant's per-conversation role. */
+type ParticipantRole = 'OWNER' | 'AGENT' | 'VIEWER';
+/** Input for adding (or re-adding) a participant. */
+interface AddParticipantInput {
+    agentId: string;
+    role: ParticipantRole;
+    [key: string]: unknown;
+}
+/** Participant resource shape returned by the API (no tenantId leak). */
+interface ParticipantItem {
+    id: string;
+    conversationId: string;
+    agentId: string;
+    role: ParticipantRole;
+    joinedAt: string;
+    leftAt: string | null;
+    [key: string]: unknown;
+}
+/** Result of removing a participant — the number of memberships ended (0 or 1). */
+interface RemoveParticipantResult {
+    removed: number;
+}
+/**
+ * Creates the participants module — a thin typed wrapper over the generated client.
+ */
+declare function createParticipantsModule(options: ParticipantsModuleOptions): {
+    /**
+     * Add (or re-add) an agent as a conversation participant with a role.
+     * Idempotent per active membership — re-adding an active participant
+     * updates its role; a second OWNER co-owns (no demotion of other owners).
+     * Calls POST /api/v1/conversations/:id/participants.
+     */
+    add(conversationId: string, input: AddParticipantInput): Promise<ParticipantItem>;
+    /**
+     * End an active membership for an agent. Idempotent — removing a
+     * non-participant is a no-op ({ removed: 0 }).
+     * Calls DELETE /api/v1/conversations/:id/participants/:agentId.
+     */
+    remove(conversationId: string, agentId: string): Promise<RemoveParticipantResult>;
+    /**
+     * List the ACTIVE (leftAt IS NULL) participants of a conversation.
+     * Calls GET /api/v1/conversations/:id/participants.
+     */
+    list(conversationId: string): Promise<ParticipantItem[]>;
+};
+/** Return type of createParticipantsModule. */
+type ParticipantsModule = ReturnType<typeof createParticipantsModule>;
+
 /**
  * Attachments module — hand-written typed wrapper over the generated client.
  *
@@ -1807,4 +2095,4 @@ declare function createWhatsAppBusinessAccountsModule(options: WhatsAppBusinessA
 /** Return type of createWhatsAppBusinessAccountsModule. */
 type WhatsAppBusinessAccountsModule = ReturnType<typeof createWhatsAppBusinessAccountsModule>;
 
-export { type AddIdentityInput, type AgentItem, type AgentsModule, type AgentsModuleOptions, type ApiKeyItem, type AssignInput, type AttachmentUploadResult, type AttachmentUrlResult, type AttachmentsModule, type AttachmentsModuleOptions, type AuthMeAgent, type AuthMeModule, type AuthMeModuleOptions, type AuthMeResponse, type AuthMeTenant, type AuthorDraftInput, type BasicEmailChannelConfig, type BasicEmailChannelSecret, type CannedResponseItem, type CannedResponseListOpts, type CannedResponseSearchOpts, type CannedResponsesModule, type CannedResponsesModuleOptions, type Channel, type ChannelListItem, type ChannelStatus, type ChannelType, type ChannelsModule, type ChannelsModuleOptions, type ContactChannel, type ContactConversationSummary, type ContactFieldDefinition, type ContactFieldValue, type ContactFieldValueInput, type ContactIdentity, type ContactIdentityInput, type ContactItem, type ContactSearchOpts, type ContactTag, type ContactsMetadata, type ContactsModule, type ContactsModuleOptions, type ConversationItem, type ConversationListOpts, type ConversationsModule, type ConversationsModuleOptions, type CreateAgentInput, type CreateApiKeyInput, type CreateApiKeyResponse, type CreateCannedResponseInput, type CreateChannelBody, type CreateContactInput, type CreateEmailChannelBody, type CreateEmailTemplateInput, type CreateWhatsAppBusinessAccountBody, type CreateWhatsAppChannelBody, type CredentialsMode, type EmailChannelConfig, type EmailChannelSecret, type EmailImapConfig, type EmailSmtpConfig, type EmailTemplateItem, type EmailTemplateListOpts, type ImportApprovedResult, type ImportedTemplateResult, type LobbyEntry, type LobbyListOpts, type MessageItem, type MessageListOpts, type MessageReadUpdatePayload, type MessageStatusPayload, type MessagesModule, type MessagesModuleOptions, type OAuth2CertificateEmailChannelSecret, type OAuth2ClientSecretEmailChannelSecret, type OAuth2EmailChannelConfig, type OAuth2EmailChannelSecret, type OmnivoxClient, type OmnivoxClientOptions, OmnivoxRequestError, type PageOpts, type PageParams, type PagedResponse, type ParticipantPayload, type PatchContactInput, type PatchEmailTemplateInput, type PickupInput, type ReopenOrCreateInput, type RevokeApiKeyResponse, type SendMessageInput, type SendTemplateInput, type SubmitResult, type TemplatesModule, type TemplatesModuleOptions, type TenantsModule, type TenantsModuleOptions, type TokenProvider, type TypingIndicatorPayload, type UpdateCannedResponseInput, type UpdateChannelBody, type UpdateStatusInput, type UpdateWhatsAppTemplateInput, type WhatsAppBusinessAccountItem, type WhatsAppBusinessAccountsModule, type WhatsAppBusinessAccountsModuleOptions, type WhatsAppChannelConfig, type WhatsAppRecoveryOption, type WhatsAppTemplateDetail, type WhatsAppTemplateHistory, type WhatsAppTemplateHistoryEvent, type WhatsAppTemplateHistoryVersion, type WhatsAppTemplateItem, type WhatsAppTemplateListOpts, type WsAuth, type WsClient, type WsClientInstance, type WsClientOptions, type WsConnectionState, type WsEventPayloads, buildPageParams, createAgentsModule, createApiKeyTokenProvider, createAttachmentsModule, createAuthMeModule, createCannedResponsesModule, createChannelsModule, createContactsModule, createConversationsModule, createMessagesModule, createOmnivoxClient, createSessionTokenProvider, createTemplatesModule, createTenantsModule, createWhatsAppBusinessAccountsModule, createWsClient, iteratePages };
+export { type AddIdentityInput, type AddParticipantInput, type AgentItem, type AgentsModule, type AgentsModuleOptions, type ApiKeyItem, type AssignInput, type AttachmentUploadResult, type AttachmentUrlResult, type AttachmentsModule, type AttachmentsModuleOptions, type AuditEntry, type AuditListOpts, type AuditModule, type AuditModuleOptions, type AuthMeAgent, type AuthMeModule, type AuthMeModuleOptions, type AuthMeResponse, type AuthMeTenant, type AuthorDraftInput, type BasicEmailChannelConfig, type BasicEmailChannelSecret, type CannedResponseItem, type CannedResponseListOpts, type CannedResponseSearchOpts, type CannedResponsesModule, type CannedResponsesModuleOptions, type Channel, type ChannelListItem, type ChannelStatus, type ChannelType, type ChannelsModule, type ChannelsModuleOptions, type ContactChannel, type ContactConversationSummary, type ContactFieldDefinition, type ContactFieldValue, type ContactFieldValueInput, type ContactIdentity, type ContactIdentityInput, type ContactItem, type ContactSearchOpts, type ContactTag, type ContactsMetadata, type ContactsModule, type ContactsModuleOptions, type ConversationItem, type ConversationListItem, type ConversationListOpts, type ConversationsModule, type ConversationsModuleOptions, type CreateAgentInput, type CreateApiKeyInput, type CreateApiKeyResponse, type CreateCannedResponseInput, type CreateChannelBody, type CreateContactInput, type CreateEmailChannelBody, type CreateEmailTemplateInput, type CreateWhatsAppBusinessAccountBody, type CreateWhatsAppChannelBody, type CredentialsMode, type DashboardModule, type DashboardModuleOptions, type DashboardStats, type EmailChannelConfig, type EmailChannelSecret, type EmailImapConfig, type EmailSmtpConfig, type EmailTemplateItem, type EmailTemplateListOpts, type ImportApprovedResult, type ImportedTemplateResult, type LobbyEntry, type LobbyListOpts, type MessageItem, type MessageListOpts, type MessageReadUpdatePayload, type MessageStatusPayload, type MessagesModule, type MessagesModuleOptions, type OAuth2CertificateEmailChannelSecret, type OAuth2ClientSecretEmailChannelSecret, type OAuth2EmailChannelConfig, type OAuth2EmailChannelSecret, type OmnivoxClient, type OmnivoxClientOptions, OmnivoxRequestError, type PageOpts, type PageParams, type PagedResponse, type ParticipantAddedPayload, type ParticipantItem, type ParticipantPayload, type ParticipantRemovedPayload, type ParticipantRole, type ParticipantsModule, type ParticipantsModuleOptions, type PatchContactInput, type PatchEmailTemplateInput, type PickupInput, type RecentActivityItem, type RecentActivityListOpts, type RemoveParticipantResult, type ReopenOrCreateInput, type RevokeApiKeyResponse, type SendMessageInput, type SendTemplateInput, type SubmitResult, type TemplatesModule, type TemplatesModuleOptions, type TenantsModule, type TenantsModuleOptions, type TokenProvider, type TypingIndicatorPayload, type UpdateCannedResponseInput, type UpdateChannelBody, type UpdateStatusInput, type UpdateWhatsAppTemplateInput, type WhatsAppBusinessAccountItem, type WhatsAppBusinessAccountsModule, type WhatsAppBusinessAccountsModuleOptions, type WhatsAppChannelConfig, type WhatsAppRecoveryOption, type WhatsAppTemplateDetail, type WhatsAppTemplateHistory, type WhatsAppTemplateHistoryEvent, type WhatsAppTemplateHistoryVersion, type WhatsAppTemplateItem, type WhatsAppTemplateListOpts, type WsAuth, type WsClient, type WsClientInstance, type WsClientOptions, type WsConnectionState, type WsEventPayloads, buildPageParams, createAgentsModule, createApiKeyTokenProvider, createAttachmentsModule, createAuditModule, createAuthMeModule, createCannedResponsesModule, createChannelsModule, createContactsModule, createConversationsModule, createDashboardModule, createMessagesModule, createOmnivoxClient, createParticipantsModule, createSessionTokenProvider, createTemplatesModule, createTenantsModule, createWhatsAppBusinessAccountsModule, createWsClient, iteratePages };

package/dist/index.d.ts

@@ -33,6 +33,169 @@ declare function createApiKeyTokenProvider(apiKey: string): TokenProvider;
  */
 declare function createSessionTokenProvider(): TokenProvider;
 
+/**
+ * Audit module — hand-written typed wrapper over the generated client.
+ *
+ * Exposes the F16 audit-log read surface:
+ *   - list(opts) → GET /api/v1/audit-log (pageSize capped at 100)
+ *
+ * Filterable by resourceType, resourceId, actorId and a createdAt time range
+ * (from/to), paginated, newest first. Read requires the AuditEntry read
+ * ability (global ADMIN agent or api_key/system actor).
+ *
+ * Never re-exports symbols from _generated/.
+ * Contains no business logic — typed transport only.
+ */
+
+/** Options to construct the audit module. */
+interface AuditModuleOptions extends TokenProvider {
+    /** Base URL of the Omnivox API (e.g. "https://api.omnivox.io"). */
+    baseUrl: string;
+}
+/** One audit-trail entry returned by GET /api/v1/audit-log. */
+interface AuditEntry {
+    id: string;
+    /** Actor kind that produced the entry (e.g. "agent" | "api_key" | "system"). */
+    actorType: string;
+    /** Acting identity id; null for system-originated entries. */
+    actorId: string | null;
+    /** The audited action (e.g. "contact.update"). */
+    action: string;
+    /** The audited resource kind (e.g. "Contact"). */
+    resourceType: string;
+    /** The audited resource id. */
+    resourceId: string;
+    /** JSON-Patch-array diff of the change (forward-compat shape). */
+    diff: unknown;
+    /** Correlation id linking related entries; null when absent. */
+    correlationId: string | null;
+    createdAt: string;
+    [key: string]: unknown;
+}
+/** Paginated list response. */
+interface PagedList$7<T> {
+    data: T[];
+    meta: {
+        page: number;
+        pageSize: number;
+        total: number;
+        hasNextPage: boolean;
+    };
+}
+/** Filter + pagination options for audit.list(). */
+interface AuditListOpts {
+    /** Filter to entries whose resourceType matches exactly. */
+    resourceType?: string;
+    /** Filter to entries whose resourceId matches exactly. */
+    resourceId?: string;
+    /** Filter to entries produced by this actor id. */
+    actorId?: string;
+    /** Inclusive lower bound on createdAt (ISO 8601 date-time). */
+    from?: string;
+    /** Inclusive upper bound on createdAt (ISO 8601 date-time). */
+    to?: string;
+    /** Page number (1-based, default 1). */
+    page?: number;
+    /** Entries per page (default 25, clamped to 100). */
+    pageSize?: number;
+}
+/**
+ * Creates the audit module — a thin typed wrapper over the generated client.
+ */
+declare function createAuditModule(options: AuditModuleOptions): {
+    /**
+     * List the tenant audit trail (newest first, paginated).
+     * pageSize is clamped to 100 per the API contract.
+     * Calls GET /api/v1/audit-log.
+     */
+    list(opts?: AuditListOpts): Promise<PagedList$7<AuditEntry>>;
+};
+/** Return type of createAuditModule. */
+type AuditModule = ReturnType<typeof createAuditModule>;
+
+/**
+ * Dashboard module — hand-written typed wrapper over the generated client.
+ *
+ * Exposes the F14 dashboard read surface:
+ *   - stats()                 → GET /api/v1/dashboard/stats
+ *   - recentActivity(opts)    → GET /api/v1/dashboard/recent-activity (pageSize capped at 100)
+ *
+ * Never re-exports symbols from _generated/.
+ * Contains no business logic — typed transport only.
+ */
+
+/** Options to construct the dashboard module. */
+interface DashboardModuleOptions extends TokenProvider {
+    /** Base URL of the Omnivox API (e.g. "https://api.omnivox.io"). */
+    baseUrl: string;
+}
+/** Tenant dashboard KPIs returned by GET /api/v1/dashboard/stats. */
+interface DashboardStats {
+    /** Conversations not yet CLOSED (PENDING | OPEN | ON_HOLD). */
+    activeConversationsCount: number;
+    /** All contacts for the tenant. */
+    contactsCount: number;
+    /** OPEN conversations grouped by the linked contact identity's channel type. */
+    openByChannel: {
+        WHATSAPP: number;
+        EMAIL: number;
+    };
+    /**
+     * OPEN conversations where the authenticated agent is an ACTIVE OWNER
+     * participant. 0 for api_key/system actors (no acting agent identity).
+     */
+    myOpenCount: number;
+}
+/** One item in the tenant recent-activity feed. */
+interface RecentActivityItem {
+    /** The underlying Message row's id — stable per-item identity for the feed. */
+    id: string;
+    conversationId: string;
+    /** The parent conversation's CURRENT status (not the status at message time). */
+    conversationStatus: 'PENDING' | 'OPEN' | 'ON_HOLD' | 'CLOSED';
+    /** The linked contact identity's channel type — same values as `openByChannel`. */
+    channelType: 'WHATSAPP' | 'EMAIL';
+    direction: 'INBOUND' | 'OUTBOUND';
+    type: 'TEXT' | 'IMAGE' | 'DOCUMENT' | 'AUDIO' | 'VIDEO' | 'TEMPLATE';
+    status: 'QUEUED' | 'SENT' | 'DELIVERED' | 'READ' | 'FAILED';
+    content: unknown;
+    createdAt: string;
+    [key: string]: unknown;
+}
+/** Paginated list response. */
+interface PagedList$6<T> {
+    data: T[];
+    meta: {
+        page: number;
+        pageSize: number;
+        total: number;
+        hasNextPage: boolean;
+    };
+}
+/** Pagination options for recentActivity(). */
+interface RecentActivityListOpts {
+    page: number;
+    pageSize: number;
+}
+/**
+ * Creates the dashboard module — a thin typed wrapper over the generated client.
+ */
+declare function createDashboardModule(options: DashboardModuleOptions): {
+    /**
+     * Fetch the tenant dashboard KPIs.
+     * Calls GET /api/v1/dashboard/stats.
+     */
+    stats(): Promise<DashboardStats>;
+    /**
+     * List the tenant's recent conversation/message activity feed
+     * (newest first, paginated). pageSize is clamped to 100 per the API
+     * contract. Calls GET /api/v1/dashboard/recent-activity.
+     */
+    recentActivity(opts?: RecentActivityListOpts): Promise<PagedList$6<RecentActivityItem>>;
+};
+/** Return type of createDashboardModule. */
+type DashboardModule = ReturnType<typeof createDashboardModule>;
+
 /**
  * Canned-responses module — hand-written typed wrapper over the generated client.
  *
@@ -582,12 +745,30 @@ interface PickupInput {
     agentId: string;
     [key: string]: unknown;
 }
-/** Conversation resource shape returned by the API. */
+/**
+ * Base conversation resource shape returned by the API. This is what
+ * reopenOrCreate/updateStatus/assign respond with — those routes mutate the
+ * conversation or its participants but do not re-derive ownerAgentIds, so it
+ * is intentionally absent here. Adding it as required on this type would be a
+ * false type guarantee for those three methods.
+ */
 interface ConversationItem {
     id: string;
     status: string;
     [key: string]: unknown;
 }
+/**
+ * LIST/DETAIL conversation resource shape — the base item plus
+ * `ownerAgentIds`, the agentIds of the conversation's ACTIVE OWNER
+ * participants (role=OWNER, leftAt IS NULL), ordered by joinedAt then
+ * agentId. An empty array means the conversation is unassigned. Only the
+ * LIST (`list()`) and DETAIL (`get()`) responses populate this field (FF-A);
+ * ownership lives in ConversationParticipant after F10. Mirrors the API's own
+ * ConversationOwnershipResult split (apps/api/src/conversations/conversations.service.ts).
+ */
+interface ConversationListItem extends ConversationItem {
+    ownerAgentIds: string[];
+}
 /** Lobby entry resource shape returned by the API. */
 interface LobbyEntry {
     id: string;
@@ -648,7 +829,7 @@ declare function createConversationsModule(options: ConversationsModuleOptions):
      * pageSize is clamped to 100 per the API contract.
      * Calls GET /api/v1/conversations.
      */
-    list(opts?: ConversationListOpts): Promise<PagedList$3<ConversationItem>>;
+    list(opts?: ConversationListOpts): Promise<PagedList$3<ConversationListItem>>;
     /**
      * Update a conversation status via the state machine.
      * Calls PATCH /api/v1/conversations/:id/status.
@@ -669,7 +850,7 @@ declare function createConversationsModule(options: ConversationsModuleOptions):
      * Get a single conversation by ID.
      * Calls GET /api/v1/conversations/:id.
      */
-    get(id: string): Promise<ConversationItem>;
+    get(id: string): Promise<ConversationListItem>;
     /**
      * Pick up a lobby entry (atomic 4-step transaction).
      * Returns the resulting conversation + entry ids.
@@ -1038,11 +1219,12 @@ declare function createTenantsModule(options: TenantsModuleOptions): {
 type TenantsModule = ReturnType<typeof createTenantsModule>;
 
 /**
- * WS-only event payload registry — single source of truth for the four
+ * WS-only event payload registry — single source of truth for the six
  * WS-only events that have no REST/openapi counterpart and therefore no
  * orval → _generated pipeline:
  *
- *   typing:indicator  ·  message:read:update  ·  participant:joined  ·  participant:left
+ *   typing:indicator  ·  message:read:update  ·  participant:joined  ·
+ *   participant:left  ·  participant:added  ·  participant:removed
  *
  * The runtime constant {@link WS_EVENT_REGISTRY} must stay byte-identical with
  * ws-event-shapes.fixture.json. Two contract tests enforce this:
@@ -1087,6 +1269,28 @@ interface ParticipantPayload {
     actor: unknown;
     [key: string]: unknown;
 }
+/**
+ * Payload for the `participant:added` server → client event (F10/T08).
+ * Emitted when an agent is added to a conversation's participant set — a
+ * server-side membership mutation, distinct from the `participant:joined`
+ * presence event.
+ */
+interface ParticipantAddedPayload {
+    conversationId: string;
+    agentId: string;
+    role: string;
+    [key: string]: unknown;
+}
+/**
+ * Payload for the `participant:removed` server → client event (F10/T08).
+ * Emitted when an agent is removed from a conversation's participant set; the
+ * removed agent's sockets are also force-evicted from the room server-side.
+ */
+interface ParticipantRemovedPayload {
+    conversationId: string;
+    agentId: string;
+    [key: string]: unknown;
+}
 
 /**
  * WebSocket client — hand-written typed wrapper over socket.io-client.
@@ -1160,6 +1364,8 @@ interface WsEventPayloads {
     'message:read:update': MessageReadUpdatePayload;
     'participant:joined': ParticipantPayload;
     'participant:left': ParticipantPayload;
+    'participant:added': ParticipantAddedPayload;
+    'participant:removed': ParticipantRemovedPayload;
     'typing:indicator': TypingIndicatorPayload;
 }
 /** The WebSocket client returned by {@link createWsClient}. */
@@ -1291,14 +1497,19 @@ declare function createOmnivoxClient(options: OmnivoxClientOptions): {
     };
     conversations: {
         reopenOrCreate(input: ReopenOrCreateInput): Promise<ConversationItem>;
-        list(opts?: ConversationListOpts): Promise<PagedList$3<ConversationItem>>;
+        list(opts?: ConversationListOpts): Promise<PagedList$3<ConversationListItem>>;
         updateStatus(id: string, input: UpdateStatusInput): Promise<ConversationItem>;
         assign(id: string, input: AssignInput): Promise<ConversationItem>;
         listLobby(opts?: LobbyListOpts): Promise<PagedList$3<LobbyEntry>>;
-        get(id: string): Promise<ConversationItem>;
+        get(id: string): Promise<ConversationListItem>;
         pickup(entryId: string, input: PickupInput): Promise<PickupResult>;
         whatsappRecoveryOptions(id: string): Promise<WhatsAppRecoveryOption[]>;
     };
+    participants: {
+        add(conversationId: string, input: AddParticipantInput): Promise<ParticipantItem>;
+        remove(conversationId: string, agentId: string): Promise<RemoveParticipantResult>;
+        list(conversationId: string): Promise<ParticipantItem[]>;
+    };
     messages: {
         send(input: SendMessageInput): Promise<MessageItem>;
         list(opts: MessageListOpts): Promise<PagedList$4<MessageItem>>;
@@ -1344,6 +1555,13 @@ declare function createOmnivoxClient(options: OmnivoxClientOptions): {
             name: string;
         }): Promise<WhatsAppBusinessAccountItem>;
     };
+    dashboard: {
+        stats(): Promise<DashboardStats>;
+        recentActivity(opts?: RecentActivityListOpts): Promise<PagedList$6<RecentActivityItem>>;
+    };
+    audit: {
+        list(opts?: AuditListOpts): Promise<PagedList$7<AuditEntry>>;
+    };
     /**
      * Creates a WebSocket client connected to the `/ws/chat` namespace.
      *
@@ -1639,6 +1857,76 @@ declare function createChannelsModule(options: ChannelsModuleOptions): {
 /** Return type of createChannelsModule. */
 type ChannelsModule = ReturnType<typeof createChannelsModule>;
 
+/**
+ * Conversation participants module — hand-written typed wrapper over the
+ * generated client (F10/T09).
+ *
+ * Exposes the participant-management surface for the conversations resource:
+ *   - add(conversationId, input)       → POST   /api/v1/conversations/:id/participants
+ *   - remove(conversationId, agentId)  → DELETE /api/v1/conversations/:id/participants/:agentId
+ *   - list(conversationId)             → GET    /api/v1/conversations/:id/participants
+ *
+ * All three routes are guarded server-side by CASL abilities (grant for
+ * add/remove, read for list) — a 403 surfaces as an {@link OmnivoxRequestError}
+ * with `status === 403` like any other rejected request.
+ *
+ * Never re-exports symbols from _generated/.
+ * Contains no business logic — typed transport only.
+ */
+
+/** Options to construct the participants module. */
+interface ParticipantsModuleOptions extends TokenProvider {
+    /** Base URL of the Omnivox API (e.g. "https://api.omnivox.io"). */
+    baseUrl: string;
+}
+/** A conversation participant's per-conversation role. */
+type ParticipantRole = 'OWNER' | 'AGENT' | 'VIEWER';
+/** Input for adding (or re-adding) a participant. */
+interface AddParticipantInput {
+    agentId: string;
+    role: ParticipantRole;
+    [key: string]: unknown;
+}
+/** Participant resource shape returned by the API (no tenantId leak). */
+interface ParticipantItem {
+    id: string;
+    conversationId: string;
+    agentId: string;
+    role: ParticipantRole;
+    joinedAt: string;
+    leftAt: string | null;
+    [key: string]: unknown;
+}
+/** Result of removing a participant — the number of memberships ended (0 or 1). */
+interface RemoveParticipantResult {
+    removed: number;
+}
+/**
+ * Creates the participants module — a thin typed wrapper over the generated client.
+ */
+declare function createParticipantsModule(options: ParticipantsModuleOptions): {
+    /**
+     * Add (or re-add) an agent as a conversation participant with a role.
+     * Idempotent per active membership — re-adding an active participant
+     * updates its role; a second OWNER co-owns (no demotion of other owners).
+     * Calls POST /api/v1/conversations/:id/participants.
+     */
+    add(conversationId: string, input: AddParticipantInput): Promise<ParticipantItem>;
+    /**
+     * End an active membership for an agent. Idempotent — removing a
+     * non-participant is a no-op ({ removed: 0 }).
+     * Calls DELETE /api/v1/conversations/:id/participants/:agentId.
+     */
+    remove(conversationId: string, agentId: string): Promise<RemoveParticipantResult>;
+    /**
+     * List the ACTIVE (leftAt IS NULL) participants of a conversation.
+     * Calls GET /api/v1/conversations/:id/participants.
+     */
+    list(conversationId: string): Promise<ParticipantItem[]>;
+};
+/** Return type of createParticipantsModule. */
+type ParticipantsModule = ReturnType<typeof createParticipantsModule>;
+
 /**
  * Attachments module — hand-written typed wrapper over the generated client.
  *
@@ -1807,4 +2095,4 @@ declare function createWhatsAppBusinessAccountsModule(options: WhatsAppBusinessA
 /** Return type of createWhatsAppBusinessAccountsModule. */
 type WhatsAppBusinessAccountsModule = ReturnType<typeof createWhatsAppBusinessAccountsModule>;
 
-export { type AddIdentityInput, type AgentItem, type AgentsModule, type AgentsModuleOptions, type ApiKeyItem, type AssignInput, type AttachmentUploadResult, type AttachmentUrlResult, type AttachmentsModule, type AttachmentsModuleOptions, type AuthMeAgent, type AuthMeModule, type AuthMeModuleOptions, type AuthMeResponse, type AuthMeTenant, type AuthorDraftInput, type BasicEmailChannelConfig, type BasicEmailChannelSecret, type CannedResponseItem, type CannedResponseListOpts, type CannedResponseSearchOpts, type CannedResponsesModule, type CannedResponsesModuleOptions, type Channel, type ChannelListItem, type ChannelStatus, type ChannelType, type ChannelsModule, type ChannelsModuleOptions, type ContactChannel, type ContactConversationSummary, type ContactFieldDefinition, type ContactFieldValue, type ContactFieldValueInput, type ContactIdentity, type ContactIdentityInput, type ContactItem, type ContactSearchOpts, type ContactTag, type ContactsMetadata, type ContactsModule, type ContactsModuleOptions, type ConversationItem, type ConversationListOpts, type ConversationsModule, type ConversationsModuleOptions, type CreateAgentInput, type CreateApiKeyInput, type CreateApiKeyResponse, type CreateCannedResponseInput, type CreateChannelBody, type CreateContactInput, type CreateEmailChannelBody, type CreateEmailTemplateInput, type CreateWhatsAppBusinessAccountBody, type CreateWhatsAppChannelBody, type CredentialsMode, type EmailChannelConfig, type EmailChannelSecret, type EmailImapConfig, type EmailSmtpConfig, type EmailTemplateItem, type EmailTemplateListOpts, type ImportApprovedResult, type ImportedTemplateResult, type LobbyEntry, type LobbyListOpts, type MessageItem, type MessageListOpts, type MessageReadUpdatePayload, type MessageStatusPayload, type MessagesModule, type MessagesModuleOptions, type OAuth2CertificateEmailChannelSecret, type OAuth2ClientSecretEmailChannelSecret, type OAuth2EmailChannelConfig, type OAuth2EmailChannelSecret, type OmnivoxClient, type OmnivoxClientOptions, OmnivoxRequestError, type PageOpts, type PageParams, type PagedResponse, type ParticipantPayload, type PatchContactInput, type PatchEmailTemplateInput, type PickupInput, type ReopenOrCreateInput, type RevokeApiKeyResponse, type SendMessageInput, type SendTemplateInput, type SubmitResult, type TemplatesModule, type TemplatesModuleOptions, type TenantsModule, type TenantsModuleOptions, type TokenProvider, type TypingIndicatorPayload, type UpdateCannedResponseInput, type UpdateChannelBody, type UpdateStatusInput, type UpdateWhatsAppTemplateInput, type WhatsAppBusinessAccountItem, type WhatsAppBusinessAccountsModule, type WhatsAppBusinessAccountsModuleOptions, type WhatsAppChannelConfig, type WhatsAppRecoveryOption, type WhatsAppTemplateDetail, type WhatsAppTemplateHistory, type WhatsAppTemplateHistoryEvent, type WhatsAppTemplateHistoryVersion, type WhatsAppTemplateItem, type WhatsAppTemplateListOpts, type WsAuth, type WsClient, type WsClientInstance, type WsClientOptions, type WsConnectionState, type WsEventPayloads, buildPageParams, createAgentsModule, createApiKeyTokenProvider, createAttachmentsModule, createAuthMeModule, createCannedResponsesModule, createChannelsModule, createContactsModule, createConversationsModule, createMessagesModule, createOmnivoxClient, createSessionTokenProvider, createTemplatesModule, createTenantsModule, createWhatsAppBusinessAccountsModule, createWsClient, iteratePages };
+export { type AddIdentityInput, type AddParticipantInput, type AgentItem, type AgentsModule, type AgentsModuleOptions, type ApiKeyItem, type AssignInput, type AttachmentUploadResult, type AttachmentUrlResult, type AttachmentsModule, type AttachmentsModuleOptions, type AuditEntry, type AuditListOpts, type AuditModule, type AuditModuleOptions, type AuthMeAgent, type AuthMeModule, type AuthMeModuleOptions, type AuthMeResponse, type AuthMeTenant, type AuthorDraftInput, type BasicEmailChannelConfig, type BasicEmailChannelSecret, type CannedResponseItem, type CannedResponseListOpts, type CannedResponseSearchOpts, type CannedResponsesModule, type CannedResponsesModuleOptions, type Channel, type ChannelListItem, type ChannelStatus, type ChannelType, type ChannelsModule, type ChannelsModuleOptions, type ContactChannel, type ContactConversationSummary, type ContactFieldDefinition, type ContactFieldValue, type ContactFieldValueInput, type ContactIdentity, type ContactIdentityInput, type ContactItem, type ContactSearchOpts, type ContactTag, type ContactsMetadata, type ContactsModule, type ContactsModuleOptions, type ConversationItem, type ConversationListItem, type ConversationListOpts, type ConversationsModule, type ConversationsModuleOptions, type CreateAgentInput, type CreateApiKeyInput, type CreateApiKeyResponse, type CreateCannedResponseInput, type CreateChannelBody, type CreateContactInput, type CreateEmailChannelBody, type CreateEmailTemplateInput, type CreateWhatsAppBusinessAccountBody, type CreateWhatsAppChannelBody, type CredentialsMode, type DashboardModule, type DashboardModuleOptions, type DashboardStats, type EmailChannelConfig, type EmailChannelSecret, type EmailImapConfig, type EmailSmtpConfig, type EmailTemplateItem, type EmailTemplateListOpts, type ImportApprovedResult, type ImportedTemplateResult, type LobbyEntry, type LobbyListOpts, type MessageItem, type MessageListOpts, type MessageReadUpdatePayload, type MessageStatusPayload, type MessagesModule, type MessagesModuleOptions, type OAuth2CertificateEmailChannelSecret, type OAuth2ClientSecretEmailChannelSecret, type OAuth2EmailChannelConfig, type OAuth2EmailChannelSecret, type OmnivoxClient, type OmnivoxClientOptions, OmnivoxRequestError, type PageOpts, type PageParams, type PagedResponse, type ParticipantAddedPayload, type ParticipantItem, type ParticipantPayload, type ParticipantRemovedPayload, type ParticipantRole, type ParticipantsModule, type ParticipantsModuleOptions, type PatchContactInput, type PatchEmailTemplateInput, type PickupInput, type RecentActivityItem, type RecentActivityListOpts, type RemoveParticipantResult, type ReopenOrCreateInput, type RevokeApiKeyResponse, type SendMessageInput, type SendTemplateInput, type SubmitResult, type TemplatesModule, type TemplatesModuleOptions, type TenantsModule, type TenantsModuleOptions, type TokenProvider, type TypingIndicatorPayload, type UpdateCannedResponseInput, type UpdateChannelBody, type UpdateStatusInput, type UpdateWhatsAppTemplateInput, type WhatsAppBusinessAccountItem, type WhatsAppBusinessAccountsModule, type WhatsAppBusinessAccountsModuleOptions, type WhatsAppChannelConfig, type WhatsAppRecoveryOption, type WhatsAppTemplateDetail, type WhatsAppTemplateHistory, type WhatsAppTemplateHistoryEvent, type WhatsAppTemplateHistoryVersion, type WhatsAppTemplateItem, type WhatsAppTemplateListOpts, type WsAuth, type WsClient, type WsClientInstance, type WsClientOptions, type WsConnectionState, type WsEventPayloads, buildPageParams, createAgentsModule, createApiKeyTokenProvider, createAttachmentsModule, createAuditModule, createAuthMeModule, createCannedResponsesModule, createChannelsModule, createContactsModule, createConversationsModule, createDashboardModule, createMessagesModule, createOmnivoxClient, createParticipantsModule, createSessionTokenProvider, createTemplatesModule, createTenantsModule, createWhatsAppBusinessAccountsModule, createWsClient, iteratePages };

package/dist/index.js

@@ -117,6 +117,15 @@ var getConversationsControllerUpdateStatusUrl = (id) => {
 var getConversationsControllerAssignUrl = (id) => {
   return `/api/v1/conversations/${id}/assign`;
 };
+var getConversationsControllerAddParticipantUrl = (id) => {
+  return `/api/v1/conversations/${id}/participants`;
+};
+var getConversationsControllerListParticipantsUrl = (id) => {
+  return `/api/v1/conversations/${id}/participants`;
+};
+var getConversationsControllerRemoveParticipantUrl = (id, agentId) => {
+  return `/api/v1/conversations/${id}/participants/${agentId}`;
+};
 var getConversationsControllerListLobbyUrl = (params) => {
   const normalizedParams = new URLSearchParams();
   Object.entries(params || {}).forEach(([key, value]) => {
@@ -286,6 +295,29 @@ var getAttachmentsControllerUploadUrl = () => {
 var getAttachmentsControllerGetDownloadUrlUrl = (id) => {
   return `/api/v1/attachments/${id}/url`;
 };
+var getDashboardControllerGetStatsUrl = () => {
+  return `/api/v1/dashboard/stats`;
+};
+var getDashboardControllerGetRecentActivityUrl = (params) => {
+  const normalizedParams = new URLSearchParams();
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== void 0) {
+      normalizedParams.append(key, value === null ? "null" : String(value));
+    }
+  });
+  const stringifiedParams = normalizedParams.toString();
+  return stringifiedParams.length > 0 ? `/api/v1/dashboard/recent-activity?${stringifiedParams}` : `/api/v1/dashboard/recent-activity`;
+};
+var getAuditLogControllerListUrl = (params) => {
+  const normalizedParams = new URLSearchParams();
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== void 0) {
+      normalizedParams.append(key, value === null ? "null" : String(value));
+    }
+  });
+  const stringifiedParams = normalizedParams.toString();
+  return stringifiedParams.length > 0 ? `/api/v1/audit-log?${stringifiedParams}` : `/api/v1/audit-log`;
+};
 
 // src/pagination/pagination.ts
 var MAX_PAGE_SIZE = 100;
@@ -702,6 +734,60 @@ function createConversationsModule(options) {
   };
 }
 
+// src/conversations/participants.ts
+function createParticipantsModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit(method, body) {
+    return {
+      method,
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    };
+  }
+  return {
+    /**
+     * Add (or re-add) an agent as a conversation participant with a role.
+     * Idempotent per active membership — re-adding an active participant
+     * updates its role; a second OWNER co-owns (no demotion of other owners).
+     * Calls POST /api/v1/conversations/:id/participants.
+     */
+    async add(conversationId, input) {
+      const path = getConversationsControllerAddParticipantUrl(conversationId);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("POST", input));
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * End an active membership for an agent. Idempotent — removing a
+     * non-participant is a no-op ({ removed: 0 }).
+     * Calls DELETE /api/v1/conversations/:id/participants/:agentId.
+     */
+    async remove(conversationId, agentId) {
+      const path = getConversationsControllerRemoveParticipantUrl(
+        conversationId,
+        agentId
+      );
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("DELETE"));
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * List the ACTIVE (leftAt IS NULL) participants of a conversation.
+     * Calls GET /api/v1/conversations/:id/participants.
+     */
+    async list(conversationId) {
+      const path = getConversationsControllerListParticipantsUrl(conversationId);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("GET"));
+      return parseEnvelopedResponse(res);
+    }
+  };
+}
+
 // src/messages/messages.ts
 function createMessagesModule(options) {
   const baseUrl = options.baseUrl;
@@ -1197,6 +1283,89 @@ function createWhatsAppBusinessAccountsModule(options) {
   };
 }
 
+// src/dashboard/dashboard.ts
+function createDashboardModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit() {
+    return {
+      method: "GET",
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      }
+    };
+  }
+  return {
+    /**
+     * Fetch the tenant dashboard KPIs.
+     * Calls GET /api/v1/dashboard/stats.
+     */
+    async stats() {
+      const path = getDashboardControllerGetStatsUrl();
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * List the tenant's recent conversation/message activity feed
+     * (newest first, paginated). pageSize is clamped to 100 per the API
+     * contract. Calls GET /api/v1/dashboard/recent-activity.
+     */
+    async recentActivity(opts = { page: 1, pageSize: 25 }) {
+      const { page, pageSize } = buildPageParams(opts);
+      const path = getDashboardControllerGetRecentActivityUrl({
+        page,
+        pageSize
+      });
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseResponse(res);
+    }
+  };
+}
+
+// src/audit/audit.ts
+function createAuditModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit() {
+    return {
+      method: "GET",
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      }
+    };
+  }
+  return {
+    /**
+     * List the tenant audit trail (newest first, paginated).
+     * pageSize is clamped to 100 per the API contract.
+     * Calls GET /api/v1/audit-log.
+     */
+    async list(opts = {}) {
+      const { page, pageSize } = buildPageParams({
+        page: opts.page ?? 1,
+        pageSize: opts.pageSize ?? 25
+      });
+      const params = {
+        ...opts.resourceType !== void 0 ? { resourceType: opts.resourceType } : {},
+        ...opts.resourceId !== void 0 ? { resourceId: opts.resourceId } : {},
+        ...opts.actorId !== void 0 ? { actorId: opts.actorId } : {},
+        ...opts.from !== void 0 ? { from: opts.from } : {},
+        ...opts.to !== void 0 ? { to: opts.to } : {},
+        page,
+        pageSize
+      };
+      const path = getAuditLogControllerListUrl(params);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseResponse(res);
+    }
+  };
+}
+
 // src/ws/ws-client.ts
 import { io } from "socket.io-client";
 function createWsClient(options) {
@@ -1287,11 +1456,14 @@ function createOmnivoxClient(options) {
     channels: createChannelsModule(moduleOptions),
     contacts: createContactsModule(moduleOptions),
     conversations: createConversationsModule(moduleOptions),
+    participants: createParticipantsModule(moduleOptions),
     messages: createMessagesModule(moduleOptions),
     templates: createTemplatesModule(moduleOptions),
     cannedResponses: createCannedResponsesModule(moduleOptions),
     attachments: createAttachmentsModule(moduleOptions),
     whatsappBusinessAccounts: createWhatsAppBusinessAccountsModule(moduleOptions),
+    dashboard: createDashboardModule(moduleOptions),
+    audit: createAuditModule(moduleOptions),
     /**
      * Creates a WebSocket client connected to the `/ws/chat` namespace.
      *
@@ -1346,13 +1518,16 @@ export {
   createAgentsModule,
   createApiKeyTokenProvider,
   createAttachmentsModule,
+  createAuditModule,
   createAuthMeModule,
   createCannedResponsesModule,
   createChannelsModule,
   createContactsModule,
   createConversationsModule,
+  createDashboardModule,
   createMessagesModule,
   createOmnivoxClient,
+  createParticipantsModule,
   createSessionTokenProvider,
   createTemplatesModule,
   createTenantsModule,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digisglobal/omnivox-sdk",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {