@bpmsoftwaresolutions/ai-engine-client 1.1.52 → 1.1.54

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.52",
+  "version": "1.1.54",
   "description": "Thin npm client for the AI Engine operator and retrieval APIs",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -1,5 +1,5 @@
 const DEFAULT_TIMEOUT_MS = 30000;
-export const AI_ENGINE_CLIENT_VERSION = '1.1.52';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.54';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -438,15 +438,27 @@ export class AIEngineClient {
       attachEvidence: (request) => this.attachCommunicationMessageEvidence(request),
       createHandoff: (request) => this.createCommunicationHandoff(request),
       acceptHandoff: (request) => this.acceptCommunicationHandoff(request),
+      whoIsOnline: (request) => this.whoIsOnline(request),
+      findOnlineParticipant: (request) => this.findOnlineParticipant(request),
+      sendToParticipant: (request) => this.sendToParticipant(request),
+      sendToRole: (request) => this.sendToRole(request),
+      getMyInbox: (request) => this.getMyInbox(request),
       connectToTransferChannel: (request) => this.connectToTransferChannel(request),
+      respondToMessageWatch: (request) => this.respondToMessageWatch(request),
     };
     this.collaboration = {
       connectToTransferChannel: (request) => this.connectToTransferChannel(request),
+      respondToMessageWatch: (request) => this.respondToMessageWatch(request),
       reviewProposal: (request) => this.reviewCollaborationProposal(request),
       reviseProposal: (request) => this.reviseCollaborationProposal(request),
       raiseBlocker: (request) => this.raiseCollaborationBlocker(request),
       beginImplementation: (request) => this.beginCollaborationImplementation(request),
       requestClosure: (request) => this.requestCollaborationClosure(request),
+      whoIsOnline: (request) => this.whoIsOnline(request),
+      findOnlineParticipant: (request) => this.findOnlineParticipant(request),
+      sendToParticipant: (request) => this.sendToParticipant(request),
+      sendToRole: (request) => this.sendToRole(request),
+      getMyInbox: (request) => this.getMyInbox(request),
     };
   }
 
@@ -653,8 +665,8 @@ export class AIEngineClient {
     current_phase,
     decisionReason,
     decision_reason,
-    evidenceRefs = [],
-    evidence_refs = [],
+    evidenceRefs,
+    evidence_refs,
     reviewerRole,
     reviewer_role,
     reviewerAgentSessionId,
@@ -738,7 +750,7 @@ export class AIEngineClient {
   } = {}) {
     const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channel_id) || cleanText(channelId);
     if (!normalizedTransferChannelId) throw new Error('transfer_channel_id is required.');
-    return this._request(`/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/collaboration/connect`, {
+    return this._request(`/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/connect`, {
       method: 'POST',
       body: {
         work_transfer_packet_id: cleanText(work_transfer_packet_id) || cleanText(workTransferPacketId) || cleanText(packet_id) || cleanText(packetId),
@@ -764,6 +776,53 @@ export class AIEngineClient {
     });
   }
 
+  async respondToMessageWatch({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    channel_id,
+    messageWatchId,
+    message_watch_id,
+    watchId,
+    watch_id,
+    expectedMessageKind,
+    expected_message_kind,
+    senderRole,
+    sender_role,
+    participantRole,
+    participant_role,
+    senderAgentSessionId,
+    sender_agent_session_id,
+    senderActorSessionId,
+    sender_actor_session_id,
+    messageKind,
+    message_kind,
+    bodyMarkdown,
+    body_markdown,
+    evidenceRefs,
+    evidence_refs,
+    payload = {},
+    metadata = {},
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channel_id) || cleanText(channelId);
+    if (!normalizedTransferChannelId) throw new Error('transfer_channel_id is required.');
+    return this._request(`/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/message-watches/respond`, {
+      method: 'POST',
+      body: {
+        message_watch_id: cleanText(message_watch_id) || cleanText(messageWatchId) || cleanText(watch_id) || cleanText(watchId),
+        expected_message_kind: cleanText(expected_message_kind) || cleanText(expectedMessageKind),
+        sender_role: cleanText(sender_role) || cleanText(senderRole) || cleanText(participant_role) || cleanText(participantRole),
+        sender_agent_session_id: cleanText(sender_agent_session_id) || cleanText(senderAgentSessionId),
+        sender_actor_session_id: cleanText(sender_actor_session_id) || cleanText(senderActorSessionId),
+        message_kind: cleanText(message_kind) || cleanText(messageKind),
+        body_markdown: cleanText(body_markdown) || cleanText(bodyMarkdown),
+        evidence_refs: Array.isArray(evidence_refs) ? evidence_refs : Array.isArray(evidenceRefs) ? evidenceRefs : [],
+        payload: isPlainObject(payload) ? payload : {},
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
   async reviseCollaborationProposal({
     transferChannelId,
     transfer_channel_id,
@@ -1227,6 +1286,178 @@ export class AIEngineClient {
     });
   }
 
+  async getMyInbox({
+    recipientAgentSessionId,
+    recipient_agent_session_id,
+    recipientRoleKey,
+    recipient_role_key,
+    workflowRunId,
+    workflow_run_id,
+  } = {}) {
+    return this._request('/api/agent-communications/inbox/me', {
+      query: {
+        recipient_agent_session_id: cleanText(recipient_agent_session_id) || cleanText(recipientAgentSessionId),
+        recipient_role_key: cleanText(recipient_role_key) || cleanText(recipientRoleKey),
+        workflow_run_id: cleanText(workflow_run_id) || cleanText(workflowRunId),
+      },
+    });
+  }
+
+  async whoIsOnline({
+    workflowRunId,
+    workflow_run_id,
+    transferChannelId,
+    transfer_channel_id,
+    participantRole,
+    participant_role,
+    capability,
+    includeStale,
+    include_stale,
+    limit,
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId);
+    const basePath = normalizedTransferChannelId
+      ? `/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/presence`
+      : '/api/agent-communications/presence';
+    return this._request(basePath, {
+      query: {
+        workflow_run_id: cleanText(workflow_run_id) || cleanText(workflowRunId),
+        participant_role: cleanText(participant_role) || cleanText(participantRole),
+        capability: cleanText(capability),
+        include_stale: include_stale ?? includeStale,
+        limit,
+      },
+    });
+  }
+
+  async findOnlineParticipant({
+    workflowRunId,
+    workflow_run_id,
+    transferChannelId,
+    transfer_channel_id,
+    participantRole,
+    participant_role,
+    capability,
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId);
+    const body = {
+      workflow_run_id: cleanText(workflow_run_id) || cleanText(workflowRunId),
+      transfer_channel_id: normalizedTransferChannelId,
+      participant_role: cleanText(participant_role) || cleanText(participantRole),
+      capability: cleanText(capability),
+    };
+    const path = normalizedTransferChannelId
+      ? `/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/presence/find`
+      : '/api/agent-communications/presence/find';
+    return this._request(path, {
+      method: 'POST',
+      body,
+    });
+  }
+
+  async sendToParticipant({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    channel_id,
+    bodyMarkdown,
+    body_markdown,
+    senderAgentSessionId,
+    sender_agent_session_id,
+    senderRole,
+    sender_role,
+    recipientAgentSessionId,
+    recipient_agent_session_id,
+    recipientRole,
+    recipient_role,
+    participantId,
+    participant_id,
+    recipientParticipantId,
+    recipient_participant_id,
+    workflowRunId,
+    workflow_run_id,
+    messageKind,
+    message_kind,
+    payload = {},
+    scope = {},
+    metadata = {},
+    expectedMessageKind,
+    expected_message_kind,
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channel_id) || cleanText(channelId);
+    const path = normalizedTransferChannelId
+      ? `/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/messages/send-to-participant`
+      : '/api/agent-communications/messages/send-to-participant';
+    return this._request(path, {
+      method: 'POST',
+      body: {
+        transfer_channel_id: normalizedTransferChannelId,
+        workflow_run_id: cleanText(workflow_run_id) || cleanText(workflowRunId),
+        body_markdown: cleanText(body_markdown) || cleanText(bodyMarkdown),
+        sender_agent_session_id: cleanText(sender_agent_session_id) || cleanText(senderAgentSessionId),
+        sender_role: cleanText(sender_role) || cleanText(senderRole),
+        recipient_agent_session_id: cleanText(recipient_agent_session_id) || cleanText(recipientAgentSessionId),
+        recipient_role: cleanText(recipient_role) || cleanText(recipientRole),
+        participant_id: cleanText(participant_id) || cleanText(participantId) || cleanText(recipient_participant_id) || cleanText(recipientParticipantId),
+        message_kind: cleanText(message_kind) || cleanText(messageKind),
+        payload: isPlainObject(payload) ? payload : {},
+        scope: isPlainObject(scope) ? scope : {},
+        metadata: isPlainObject(metadata) ? metadata : {},
+        expected_message_kind: cleanText(expected_message_kind) || cleanText(expectedMessageKind),
+      },
+    });
+  }
+
+  async sendToRole({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    channel_id,
+    bodyMarkdown,
+    body_markdown,
+    senderAgentSessionId,
+    sender_agent_session_id,
+    senderRole,
+    sender_role,
+    recipientRole,
+    recipient_role,
+    participantRole,
+    participant_role,
+    recipientAgentSessionId,
+    recipient_agent_session_id,
+    workflowRunId,
+    workflow_run_id,
+    messageKind,
+    message_kind,
+    payload = {},
+    scope = {},
+    metadata = {},
+    expectedMessageKind,
+    expected_message_kind,
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channel_id) || cleanText(channelId);
+    const path = normalizedTransferChannelId
+      ? `/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/messages/send-to-role`
+      : '/api/agent-communications/messages/send-to-role';
+    return this._request(path, {
+      method: 'POST',
+      body: {
+        transfer_channel_id: normalizedTransferChannelId,
+        workflow_run_id: cleanText(workflow_run_id) || cleanText(workflowRunId),
+        body_markdown: cleanText(body_markdown) || cleanText(bodyMarkdown),
+        sender_agent_session_id: cleanText(sender_agent_session_id) || cleanText(senderAgentSessionId),
+        sender_role: cleanText(sender_role) || cleanText(senderRole),
+        recipient_agent_session_id: cleanText(recipient_agent_session_id) || cleanText(recipientAgentSessionId),
+        recipient_role: cleanText(recipient_role) || cleanText(recipientRole) || cleanText(participant_role) || cleanText(participantRole),
+        message_kind: cleanText(message_kind) || cleanText(messageKind),
+        payload: isPlainObject(payload) ? payload : {},
+        scope: isPlainObject(scope) ? scope : {},
+        metadata: isPlainObject(metadata) ? metadata : {},
+        expected_message_kind: cleanText(expected_message_kind) || cleanText(expectedMessageKind),
+      },
+    });
+  }
+
   async sendCommunicationMessage({
     communicationThreadId,
     communication_thread_id,