@bpmsoftwaresolutions/ai-engine-client 1.1.82 → 1.1.83

package/package.json

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

package/src/client.js

@@ -38,6 +38,7 @@ import { createSelfOptimizationDomain } from './domains/self-optimization.js';
 import { createSkillGovernanceDomain } from './domains/skill-governance.js';
 import { createSkillsDomain } from './domains/skills.js';
 import { createSearchContactsDomain } from './domains/search-contacts.js';
+import { createAgentCommunicationsFacade, createCollaborationFacade } from './compat/facades.js';
 import { createToolRegistryDomain } from './domains/tool-registry.js';
 import { createWorkflowCompositionDomain } from './domains/workflow-composition.js';
 import { createWarehouseDomain } from './domains/warehouse.js';
@@ -412,136 +413,8 @@ export class AIEngineClient {
     this.workflowComposition = createWorkflowCompositionDomain(this);
     this.warehouse = createWarehouseDomain(this);
     this.actions = createActionsDomain(this);
-    this.agentComms = {
-      openThread: (request) => this.openCommunicationThread(request),
-      getThread: (threadId) => this.getCommunicationThread(threadId),
-      listInbox: (request) => this.listCommunicationInbox(request),
-      sendMessage: (request) => this._sendAgentCommsMessage(request),
-      getCommunicationCapabilities: (request) => this.getCommunicationCapabilities(request),
-      getCollaborationCapabilities: (request) => this.getCollaborationCapabilities(request),
-      getDeploymentCapabilities: (request) => this.getDeploymentCapabilities(request),
-      bootstrap: (request) => this.bootstrapCommunication(request),
-      negotiateTransfer: (request) => this.negotiateCommunicationTransfer(request),
-      resolveCommunicationTarget: (request) => this.resolveCommunicationTarget(request),
-      createEvidencePacket: (request) => this.createCommunicationEvidencePacket(request),
-      transferWorkPacket: (request) => this.transferWorkPacket(request),
-      listFrictionTaxonomy: (request) => this.listCommunicationFrictionTaxonomy(request),
-      recordFrictionEvent: (request) => this.recordCommunicationFrictionEvent(request),
-      postCollaborationProposal: (request) => this.postCollaborationProposal(request),
-      assignCollaborationOwnership: (request) => this.assignCollaborationOwnership(request),
-      createTransferReceipt: (request) => this.recordCommunicationTransferReceipt(request),
-      acceptTransferPacket: (request) => this.acceptCommunicationTransferPacket(request),
-      closeTransferPacket: (request) => this.closeCommunicationTransferPacket(request),
-      getTransferHealth: (request) => this.getCommunicationTransferHealth(request),
-      openTransferChannel: (request) => this.openTransferChannel(request),
-      openAgentChannel: (request) => this.openAgentChannel(request),
-      joinTransferChannel: (request) => this.joinTransferChannel(request),
-      resumeTransferChannel: (request) => this.resumeTransferChannel(request),
-      replyToTransferChannel: (request) => this.replyToTransferChannel(request),
-      startMessageWatch: (request) => this.startMessageWatch(request),
-      acknowledgeExpectedMessage: (request) => this.acknowledgeExpectedMessage(request),
-      closeTransferChannel: (request) => this.closeTransferChannel(request),
-      establishAgentCommunicationChannel: (request) => this.establishAgentCommunicationChannel(request),
-      runInterAgentMessagingLoop: (request) => this.runInterAgentMessagingLoop(request),
-      createCrossAgentRemediationTicket: (request) => this.createCrossAgentRemediationTicket(request),
-      transferRefactoringBundle: (request) => this.transferRefactoringBundle(request),
-      acceptAgentChannel: (request) => this.acceptAgentChannel(request),
-      postAgentHeartbeat: (request) => this.postAgentHeartbeat(request),
-      postCollaborationHeartbeat: (request) => this.postCollaborationHeartbeat(request),
-      postAgentMessage: (request) => this.postAgentMessage(request),
-      acknowledgeAgentMessage: (request) => this.acknowledgeAgentMessage(request),
-      closeAgentChannel: (request) => this.closeAgentChannel(request),
-      createBundle: (request) => this.createCommunicationBundle(request),
-      getBundle: (bundleId) => this.getCommunicationBundle(bundleId),
-      listBundles: (request) => this.listCommunicationBundles(request),
-      addBundleItem: (request) => this.addCommunicationBundleItem(request),
-      uploadBundle: (request) => this.uploadCommunicationBundle(request),
-      attachBundleToMessage: (request) => this.attachCommunicationBundleToMessage(request),
-      recordBundleReceipt: (request) => this.recordCommunicationBundleReceipt(request),
-      recordBundleCleanupEvent: (request) => this.recordCommunicationBundleCleanupEvent(request),
-      claimBundle: (request) => this.claimCommunicationBundle(request),
-      acceptMessage: (messageId) => this.acceptCommunicationMessage(messageId),
-      respondWithEvidence: (request) => this.respondToCommunicationMessage(request),
-      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),
-      listCommunicationChannels: (request) => this.listCommunicationChannels(request),
-      listOpenCommunicationChannels: (request) => this.listOpenCommunicationChannels(request),
-      getCommunicationChannelStatus: (request) => this.getCommunicationChannelStatus(request),
-      getCommunicationChannelParticipants: (request) => this.getCommunicationChannelParticipants(request),
-      getPresenceBoard: (request) => this.getPresenceBoard(request),
-      getChannelPresence: (request) => this.getChannelPresence(request),
-      markParticipantOnline: (request) => this.markParticipantOnline(request),
-      markParticipantOffline: (request) => this.markParticipantOffline(request),
-      sendToParticipant: (request) => this.sendToParticipant(request),
-      sendToRole: (request) => this.sendToRole(request),
-      getMyInbox: (request) => this.getMyInbox(request),
-      verifyMessageSent: (request) => this.verifyMessageSent(request),
-      verifyMessageReceived: (request) => this.verifyMessageReceived(request),
-      getMessageDeliveryReceipt: (request) => this.getMessageDeliveryReceipt(request),
-      startCoordinationPingPong: (request) => this.startCoordinationPingPong(request),
-      sendCoordinationPing: (request) => this.sendCoordinationPing(request),
-      sendCoordinationPong: (request) => this.sendCoordinationPong(request),
-      getCoordinationPingPongStatus: (request) => this.getCoordinationPingPongStatus(request),
-      stopCoordinationPingPong: (request) => this.stopCoordinationPingPong(request),
-      checkCoordinationPingPongPreflight: (request) => this.checkCoordinationPingPongPreflight(request),
-      connectToTransferChannel: (request) => this.connectToTransferChannel(request),
-      startAgentConnection: (request) => this.startAgentConnection(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),
-      openTransferChannel: (request) => this.openTransferChannel(request),
-      openAgentChannel: (request) => this.openAgentChannel(request),
-      startAgentConnection: (request) => this.startAgentConnection(request),
-      joinTransferChannel: (request) => this.joinTransferChannel(request),
-      resumeTransferChannel: (request) => this.resumeTransferChannel(request),
-      replyToTransferChannel: (request) => this.replyToTransferChannel(request),
-      startMessageWatch: (request) => this.startMessageWatch(request),
-      acknowledgeExpectedMessage: (request) => this.acknowledgeExpectedMessage(request),
-      closeTransferChannel: (request) => this.closeTransferChannel(request),
-      establishAgentCommunicationChannel: (request) => this.establishAgentCommunicationChannel(request),
-      runInterAgentMessagingLoop: (request) => this.runInterAgentMessagingLoop(request),
-      createCrossAgentRemediationTicket: (request) => this.createCrossAgentRemediationTicket(request),
-      transferRefactoringBundle: (request) => this.transferRefactoringBundle(request),
-      acceptAgentChannel: (request) => this.acceptAgentChannel(request),
-      postAgentHeartbeat: (request) => this.postAgentHeartbeat(request),
-      postCollaborationHeartbeat: (request) => this.postCollaborationHeartbeat(request),
-      postAgentMessage: (request) => this.postAgentMessage(request),
-      acknowledgeAgentMessage: (request) => this.acknowledgeAgentMessage(request),
-      closeAgentChannel: (request) => this.closeAgentChannel(request),
-      whoIsOnline: (request) => this.whoIsOnline(request),
-      findOnlineParticipant: (request) => this.findOnlineParticipant(request),
-      listCommunicationChannels: (request) => this.listCommunicationChannels(request),
-      listOpenCommunicationChannels: (request) => this.listOpenCommunicationChannels(request),
-      getCommunicationChannelStatus: (request) => this.getCommunicationChannelStatus(request),
-      getCommunicationChannelParticipants: (request) => this.getCommunicationChannelParticipants(request),
-      getPresenceBoard: (request) => this.getPresenceBoard(request),
-      getChannelPresence: (request) => this.getChannelPresence(request),
-      markParticipantOnline: (request) => this.markParticipantOnline(request),
-      markParticipantOffline: (request) => this.markParticipantOffline(request),
-      sendToParticipant: (request) => this.sendToParticipant(request),
-      sendToRole: (request) => this.sendToRole(request),
-      getMyInbox: (request) => this.getMyInbox(request),
-      sendMessage: (request) => this._sendAgentCommsMessage(request),
-      verifyMessageSent: (request) => this.verifyMessageSent(request),
-      verifyMessageReceived: (request) => this.verifyMessageReceived(request),
-      getMessageDeliveryReceipt: (request) => this.getMessageDeliveryReceipt(request),
-      startCoordinationPingPong: (request) => this.startCoordinationPingPong(request),
-      sendCoordinationPing: (request) => this.sendCoordinationPing(request),
-      sendCoordinationPong: (request) => this.sendCoordinationPong(request),
-      getCoordinationPingPongStatus: (request) => this.getCoordinationPingPongStatus(request),
-      stopCoordinationPingPong: (request) => this.stopCoordinationPingPong(request),
-      checkCoordinationPingPongPreflight: (request) => this.checkCoordinationPingPongPreflight(request),
-    };
+    this.agentComms = createAgentCommunicationsFacade(this);
+    this.collaboration = createCollaborationFacade(this);
   }
 
   static fromEnv(options = {}) {

package/src/compat/aliases.js

@@ -0,0 +1,58 @@
+export const COMPATIBILITY_ALIAS_GROUPS = [
+  {
+    namespace: 'top-level',
+    aliases: [
+      'ping',
+      'query',
+      'getPortfolioClosureReadiness',
+      'registerModernizationAsset',
+      'classifyModernizationAsset',
+      'discoverSalvageCandidates',
+      'createModernizationWorkPacket',
+      'requestModernizationWrapperExecution',
+      'decideModernizationGate',
+    ],
+  },
+  {
+    namespace: 'warehouse',
+    aliases: [
+      'registerModernizationAsset',
+      'classifyModernizationAsset',
+      'discoverSalvageCandidates',
+      'createModernizationWorkPacket',
+      'requestModernizationWrapperExecution',
+      'getModernizationWrapperEvidence',
+      'decideModernizationGate',
+    ],
+  },
+  {
+    namespace: 'agentComms',
+    aliases: [
+      'openThread',
+      'sendMessage',
+      'openTransferChannel',
+      'startAgentConnection',
+      'startMessageWatch',
+      'postAgentHeartbeat',
+      'postCollaborationHeartbeat',
+      'closeTransferChannel',
+    ],
+  },
+  {
+    namespace: 'collaboration',
+    aliases: [
+      'reviewProposal',
+      'beginImplementation',
+      'requestClosure',
+      'connectToTransferChannel',
+      'respondToMessageWatch',
+    ],
+  },
+];
+
+export function listCompatibilityAliases() {
+  return COMPATIBILITY_ALIAS_GROUPS.map((group) => ({
+    namespace: group.namespace,
+    aliases: [...group.aliases],
+  }));
+}

package/src/compat/facades.js

@@ -0,0 +1,135 @@
+export function createAgentCommunicationsFacade(client) {
+  return {
+    openThread: (request) => client.openCommunicationThread(request),
+    getThread: (threadId) => client.getCommunicationThread(threadId),
+    listInbox: (request) => client.listCommunicationInbox(request),
+    sendMessage: (request) => client._sendAgentCommsMessage(request),
+    getCommunicationCapabilities: (request) => client.getCommunicationCapabilities(request),
+    getCollaborationCapabilities: (request) => client.getCollaborationCapabilities(request),
+    getDeploymentCapabilities: (request) => client.getDeploymentCapabilities(request),
+    bootstrap: (request) => client.bootstrapCommunication(request),
+    negotiateTransfer: (request) => client.negotiateCommunicationTransfer(request),
+    resolveCommunicationTarget: (request) => client.resolveCommunicationTarget(request),
+    createEvidencePacket: (request) => client.createCommunicationEvidencePacket(request),
+    transferWorkPacket: (request) => client.transferWorkPacket(request),
+    listFrictionTaxonomy: (request) => client.listCommunicationFrictionTaxonomy(request),
+    recordFrictionEvent: (request) => client.recordCommunicationFrictionEvent(request),
+    postCollaborationProposal: (request) => client.postCollaborationProposal(request),
+    assignCollaborationOwnership: (request) => client.assignCollaborationOwnership(request),
+    createTransferReceipt: (request) => client.recordCommunicationTransferReceipt(request),
+    acceptTransferPacket: (request) => client.acceptCommunicationTransferPacket(request),
+    closeTransferPacket: (request) => client.closeCommunicationTransferPacket(request),
+    getTransferHealth: (request) => client.getCommunicationTransferHealth(request),
+    openTransferChannel: (request) => client.openTransferChannel(request),
+    openAgentChannel: (request) => client.openAgentChannel(request),
+    joinTransferChannel: (request) => client.joinTransferChannel(request),
+    resumeTransferChannel: (request) => client.resumeTransferChannel(request),
+    replyToTransferChannel: (request) => client.replyToTransferChannel(request),
+    startMessageWatch: (request) => client.startMessageWatch(request),
+    acknowledgeExpectedMessage: (request) => client.acknowledgeExpectedMessage(request),
+    closeTransferChannel: (request) => client.closeTransferChannel(request),
+    establishAgentCommunicationChannel: (request) => client.establishAgentCommunicationChannel(request),
+    runInterAgentMessagingLoop: (request) => client.runInterAgentMessagingLoop(request),
+    createCrossAgentRemediationTicket: (request) => client.createCrossAgentRemediationTicket(request),
+    transferRefactoringBundle: (request) => client.transferRefactoringBundle(request),
+    acceptAgentChannel: (request) => client.acceptAgentChannel(request),
+    postAgentHeartbeat: (request) => client.postAgentHeartbeat(request),
+    postCollaborationHeartbeat: (request) => client.postCollaborationHeartbeat(request),
+    postAgentMessage: (request) => client.postAgentMessage(request),
+    acknowledgeAgentMessage: (request) => client.acknowledgeAgentMessage(request),
+    closeAgentChannel: (request) => client.closeAgentChannel(request),
+    createBundle: (request) => client.createCommunicationBundle(request),
+    getBundle: (bundleId) => client.getCommunicationBundle(bundleId),
+    listBundles: (request) => client.listCommunicationBundles(request),
+    addBundleItem: (request) => client.addCommunicationBundleItem(request),
+    uploadBundle: (request) => client.uploadCommunicationBundle(request),
+    attachBundleToMessage: (request) => client.attachCommunicationBundleToMessage(request),
+    recordBundleReceipt: (request) => client.recordCommunicationBundleReceipt(request),
+    recordBundleCleanupEvent: (request) => client.recordCommunicationBundleCleanupEvent(request),
+    claimBundle: (request) => client.claimCommunicationBundle(request),
+    acceptMessage: (messageId) => client.acceptCommunicationMessage(messageId),
+    respondWithEvidence: (request) => client.respondToCommunicationMessage(request),
+    attachEvidence: (request) => client.attachCommunicationMessageEvidence(request),
+    createHandoff: (request) => client.createCommunicationHandoff(request),
+    acceptHandoff: (request) => client.acceptCommunicationHandoff(request),
+    whoIsOnline: (request) => client.whoIsOnline(request),
+    findOnlineParticipant: (request) => client.findOnlineParticipant(request),
+    listCommunicationChannels: (request) => client.listCommunicationChannels(request),
+    listOpenCommunicationChannels: (request) => client.listOpenCommunicationChannels(request),
+    getCommunicationChannelStatus: (request) => client.getCommunicationChannelStatus(request),
+    getCommunicationChannelParticipants: (request) => client.getCommunicationChannelParticipants(request),
+    getPresenceBoard: (request) => client.getPresenceBoard(request),
+    getChannelPresence: (request) => client.getChannelPresence(request),
+    markParticipantOnline: (request) => client.markParticipantOnline(request),
+    markParticipantOffline: (request) => client.markParticipantOffline(request),
+    sendToParticipant: (request) => client.sendToParticipant(request),
+    sendToRole: (request) => client.sendToRole(request),
+    getMyInbox: (request) => client.getMyInbox(request),
+    verifyMessageSent: (request) => client.verifyMessageSent(request),
+    verifyMessageReceived: (request) => client.verifyMessageReceived(request),
+    getMessageDeliveryReceipt: (request) => client.getMessageDeliveryReceipt(request),
+    startCoordinationPingPong: (request) => client.startCoordinationPingPong(request),
+    sendCoordinationPing: (request) => client.sendCoordinationPing(request),
+    sendCoordinationPong: (request) => client.sendCoordinationPong(request),
+    getCoordinationPingPongStatus: (request) => client.getCoordinationPingPongStatus(request),
+    stopCoordinationPingPong: (request) => client.stopCoordinationPingPong(request),
+    checkCoordinationPingPongPreflight: (request) => client.checkCoordinationPingPongPreflight(request),
+    connectToTransferChannel: (request) => client.connectToTransferChannel(request),
+    startAgentConnection: (request) => client.startAgentConnection(request),
+    respondToMessageWatch: (request) => client.respondToMessageWatch(request),
+  };
+}
+
+export function createCollaborationFacade(client) {
+  return {
+    connectToTransferChannel: (request) => client.connectToTransferChannel(request),
+    respondToMessageWatch: (request) => client.respondToMessageWatch(request),
+    reviewProposal: (request) => client.reviewCollaborationProposal(request),
+    reviseProposal: (request) => client.reviseCollaborationProposal(request),
+    raiseBlocker: (request) => client.raiseCollaborationBlocker(request),
+    beginImplementation: (request) => client.beginCollaborationImplementation(request),
+    requestClosure: (request) => client.requestCollaborationClosure(request),
+    openTransferChannel: (request) => client.openTransferChannel(request),
+    openAgentChannel: (request) => client.openAgentChannel(request),
+    startAgentConnection: (request) => client.startAgentConnection(request),
+    joinTransferChannel: (request) => client.joinTransferChannel(request),
+    resumeTransferChannel: (request) => client.resumeTransferChannel(request),
+    replyToTransferChannel: (request) => client.replyToTransferChannel(request),
+    startMessageWatch: (request) => client.startMessageWatch(request),
+    acknowledgeExpectedMessage: (request) => client.acknowledgeExpectedMessage(request),
+    closeTransferChannel: (request) => client.closeTransferChannel(request),
+    establishAgentCommunicationChannel: (request) => client.establishAgentCommunicationChannel(request),
+    runInterAgentMessagingLoop: (request) => client.runInterAgentMessagingLoop(request),
+    createCrossAgentRemediationTicket: (request) => client.createCrossAgentRemediationTicket(request),
+    transferRefactoringBundle: (request) => client.transferRefactoringBundle(request),
+    acceptAgentChannel: (request) => client.acceptAgentChannel(request),
+    postAgentHeartbeat: (request) => client.postAgentHeartbeat(request),
+    postCollaborationHeartbeat: (request) => client.postCollaborationHeartbeat(request),
+    postAgentMessage: (request) => client.postAgentMessage(request),
+    acknowledgeAgentMessage: (request) => client.acknowledgeAgentMessage(request),
+    closeAgentChannel: (request) => client.closeAgentChannel(request),
+    whoIsOnline: (request) => client.whoIsOnline(request),
+    findOnlineParticipant: (request) => client.findOnlineParticipant(request),
+    listCommunicationChannels: (request) => client.listCommunicationChannels(request),
+    listOpenCommunicationChannels: (request) => client.listOpenCommunicationChannels(request),
+    getCommunicationChannelStatus: (request) => client.getCommunicationChannelStatus(request),
+    getCommunicationChannelParticipants: (request) => client.getCommunicationChannelParticipants(request),
+    getPresenceBoard: (request) => client.getPresenceBoard(request),
+    getChannelPresence: (request) => client.getChannelPresence(request),
+    markParticipantOnline: (request) => client.markParticipantOnline(request),
+    markParticipantOffline: (request) => client.markParticipantOffline(request),
+    sendToParticipant: (request) => client.sendToParticipant(request),
+    sendToRole: (request) => client.sendToRole(request),
+    getMyInbox: (request) => client.getMyInbox(request),
+    sendMessage: (request) => client._sendAgentCommsMessage(request),
+    verifyMessageSent: (request) => client.verifyMessageSent(request),
+    verifyMessageReceived: (request) => client.verifyMessageReceived(request),
+    getMessageDeliveryReceipt: (request) => client.getMessageDeliveryReceipt(request),
+    startCoordinationPingPong: (request) => client.startCoordinationPingPong(request),
+    sendCoordinationPing: (request) => client.sendCoordinationPing(request),
+    sendCoordinationPong: (request) => client.sendCoordinationPong(request),
+    getCoordinationPingPongStatus: (request) => client.getCoordinationPingPongStatus(request),
+    stopCoordinationPingPong: (request) => client.stopCoordinationPingPong(request),
+    checkCoordinationPingPongPreflight: (request) => client.checkCoordinationPingPongPreflight(request),
+  };
+}

package/src/index.js

@@ -1,5 +1,5 @@
 export { AIEngineClient, createAIEngineClient } from './client.js';
-export const AI_ENGINE_CLIENT_VERSION = '1.1.82';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.83';
 export { GOVERNED_MUTATION_REQUIRED_CAPABILITIES, AI_ENGINE_CLIENT_CAPABILITIES, TASK_BOUND_SUBSTRATE_EXECUTION_POLICY } from './constants/governance.js';
 export { LOGA_CONTRACT, LOGA_INTERACTION_CONTRACT, LOGA_NAVIGATION_CONTRACT, LOGA_PROJECTION_WORKFLOW } from './constants/loga.js';
 export {