@bpmsoftwaresolutions/ai-engine-client 1.1.20 → 1.1.22

package/README.md

@@ -386,6 +386,8 @@ Low-level compatibility methods:
 | `submitUxGateRemediation(body)` / `client.loga.submitUxGateRemediation(body)` | `POST /api/loga/ux-gate-remediations` | Create a governed SQL-backed remediation ticket for a UX gate failure. |
 | `listUxGateRemediations({ projectionType, status })` / `client.loga.listUxGateRemediations(...)` | `GET /api/loga/ux-gate-remediations` | List governed UX gate remediation tickets. |
 | `getUxGateRemediation(remediationId)` / `client.loga.getUxGateRemediation(...)` | `GET /api/loga/ux-gate-remediations/:remediationId` | Read one governed UX gate remediation ticket. |
+| `appendUxRemediationTicketNote(remediationId, body)` / `client.loga.appendUxRemediationTicketNote(...)` | `POST /api/loga/ux-gate-remediations/:remediationId/notes` | Append a governed downstream-facing remediation note to a UX gate remediation ticket. |
+| `listUxRemediationTicketNotes(remediationId)` / `client.loga.listUxRemediationTicketNotes(...)` | `GET /api/loga/ux-gate-remediations/:remediationId/notes` | List governed remediation notes for a UX gate remediation ticket. |
 | `promoteUxGateRemediationImplementationCandidate(remediationId, { promotedBy })` / `client.loga.promoteUxGateRemediationImplementationCandidate(...)` | `POST /api/loga/ux-gate-remediations/:remediationId/implementation-candidate` | Promote a governed UX remediation ticket into a durable implementation packet candidate. |
 | `getLogaUxGateRemediationProjection(remediationId)` / `client.loga.getUxGateRemediationProjection(...)` | `GET /api/operator/projections/ux-gate-remediations/:remediationId` | Review a governed UX remediation ticket and its linked implementation candidate as a LOGA runtime document. |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.20",
+  "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.19';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.20';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -165,6 +165,8 @@ export class AIEngineClient {
       submitUxGateRemediation: (payload) => this.submitUxGateRemediation(payload),
       listUxGateRemediations: (query) => this.listUxGateRemediations(query),
       getUxGateRemediation: (remediationId) => this.getUxGateRemediation(remediationId),
+      appendUxRemediationTicketNote: (remediationId, payload) => this.appendUxRemediationTicketNote(remediationId, payload),
+      listUxRemediationTicketNotes: (remediationId) => this.listUxRemediationTicketNotes(remediationId),
       promoteUxGateRemediationImplementationCandidate: (remediationId, payload) =>
         this.promoteUxGateRemediationImplementationCandidate(remediationId, payload),
       getUxGateRemediationProjection: (remediationId) => this.getLogaUxGateRemediationProjection(remediationId),
@@ -418,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 });
   }
@@ -441,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 });
   }
@@ -994,6 +1083,31 @@ export class AIEngineClient {
     return this._request(`/api/loga/ux-gate-remediations/${remediationId}`);
   }
 
+  async appendUxRemediationTicketNote(remediationId, {
+    noteKind,
+    body,
+    visibility,
+    authorActorId,
+    evidenceRefs,
+    metadata,
+  } = {}) {
+    return this._request(`/api/loga/ux-gate-remediations/${remediationId}/notes`, {
+      method: 'POST',
+      body: {
+        noteKind,
+        body,
+        visibility,
+        authorActorId,
+        evidenceRefs,
+        metadata,
+      },
+    });
+  }
+
+  async listUxRemediationTicketNotes(remediationId) {
+    return this._request(`/api/loga/ux-gate-remediations/${remediationId}/notes`);
+  }
+
   async promoteUxGateRemediationImplementationCandidate(remediationId, { promotedBy } = {}) {
     return this._request(`/api/loga/ux-gate-remediations/${remediationId}/implementation-candidate`, {
       method: 'POST',