@bpmsoftwaresolutions/ai-engine-client 1.1.9 → 1.1.10

package/README.md

@@ -392,6 +392,16 @@ These methods return markdown as `text` and expose projection headers as top-lev
 
 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.9",
+  "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

@@ -115,6 +115,12 @@ export class AIEngineClient {
         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),
+    };
   }
 
   static fromEnv(options = {}) {
@@ -922,6 +928,59 @@ export class AIEngineClient {
     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 } = {}) {