@bpmsoftwaresolutions/ai-engine-client 1.1.26 → 1.1.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.26",
+  "version": "1.1.28",
   "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.26';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.27';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -675,6 +675,42 @@ export class AIEngineClient {
     return this._request('/api/charters/run', { method: 'POST', body });
   }
 
+  async createProjectDelivery(body = {}) {
+    return this._request('/api/project-delivery', { method: 'POST', body });
+  }
+
+  async approveProjectCharterIntent(projectId, body = {}) {
+    if (!projectId) throw new Error('projectId is required.');
+    return this._request(`/api/project-delivery/${encodeURIComponent(projectId)}/approve-charter-intent`, {
+      method: 'POST',
+      body,
+    });
+  }
+
+  async approveImplementationRoadmap(projectId, body = {}) {
+    if (!projectId) throw new Error('projectId is required.');
+    return this._request(`/api/project-delivery/${encodeURIComponent(projectId)}/approve-roadmap`, {
+      method: 'POST',
+      body,
+    });
+  }
+
+  async runProjectCharter(projectId, body = {}) {
+    if (!projectId) throw new Error('projectId is required.');
+    return this._request(`/api/project-delivery/${encodeURIComponent(projectId)}/run-charter`, {
+      method: 'POST',
+      body,
+    });
+  }
+
+  async beginImplementationRoadmap(projectId, body = {}) {
+    if (!projectId) throw new Error('projectId is required.');
+    return this._request(`/api/project-delivery/${encodeURIComponent(projectId)}/begin-roadmap`, {
+      method: 'POST',
+      body,
+    });
+  }
+
   async persistAssistantTurn(body) {
     return this._request('/api/v1/assistant-turns', { method: 'POST', body });
   }
@@ -1367,13 +1403,19 @@ export class AIEngineClient {
     createdBy,
     parentTaskId,
     claimId,
+    claimProjectId,
+    projectId,
     claimedItemId,
     workflowRunId,
     agentSessionId,
     allowedMutationSurfaces,
     acknowledgedReminders,
+    executionIntent,
+    executionType,
+    executionPurpose,
   } = {}) {
     const normalizedClaimId = cleanText(claimId);
+    const normalizedClaimProjectId = cleanText(claimProjectId) || cleanText(projectId);
     const normalizedClaimedItemId = cleanText(claimedItemId) || implementationItemId;
     const normalizedWorkflowRunId = cleanText(workflowRunId);
     const normalizedAgentSessionId = cleanText(agentSessionId);
@@ -1383,8 +1425,27 @@ export class AIEngineClient {
     const normalizedAcknowledgedReminders = Array.isArray(acknowledgedReminders)
       ? acknowledgedReminders
       : undefined;
+    const normalizedExecutionIntent = (() => {
+      if (executionIntent && typeof executionIntent === 'object') {
+        const execution_type = cleanText(executionIntent.execution_type) || cleanText(executionIntent.executionType);
+        const execution_purpose = cleanText(executionIntent.execution_purpose) || cleanText(executionIntent.executionPurpose);
+        if (execution_type || execution_purpose) {
+          return {
+            ...(execution_type ? { execution_type } : {}),
+            ...(execution_purpose ? { execution_purpose } : {}),
+          };
+        }
+      }
+      const normalizedExecutionType = cleanText(executionType) || 'implementation_task';
+      const normalizedExecutionPurpose = cleanText(executionPurpose) || cleanText(title) || 'implementation task';
+      return {
+        execution_type: normalizedExecutionType,
+        execution_purpose: normalizedExecutionPurpose,
+      };
+    })();
     await this._assertExecutionEligibility({
       claim_id: normalizedClaimId,
+      claim_project_id: normalizedClaimProjectId,
       claimed_item_id: normalizedClaimedItemId,
       workflow_run_id: normalizedWorkflowRunId,
       agent_session_id: normalizedAgentSessionId,
@@ -1408,11 +1469,13 @@ export class AIEngineClient {
         created_by: createdBy,
         parent_task_id: parentTaskId,
         claim_id: normalizedClaimId,
+        claim_project_id: normalizedClaimProjectId,
         claimed_item_id: normalizedClaimedItemId,
         workflow_run_id: normalizedWorkflowRunId,
         agent_session_id: normalizedAgentSessionId,
         allowed_mutation_surfaces: normalizedAllowedMutationSurfaces,
         acknowledged_reminders: normalizedAcknowledgedReminders,
+        execution_intent: normalizedExecutionIntent,
       },
     });
   }