@bpmsoftwaresolutions/ai-engine-client 1.1.8 → 1.1.10

package/README.md

@@ -385,11 +385,23 @@ 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. |
+| `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. |
 
 These methods return markdown as `text` and expose projection headers as top-level fields plus `provenance`. LOGA should render the markdown emitted by AI Engine and use these metadata fields for contract validation, refresh behavior, evidence display, and action choreography.
 
 UX gate remediation is not a generic note or implementation-item evidence path. LOGA clients should use `submitUxGateRemediation()` when a projection fails a UX gate and should include `sourceTruth: 'sql'`, the projection identity, affected finding ids, and client evidence about the failing gate.
 
+### Generated Scripts
+| Method | Endpoint | Description |
+|---|---|---|
+| `generateScript(body)` / `client.scripts.generate(body)` | `POST /api/scripts/generate` | Create a governed diagnostic-only helper script bound to claim, session, or workflow context. |
+| `renderScript(scriptId)` / `client.scripts.render(scriptId)` | `GET /api/scripts/:scriptId/render` | Read the rendered helper script, shell-safe usage guidance, and SQL provenance. |
+| `submitScriptArtifact(scriptId, body)` / `client.scripts.submitArtifact(scriptId, body)` | `POST /api/scripts/:scriptId/artifacts` | Submit governed execution evidence and attach a workflow artifact for the generated script run. |
+| `getScriptRunEvidence({ workflowRunId, scriptId })` / `client.scripts.getRunEvidence(...)` | `GET /api/scripts/run-evidence` | List SQL-backed generated script runs and their evidence for a workflow run or one script id. |
+
+Generated scripts are ephemeral helpers, not source-of-truth. The server keeps SQL authority over the run ledger and defaults each script to `diagnostic_only`, `local_helper`, and file/stdin-safe usage instead of fragile long inline commands.
+
 ### Retrieval Wrapper
 | Method | Description |
 |---|---|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "Thin npm client for the AI Engine operator and retrieval APIs",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -111,6 +111,15 @@ export class AIEngineClient {
       submitUxGateRemediation: (payload) => this.submitUxGateRemediation(payload),
       listUxGateRemediations: (query) => this.listUxGateRemediations(query),
       getUxGateRemediation: (remediationId) => this.getUxGateRemediation(remediationId),
+      promoteUxGateRemediationImplementationCandidate: (remediationId, payload) =>
+        this.promoteUxGateRemediationImplementationCandidate(remediationId, payload),
+      getUxGateRemediationProjection: (remediationId) => this.getLogaUxGateRemediationProjection(remediationId),
+    };
+    this.scripts = {
+      generate: (payload) => this.generateScript(payload),
+      render: (scriptId) => this.renderScript(scriptId),
+      submitArtifact: (scriptId, payload) => this.submitScriptArtifact(scriptId, payload),
+      getRunEvidence: (query) => this.getScriptRunEvidence(query),
     };
   }
 
@@ -908,6 +917,70 @@ export class AIEngineClient {
     return this._request(`/api/loga/ux-gate-remediations/${remediationId}`);
   }
 
+  async promoteUxGateRemediationImplementationCandidate(remediationId, { promotedBy } = {}) {
+    return this._request(`/api/loga/ux-gate-remediations/${remediationId}/implementation-candidate`, {
+      method: 'POST',
+      body: { promotedBy },
+    });
+  }
+
+  async getLogaUxGateRemediationProjection(remediationId) {
+    return this._requestLogaProjection(`/api/operator/projections/ux-gate-remediations/${remediationId}`);
+  }
+
+  async generateScript({
+    claimId,
+    contextSessionId,
+    workflowRunId,
+    intent = {},
+    renderSpec = {},
+    createdBy,
+  } = {}) {
+    return this._request('/api/scripts/generate', {
+      method: 'POST',
+      body: {
+        claimId,
+        contextSessionId,
+        workflowRunId,
+        intent,
+        renderSpec,
+        createdBy,
+      },
+    });
+  }
+
+  async renderScript(scriptId) {
+    return this._request(`/api/scripts/${scriptId}/render`);
+  }
+
+  async submitScriptArtifact(scriptId, {
+    workflowRunId,
+    output = {},
+    observations = [],
+    validation = {},
+    recordedBy,
+  } = {}) {
+    return this._request(`/api/scripts/${scriptId}/artifacts`, {
+      method: 'POST',
+      body: {
+        workflowRunId,
+        output,
+        observations,
+        validation,
+        recordedBy,
+      },
+    });
+  }
+
+  async getScriptRunEvidence({ workflowRunId, scriptId } = {}) {
+    return this._request('/api/scripts/run-evidence', {
+      query: {
+        workflowRunId,
+        scriptId,
+      },
+    });
+  }
+
   // ─── Roadmaps ──────────────────────────────────────────────────────────────
 
   async listProjectRoadmaps({ includeInactive } = {}) {