@bpmsoftwaresolutions/ai-engine-client 1.1.50 → 1.1.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.50",
+  "version": "1.1.51",
   "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.50';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.51';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -439,6 +439,13 @@ export class AIEngineClient {
       createHandoff: (request) => this.createCommunicationHandoff(request),
       acceptHandoff: (request) => this.acceptCommunicationHandoff(request),
     };
+    this.collaboration = {
+      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),
+    };
   }
 
   static fromEnv(options = {}) {
@@ -628,6 +635,232 @@ export class AIEngineClient {
     return this._request('/api/agent-communications/deployment-capabilities');
   }
 
+  async reviewCollaborationProposal({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    collaborationProposalId,
+    collaboration_proposal_id,
+    proposalId,
+    proposal_id,
+    decision = 'accept',
+    nextOwner,
+    next_owner,
+    phase,
+    currentPhase,
+    current_phase,
+    decisionReason,
+    decision_reason,
+    evidenceRefs = [],
+    evidence_refs = [],
+    reviewerRole,
+    reviewer_role,
+    reviewerAgentSessionId,
+    reviewer_agent_session_id,
+    reviewerActorSessionId,
+    reviewer_actor_session_id,
+    reviewedByClaimId,
+    reviewed_by_claim_id,
+    metadata = {},
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channelId);
+    if (!normalizedTransferChannelId) throw new Error('transfer_channel_id is required.');
+    const normalizedProposalId = cleanText(collaboration_proposal_id) || cleanText(collaborationProposalId) || cleanText(proposal_id) || cleanText(proposalId);
+    if (!normalizedProposalId) throw new Error('collaboration_proposal_id is required.');
+    return this._request(`/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/collaboration/review-proposal`, {
+      method: 'POST',
+      body: {
+        collaboration_proposal_id: normalizedProposalId,
+        decision: cleanText(decision) || 'accept',
+        next_owner: cleanText(next_owner) || cleanText(nextOwner),
+        phase: cleanText(current_phase) || cleanText(currentPhase) || cleanText(phase),
+        decision_reason: cleanText(decision_reason) || cleanText(decisionReason),
+        evidence_refs: Array.isArray(evidence_refs) ? evidence_refs : evidenceRefs,
+        reviewer_role: cleanText(reviewer_role) || cleanText(reviewerRole),
+        reviewer_agent_session_id: cleanText(reviewer_agent_session_id) || cleanText(reviewerAgentSessionId),
+        reviewer_actor_session_id: cleanText(reviewer_actor_session_id) || cleanText(reviewerActorSessionId),
+        reviewed_by_claim_id: cleanText(reviewed_by_claim_id) || cleanText(reviewedByClaimId),
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
+  async reviseCollaborationProposal({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    collaborationProposalId,
+    collaboration_proposal_id,
+    proposalId,
+    proposal_id,
+    proposalSummary,
+    proposal_summary,
+    nextOwner,
+    next_owner,
+    phase,
+    currentPhase,
+    current_phase,
+    revisionReason,
+    revision_reason,
+    evidenceRefs = [],
+    evidence_refs = [],
+    reviewerRole,
+    reviewer_role,
+    reviewerAgentSessionId,
+    reviewer_agent_session_id,
+    reviewerActorSessionId,
+    reviewer_actor_session_id,
+    metadata = {},
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channelId);
+    if (!normalizedTransferChannelId) throw new Error('transfer_channel_id is required.');
+    const normalizedProposalId = cleanText(collaboration_proposal_id) || cleanText(collaborationProposalId) || cleanText(proposal_id) || cleanText(proposalId);
+    if (!normalizedProposalId) throw new Error('collaboration_proposal_id is required.');
+    return this._request(`/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/collaboration/revise-proposal`, {
+      method: 'POST',
+      body: {
+        collaboration_proposal_id: normalizedProposalId,
+        proposal_summary: cleanText(proposal_summary) || cleanText(proposalSummary),
+        next_owner: cleanText(next_owner) || cleanText(nextOwner),
+        phase: cleanText(current_phase) || cleanText(currentPhase) || cleanText(phase),
+        revision_reason: cleanText(revision_reason) || cleanText(revisionReason),
+        evidence_refs: Array.isArray(evidence_refs) ? evidence_refs : evidenceRefs,
+        reviewer_role: cleanText(reviewer_role) || cleanText(reviewerRole),
+        reviewer_agent_session_id: cleanText(reviewer_agent_session_id) || cleanText(reviewerAgentSessionId),
+        reviewer_actor_session_id: cleanText(reviewer_actor_session_id) || cleanText(reviewerActorSessionId),
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
+  async raiseCollaborationBlocker({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    blockerKind,
+    blocker_kind,
+    blockerSummary,
+    blocker_summary,
+    blockedSide,
+    blocked_side,
+    blockerDetails,
+    blocker_details,
+    expectedNextUpdate,
+    expected_next_update,
+    participantRole,
+    participant_role,
+    nextOwner,
+    next_owner,
+    phase,
+    currentPhase,
+    current_phase,
+    reviewerAgentSessionId,
+    reviewer_agent_session_id,
+    reviewerActorSessionId,
+    reviewer_actor_session_id,
+    metadata = {},
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channelId);
+    if (!normalizedTransferChannelId) throw new Error('transfer_channel_id is required.');
+    return this._request(`/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/collaboration/raise-blocker`, {
+      method: 'POST',
+      body: {
+        blocker_kind: cleanText(blocker_kind) || cleanText(blockerKind),
+        blocker_summary: cleanText(blocker_summary) || cleanText(blockerSummary),
+        blocked_side: cleanText(blocked_side) || cleanText(blockedSide),
+        blocker_details: cleanText(blocker_details) || cleanText(blockerDetails),
+        expected_next_update: cleanText(expected_next_update) || cleanText(expectedNextUpdate),
+        participant_role: cleanText(participant_role) || cleanText(participantRole),
+        next_owner: cleanText(next_owner) || cleanText(nextOwner),
+        phase: cleanText(current_phase) || cleanText(currentPhase) || cleanText(phase),
+        reviewer_agent_session_id: cleanText(reviewer_agent_session_id) || cleanText(reviewerAgentSessionId),
+        reviewer_actor_session_id: cleanText(reviewer_actor_session_id) || cleanText(reviewerActorSessionId),
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
+  async beginCollaborationImplementation({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    participantRole,
+    participant_role,
+    ownerLabel,
+    owner_label,
+    ownerRoleKey,
+    owner_role_key,
+    expectedUpdateCadence,
+    expected_update_cadence,
+    phase,
+    currentPhase,
+    current_phase,
+    currentTaskSummary,
+    current_task_summary,
+    ownerAgentSessionId,
+    owner_agent_session_id,
+    ownerActorSessionId,
+    owner_actor_session_id,
+    assignedByAgentSessionId,
+    assigned_by_agent_session_id,
+    assignedByActorSessionId,
+    assigned_by_actor_session_id,
+    metadata = {},
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channelId);
+    if (!normalizedTransferChannelId) throw new Error('transfer_channel_id is required.');
+    return this._request(`/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/collaboration/begin-implementation`, {
+      method: 'POST',
+      body: {
+        participant_role: cleanText(participant_role) || cleanText(participantRole) || cleanText(owner_role_key) || cleanText(ownerRoleKey),
+        owner_label: cleanText(owner_label) || cleanText(ownerLabel) || cleanText(owner_role_key) || cleanText(ownerRoleKey),
+        expected_update_cadence: cleanText(expected_update_cadence) || cleanText(expectedUpdateCadence),
+        phase: cleanText(current_phase) || cleanText(currentPhase) || cleanText(phase),
+        current_task_summary: cleanText(current_task_summary) || cleanText(currentTaskSummary),
+        owner_agent_session_id: cleanText(owner_agent_session_id) || cleanText(ownerAgentSessionId),
+        owner_actor_session_id: cleanText(owner_actor_session_id) || cleanText(ownerActorSessionId),
+        assigned_by_agent_session_id: cleanText(assigned_by_agent_session_id) || cleanText(assignedByAgentSessionId),
+        assigned_by_actor_session_id: cleanText(assigned_by_actor_session_id) || cleanText(assignedByActorSessionId),
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
+  async requestCollaborationClosure({
+    transferChannelId,
+    transfer_channel_id,
+    channelId,
+    senderAgentSessionId,
+    sender_agent_session_id,
+    senderActorSessionId,
+    sender_actor_session_id,
+    closureReason,
+    closure_reason,
+    evidenceRefs = [],
+    evidence_refs = [],
+    failureReason,
+    failure_reason,
+    phase,
+    currentPhase,
+    current_phase,
+    metadata = {},
+  } = {}) {
+    const normalizedTransferChannelId = cleanText(transfer_channel_id) || cleanText(transferChannelId) || cleanText(channelId);
+    if (!normalizedTransferChannelId) throw new Error('transfer_channel_id is required.');
+    return this._request(`/api/agent-communications/transfer-channels/${encodeURIComponent(normalizedTransferChannelId)}/collaboration/request-closure`, {
+      method: 'POST',
+      body: {
+        sender_agent_session_id: cleanText(sender_agent_session_id) || cleanText(senderAgentSessionId),
+        sender_actor_session_id: cleanText(sender_actor_session_id) || cleanText(senderActorSessionId),
+        closure_reason: cleanText(closure_reason) || cleanText(closureReason),
+        evidence_refs: Array.isArray(evidence_refs) ? evidence_refs : evidenceRefs,
+        failure_reason: cleanText(failure_reason) || cleanText(failureReason),
+        phase: cleanText(current_phase) || cleanText(currentPhase) || cleanText(phase),
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
   async bootstrapCommunication() {
     return this._request('/api/agent-communications/bootstrap');
   }