@bpmsoftwaresolutions/ai-engine-client 1.1.43 → 1.1.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.43",
+  "version": "1.1.45",
   "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.43';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.45';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -310,6 +310,15 @@ export class AIEngineClient {
       getThread: (threadId) => this.getCommunicationThread(threadId),
       listInbox: (request) => this.listCommunicationInbox(request),
       sendMessage: (request) => this.sendCommunicationMessage(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),
@@ -532,11 +541,14 @@ export class AIEngineClient {
     recipient_agent_session_id,
     recipientRoleKey,
     recipient_role_key,
+    workflowRunId,
+    workflow_run_id,
   } = {}) {
     return this._request('/api/agent-communications/inbox', {
       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),
       },
     });
   }
@@ -545,6 +557,8 @@ export class AIEngineClient {
     communicationThreadId,
     communication_thread_id,
     threadId,
+    communicationBundleId,
+    communication_bundle_id,
     senderAgentSessionId,
     sender_agent_session_id,
     recipientAgentSessionId,
@@ -567,6 +581,7 @@ export class AIEngineClient {
       method: 'POST',
       body: {
         communication_thread_id: cleanText(communication_thread_id) || cleanText(communicationThreadId) || cleanText(threadId),
+        communication_bundle_id: cleanText(communication_bundle_id) || cleanText(communicationBundleId),
         sender_agent_session_id: cleanText(sender_agent_session_id) || cleanText(senderAgentSessionId),
         recipient_agent_session_id: cleanText(recipient_agent_session_id) || cleanText(recipientAgentSessionId),
         recipient_role_key: cleanText(recipient_role_key) || cleanText(recipientRoleKey),
@@ -583,6 +598,244 @@ export class AIEngineClient {
     });
   }
 
+  async createCommunicationBundle({
+    workflowRunId,
+    workflow_run_id,
+    communicationThreadId,
+    communication_thread_id,
+    threadId,
+    sourceAgentSessionId,
+    source_agent_session_id,
+    sourceActorSessionId,
+    source_actor_session_id,
+    recipientAgentSessionId,
+    recipient_agent_session_id,
+    recipientRoleKey,
+    recipient_role_key,
+    bundleKind,
+    bundle_kind,
+    cleanupPolicy,
+    cleanup_policy,
+    manifest = {},
+    manifestSha256,
+    manifest_sha256,
+    blobUri,
+    blob_uri,
+    blobSha256,
+    blob_sha256,
+    blobContainerName,
+    blob_container_name,
+    blobObjectKey,
+    blob_object_key,
+    metadata = {},
+  } = {}) {
+    return this._request('/api/agent-communications/bundles', {
+      method: 'POST',
+      body: {
+        workflow_run_id: cleanText(workflow_run_id) || cleanText(workflowRunId),
+        communication_thread_id: cleanText(communication_thread_id) || cleanText(communicationThreadId) || cleanText(threadId),
+        source_agent_session_id: cleanText(source_agent_session_id) || cleanText(sourceAgentSessionId),
+        source_actor_session_id: cleanText(source_actor_session_id) || cleanText(sourceActorSessionId),
+        recipient_agent_session_id: cleanText(recipient_agent_session_id) || cleanText(recipientAgentSessionId),
+        recipient_role_key: cleanText(recipient_role_key) || cleanText(recipientRoleKey),
+        bundle_kind: cleanText(bundle_kind) || cleanText(bundleKind) || 'transfer',
+        cleanup_policy: cleanText(cleanup_policy) || cleanText(cleanupPolicy) || 'cleanup_after_receipt',
+        manifest: isPlainObject(manifest) ? manifest : {},
+        manifest_sha256: cleanText(manifest_sha256) || cleanText(manifestSha256),
+        blob_uri: cleanText(blob_uri) || cleanText(blobUri),
+        blob_sha256: cleanText(blob_sha256) || cleanText(blobSha256),
+        blob_container_name: cleanText(blob_container_name) || cleanText(blobContainerName),
+        blob_object_key: cleanText(blob_object_key) || cleanText(blobObjectKey),
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
+  async getCommunicationBundle(bundleId) {
+    return this._request(`/api/agent-communications/bundles/${encodeURIComponent(bundleId)}`);
+  }
+
+  async listCommunicationBundles({ workflowRunId, workflow_run_id } = {}) {
+    return this._request('/api/agent-communications/bundles', {
+      query: { workflow_run_id: cleanText(workflow_run_id) || cleanText(workflowRunId) },
+    });
+  }
+
+  async addCommunicationBundleItem({
+    communicationBundleId,
+    communication_bundle_id,
+    itemOrder,
+    item_order,
+    itemKind,
+    item_kind,
+    itemRef,
+    item_ref,
+    itemName,
+    item_name,
+    itemSha256,
+    item_sha256,
+    required,
+    metadata = {},
+  } = {}) {
+    const normalizedBundleId = cleanText(communication_bundle_id) || cleanText(communicationBundleId);
+    if (!normalizedBundleId) throw new Error('communication_bundle_id is required.');
+    return this._request(`/api/agent-communications/bundles/${encodeURIComponent(normalizedBundleId)}/items`, {
+      method: 'POST',
+      body: {
+        item_order: Number(item_order ?? itemOrder ?? 0),
+        item_kind: cleanText(item_kind) || cleanText(itemKind) || 'artifact',
+        item_ref: cleanText(item_ref) || cleanText(itemRef),
+        item_name: cleanText(item_name) || cleanText(itemName),
+        item_sha256: cleanText(item_sha256) || cleanText(itemSha256),
+        required: required !== undefined ? Boolean(required) : true,
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
+  async uploadCommunicationBundle({
+    communicationBundleId,
+    communication_bundle_id,
+    blobUri,
+    blob_uri,
+    blobSha256,
+    blob_sha256,
+    blobContainerName,
+    blob_container_name,
+    blobObjectKey,
+    blob_object_key,
+    manifest = {},
+    manifestSha256,
+    manifest_sha256,
+    uploadedAt,
+    uploaded_at,
+  } = {}) {
+    const normalizedBundleId = cleanText(communication_bundle_id) || cleanText(communicationBundleId);
+    if (!normalizedBundleId) throw new Error('communication_bundle_id is required.');
+    return this._request(`/api/agent-communications/bundles/${encodeURIComponent(normalizedBundleId)}/upload`, {
+      method: 'POST',
+      body: {
+        blob_uri: cleanText(blob_uri) || cleanText(blobUri),
+        blob_sha256: cleanText(blob_sha256) || cleanText(blobSha256),
+        blob_container_name: cleanText(blob_container_name) || cleanText(blobContainerName),
+        blob_object_key: cleanText(blob_object_key) || cleanText(blobObjectKey),
+        manifest: isPlainObject(manifest) ? manifest : {},
+        manifest_sha256: cleanText(manifest_sha256) || cleanText(manifestSha256),
+        uploaded_at: cleanText(uploaded_at) || cleanText(uploadedAt),
+      },
+    });
+  }
+
+  async attachCommunicationBundleToMessage({
+    communicationBundleId,
+    communication_bundle_id,
+    agentMessageId,
+    agent_message_id,
+    messageId,
+    messageStatus,
+    message_status,
+  } = {}) {
+    const normalizedBundleId = cleanText(communication_bundle_id) || cleanText(communicationBundleId);
+    if (!normalizedBundleId) throw new Error('communication_bundle_id is required.');
+    return this._request(`/api/agent-communications/bundles/${encodeURIComponent(normalizedBundleId)}/attach-to-message`, {
+      method: 'POST',
+      body: {
+        agent_message_id: cleanText(agent_message_id) || cleanText(agentMessageId) || cleanText(messageId),
+        message_status: cleanText(message_status) || cleanText(messageStatus),
+      },
+    });
+  }
+
+  async recordCommunicationBundleReceipt({
+    communicationBundleId,
+    communication_bundle_id,
+    recipientAgentSessionId,
+    recipient_agent_session_id,
+    recipientActorSessionId,
+    recipient_actor_session_id,
+    receiptStatus,
+    receipt_status,
+    manifestSha256,
+    manifest_sha256,
+    blobSha256,
+    blob_sha256,
+    fetchedItemCount,
+    fetched_item_count,
+    explicitlyAcceptedItemCount,
+    explicitly_accepted_item_count,
+    allRequiredItemsFetched,
+    all_required_items_fetched,
+    checksumsVerified,
+    checksums_verified,
+    receipt = {},
+    metadata = {},
+  } = {}) {
+    const normalizedBundleId = cleanText(communication_bundle_id) || cleanText(communicationBundleId);
+    if (!normalizedBundleId) throw new Error('communication_bundle_id is required.');
+    return this._request(`/api/agent-communications/bundles/${encodeURIComponent(normalizedBundleId)}/receipts`, {
+      method: 'POST',
+      body: {
+        recipient_agent_session_id: cleanText(recipient_agent_session_id) || cleanText(recipientAgentSessionId),
+        recipient_actor_session_id: cleanText(recipient_actor_session_id) || cleanText(recipientActorSessionId),
+        receipt_status: cleanText(receipt_status) || cleanText(receiptStatus) || 'received',
+        manifest_sha256: cleanText(manifest_sha256) || cleanText(manifestSha256),
+        blob_sha256: cleanText(blob_sha256) || cleanText(blobSha256),
+        fetched_item_count: Number(fetched_item_count ?? fetchedItemCount ?? 0),
+        explicitly_accepted_item_count: Number(explicitly_accepted_item_count ?? explicitlyAcceptedItemCount ?? 0),
+        all_required_items_fetched: Boolean(all_required_items_fetched ?? allRequiredItemsFetched ?? false),
+        checksums_verified: Boolean(checksums_verified ?? checksumsVerified ?? false),
+        receipt: isPlainObject(receipt) ? receipt : {},
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
+  async recordCommunicationBundleCleanupEvent({
+    communicationBundleId,
+    communication_bundle_id,
+    cleanupStatus,
+    cleanup_status,
+    cleanupReason,
+    cleanup_reason,
+    blobUri,
+    blob_uri,
+    deletedAt,
+    deleted_at,
+    errorMessage,
+    error_message,
+    metadata = {},
+  } = {}) {
+    const normalizedBundleId = cleanText(communication_bundle_id) || cleanText(communicationBundleId);
+    if (!normalizedBundleId) throw new Error('communication_bundle_id is required.');
+    return this._request(`/api/agent-communications/bundles/${encodeURIComponent(normalizedBundleId)}/cleanup-events`, {
+      method: 'POST',
+      body: {
+        cleanup_status: cleanText(cleanup_status) || cleanText(cleanupStatus) || 'cleanup_failed',
+        cleanup_reason: cleanText(cleanup_reason) || cleanText(cleanupReason),
+        blob_uri: cleanText(blob_uri) || cleanText(blobUri),
+        deleted_at: cleanText(deleted_at) || cleanText(deletedAt),
+        error_message: cleanText(error_message) || cleanText(errorMessage),
+        metadata: isPlainObject(metadata) ? metadata : {},
+      },
+    });
+  }
+
+  async claimCommunicationBundle({
+    communicationBundleId,
+    communication_bundle_id,
+    claimedAt,
+    claimed_at,
+  } = {}) {
+    const normalizedBundleId = cleanText(communication_bundle_id) || cleanText(communicationBundleId);
+    if (!normalizedBundleId) throw new Error('communication_bundle_id is required.');
+    return this._request(`/api/agent-communications/bundles/${encodeURIComponent(normalizedBundleId)}/claim`, {
+      method: 'POST',
+      body: {
+        claimed_at: cleanText(claimed_at) || cleanText(claimedAt),
+      },
+    });
+  }
+
   async acceptCommunicationMessage(messageId) {
     return this._request(`/api/agent-communications/messages/${encodeURIComponent(messageId)}/accept`, {
       method: 'POST',
@@ -606,7 +859,7 @@ export class AIEngineClient {
     if (!normalizedMessageId) {
       throw new Error('agent_message_id is required.');
     }
-    return this._request(`/api/agent-communications/messages/${encodeURIComponent(normalizedMessageId)}/respond`, {
+    return this._request(`/api/agent-communications/messages/${encodeURIComponent(normalizedMessageId)}/respond-with-evidence`, {
       method: 'POST',
       body: {
         status: cleanText(status) || 'answered',
@@ -636,7 +889,7 @@ export class AIEngineClient {
     if (!normalizedMessageId) {
       throw new Error('agent_message_id is required.');
     }
-    return this._request(`/api/agent-communications/messages/${encodeURIComponent(normalizedMessageId)}/attach-evidence`, {
+    return this._request(`/api/agent-communications/messages/${encodeURIComponent(normalizedMessageId)}/evidence-links`, {
       method: 'POST',
       body: {
         evidence_type: cleanText(evidence_type) || cleanText(evidenceType),