@bpmsoftwaresolutions/ai-engine-client 1.1.21 → 1.1.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.21",
+  "version": "1.1.22",
   "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.21';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.20';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -420,6 +420,37 @@ export class AIEngineClient {
     return this._request('/api/work/start', { method: 'POST', body });
   }
 
+  async startClaimedWork({
+    claimName,
+    actorId,
+    intentId,
+    declaredScopeFiles,
+    allowedMutationSurfaces,
+    runtimeSessionId,
+    executionPurpose,
+    successCriteria,
+    mutationAllowed,
+    metadata,
+    ...rest
+  } = {}) {
+    return this._request('/api/governance/claims/start-claimed-work', {
+      method: 'POST',
+      body: {
+        ...rest,
+        claim_name: claimName,
+        actor_id: actorId,
+        intent_id: intentId,
+        declared_scope_files: declaredScopeFiles,
+        allowed_mutation_surfaces: allowedMutationSurfaces,
+        runtime_session_id: runtimeSessionId,
+        execution_purpose: executionPurpose,
+        success_criteria: successCriteria,
+        mutation_allowed: mutationAllowed,
+        metadata,
+      },
+    });
+  }
+
   async claimWorkItem(body = {}) {
     return this._request('/api/governance/claims/claim-work-item', { method: 'POST', body });
   }
@@ -443,6 +474,62 @@ export class AIEngineClient {
     });
   }
 
+  /**
+   * Promote a governance claim from `missing_promoted_surface` to
+   * `promoted_surface_bound` by binding required tool definitions to the
+   * workflow and recording a completed claim signoff.
+   *
+   * @param {object} params
+   * @param {string} params.claimId           - UUID of the claim to unblock.
+   * @param {string} params.workflowId        - UUID of the target workflow.
+   * @param {string} params.contextSessionId  - Oriented context session UUID.
+   * @param {string} params.actorId           - Caller identity for audit trail.
+   * @param {string[]} params.requiredToolKeys - Tool keys to bind.
+   * @param {string} [params.intentId]         - Default: 'code_mutation'.
+   * @param {string} [params.bindingScope]     - Default: 'required'.
+   * @param {string} [params.usageMode]        - Default: 'manual'.
+   * @param {string} [params.operatorScope]
+   * @param {object} [params.allowedArgumentPolicy]
+   * @returns {Promise<object>} Promotion result envelope.
+   */
+  async promoteClaimSurface({
+    claimId,
+    workflowId,
+    contextSessionId,
+    actorId,
+    requiredToolKeys,
+    intentId,
+    bindingScope,
+    usageMode,
+    operatorScope,
+    allowedArgumentPolicy,
+    ...rest
+  } = {}) {
+    if (!claimId) throw new Error('claimId is required.');
+    if (!workflowId) throw new Error('workflowId is required.');
+    if (!contextSessionId) throw new Error('contextSessionId is required.');
+    if (!actorId) throw new Error('actorId is required.');
+    if (!Array.isArray(requiredToolKeys) || requiredToolKeys.length === 0) {
+      throw new Error('requiredToolKeys must be a non-empty array.');
+    }
+    return this._request('/api/governance/claims/promote-surface', {
+      method: 'POST',
+      body: {
+        ...rest,
+        claim_id: claimId,
+        workflow_id: workflowId,
+        context_session_id: contextSessionId,
+        actor_id: actorId,
+        required_tool_keys: requiredToolKeys,
+        intent_id: intentId,
+        binding_scope: bindingScope,
+        usage_mode: usageMode,
+        operator_scope: operatorScope,
+        allowed_argument_policy: allowedArgumentPolicy,
+      },
+    });
+  }
+
   async completeTurn(body = {}) {
     return this._request('/api/turns/complete', { method: 'POST', body });
   }