@bpmsoftwaresolutions/ai-engine-client 1.1.24 → 1.1.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.24",
+  "version": "1.1.26",
   "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.24';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.26';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -455,6 +455,11 @@ export class AIEngineClient {
     return this._request('/api/governance/claims/claim-work-item', { method: 'POST', body });
   }
 
+  async getClaim(claimId) {
+    if (!claimId) throw new Error('claimId is required.');
+    return this._request(`/api/governance/claims/${encodeURIComponent(claimId)}`);
+  }
+
   async getExecutionEligibility(body = {}) {
     return this._request('/api/governance/execution-eligibility', {
       method: 'POST',
@@ -1361,7 +1366,33 @@ export class AIEngineClient {
     notes,
     createdBy,
     parentTaskId,
+    claimId,
+    claimedItemId,
+    workflowRunId,
+    agentSessionId,
+    allowedMutationSurfaces,
+    acknowledgedReminders,
   } = {}) {
+    const normalizedClaimId = cleanText(claimId);
+    const normalizedClaimedItemId = cleanText(claimedItemId) || implementationItemId;
+    const normalizedWorkflowRunId = cleanText(workflowRunId);
+    const normalizedAgentSessionId = cleanText(agentSessionId);
+    const normalizedAllowedMutationSurfaces = Array.isArray(allowedMutationSurfaces) && allowedMutationSurfaces.length > 0
+      ? allowedMutationSurfaces
+      : ['project_roadmap_task'];
+    const normalizedAcknowledgedReminders = Array.isArray(acknowledgedReminders)
+      ? acknowledgedReminders
+      : undefined;
+    await this._assertExecutionEligibility({
+      claim_id: normalizedClaimId,
+      claimed_item_id: normalizedClaimedItemId,
+      workflow_run_id: normalizedWorkflowRunId,
+      agent_session_id: normalizedAgentSessionId,
+      allowed_mutation_surfaces: normalizedAllowedMutationSurfaces,
+      acknowledged_reminders: normalizedAcknowledgedReminders || [],
+      requested_mutation_surface: 'project_roadmap_task',
+      verification_required: true,
+    });
     return this._request(`/api/operator/implementation-items/${implementationItemId}/tasks`, {
       method: 'POST',
       body: {
@@ -1376,6 +1407,12 @@ export class AIEngineClient {
         notes,
         created_by: createdBy,
         parent_task_id: parentTaskId,
+        claim_id: normalizedClaimId,
+        claimed_item_id: normalizedClaimedItemId,
+        workflow_run_id: normalizedWorkflowRunId,
+        agent_session_id: normalizedAgentSessionId,
+        allowed_mutation_surfaces: normalizedAllowedMutationSurfaces,
+        acknowledged_reminders: normalizedAcknowledgedReminders,
       },
     });
   }