@bpmsoftwaresolutions/ai-engine-client 1.1.51 → 1.1.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.51",
+  "version": "1.1.53",
   "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.51';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.53';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -438,8 +438,10 @@ export class AIEngineClient {
       attachEvidence: (request) => this.attachCommunicationMessageEvidence(request),
       createHandoff: (request) => this.createCommunicationHandoff(request),
       acceptHandoff: (request) => this.acceptCommunicationHandoff(request),
+      connectToTransferChannel: (request) => this.connectToTransferChannel(request),
     };
     this.collaboration = {
+      connectToTransferChannel: (request) => this.connectToTransferChannel(request),
       reviewProposal: (request) => this.reviewCollaborationProposal(request),
       reviseProposal: (request) => this.reviseCollaborationProposal(request),
       raiseBlocker: (request) => this.raiseCollaborationBlocker(request),
@@ -685,6 +687,83 @@ export class AIEngineClient {
     });
   }
 
+  async connectToTransferChannel({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    channel_id,
+    workTransferPacketId,
+    work_transfer_packet_id,
+    packetId,
+    packet_id,
+    workflowRunId,
+    workflow_run_id,
+    participantRole,
+    participant_role,
+    expectedPeerRole,
+    expected_peer_role,
+    expectedMessageKind,
+    expected_message_kind,
+    proposalId,
+    proposal_id,
+    collaborationProposalId,
+    collaboration_proposal_id,
+    mode = 'communication_participant',
+    participantLabel,
+    participant_label,
+    participantRoleKey,
+    participant_role_key,
+    agentSessionId,
+    agent_session_id,
+    actorSessionId,
+    actor_session_id,
+    phase,
+    currentPhase,
+    current_phase,
+    currentTaskSummary,
+    current_task_summary,
+    expectedPayload = {},
+    expected_payload = {},
+    lastSeenMessageId,
+    last_seen_message_id,
+    lastCheckedAt,
+    last_checked_at,
+    staleAfterSeconds = 60,
+    stale_after_seconds,
+    operatorNudge,
+    operator_nudge,
+    observedAt,
+    observed_at,
+    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)}/connect`, {
+      method: 'POST',
+      body: {
+        work_transfer_packet_id: cleanText(work_transfer_packet_id) || cleanText(workTransferPacketId) || cleanText(packet_id) || cleanText(packetId),
+        workflow_run_id: cleanText(workflow_run_id) || cleanText(workflowRunId),
+        participant_role: cleanText(participant_role) || cleanText(participantRole),
+        expected_peer_role: cleanText(expected_peer_role) || cleanText(expectedPeerRole),
+        expected_message_kind: cleanText(expected_message_kind) || cleanText(expectedMessageKind),
+        proposal_id: cleanText(proposal_id) || cleanText(proposalId) || cleanText(collaboration_proposal_id) || cleanText(collaborationProposalId),
+        mode: cleanText(mode) || 'communication_participant',
+        participant_label: cleanText(participant_label) || cleanText(participantLabel) || cleanText(participant_role_key) || cleanText(participantRoleKey),
+        agent_session_id: cleanText(agent_session_id) || cleanText(agentSessionId),
+        actor_session_id: cleanText(actor_session_id) || cleanText(actorSessionId),
+        phase: cleanText(current_phase) || cleanText(currentPhase) || cleanText(phase),
+        current_task_summary: cleanText(current_task_summary) || cleanText(currentTaskSummary),
+        expected_payload: isPlainObject(expected_payload) ? expected_payload : isPlainObject(expectedPayload) ? expectedPayload : {},
+        last_seen_message_id: cleanText(last_seen_message_id) || cleanText(lastSeenMessageId),
+        last_checked_at: last_checked_at || lastCheckedAt,
+        stale_after_seconds: stale_after_seconds || staleAfterSeconds,
+        operator_nudge: cleanText(operator_nudge) || cleanText(operatorNudge),
+        observed_at: observed_at || observedAt,
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
   async reviseCollaborationProposal({
     transferChannelId,
     transfer_channel_id,