@bpmsoftwaresolutions/ai-engine-client 1.1.32 → 1.1.34

package/README.md

@@ -72,6 +72,11 @@ const persistedTurn = await client.persistAssistantTurn({
   assistant_summary: 'Completed the implementation step and persisted the governed turn.',
   changed_files: ['src/web/app.py'],
 });
+
+const telemetry = await client.getExecutionTelemetryCurrent();
+const processRuns = await client.listExecutionProcessRuns({ limit: 25 });
+const generatedUsability = await client.getGeneratedExecutionUsability();
+const logaUsability = await client.getLogaGeneratedExecutionUsabilityProjection();
 ```
 
 ## Integration Notes
@@ -194,6 +199,39 @@ renderLogaMarkdown(projection.text, {
 });
 ```
 
+### Execution Telemetry Monitoring
+
+Use the telemetry methods when you want downstream consumers to read the governed API instead of generated files.
+
+```js
+const current = await client.getExecutionTelemetryCurrent();
+const runs = await client.listExecutionProcessRuns({ limit: 25, artifactKind: 'generated_script' });
+const run = await client.getExecutionProcessRun('process-run-1');
+const generated = await client.getGeneratedExecutionUsability();
+const logaProjection = await client.getLogaGeneratedExecutionUsabilityProjection();
+
+console.log(current.status, runs.process_run_count, run.process_run_id);
+console.log(generated.projection_type, logaProjection.projectionType);
+```
+
+The telemetry and LOGA surfaces are read-only and SQL-backed:
+
+- `getExecutionTelemetryCurrent()`
+- `listExecutionProcessRuns({ limit, artifactKind, status, since })`
+- `getExecutionProcessRun(processRunId)`
+- `getGeneratedExecutionUsability()`
+- `getLogaGeneratedExecutionUsabilityProjection()`
+
+Example shell consumer:
+
+- [`examples/monitoring/read-execution-telemetry.mjs`](/Users/sidney/source/repos/bpm/internal/ai-engine/examples/monitoring/read-execution-telemetry.mjs)
+
+Run it with:
+
+```bash
+AI_ENGINE_BASE_URL="..." AI_ENGINE_ACCESS_TOKEN="..." npm run example:monitoring
+```
+
 ### fromEnv
 
 ```js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.32",
+  "version": "1.1.34",
   "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.32';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.34';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -251,6 +251,13 @@ export class AIEngineClient {
       promoteUxGateRemediationImplementationCandidate: (remediationId, payload) =>
         this.promoteUxGateRemediationImplementationCandidate(remediationId, payload),
       getUxGateRemediationProjection: (remediationId) => this.getLogaUxGateRemediationProjection(remediationId),
+      getGeneratedExecutionUsabilityProjection: (query) => this.getLogaGeneratedExecutionUsabilityProjection(query),
+    };
+    this.executionTelemetry = {
+      getCurrent: () => this.getExecutionTelemetryCurrent(),
+      listProcessRuns: (query) => this.listExecutionProcessRuns(query),
+      getProcessRun: (processRunId) => this.getExecutionProcessRun(processRunId),
+      getGeneratedExecutionUsability: (query) => this.getGeneratedExecutionUsability(query),
     };
     this.scripts = {
       generate: (payload) => this.generateScript(payload),
@@ -302,6 +309,32 @@ export class AIEngineClient {
     });
   }
 
+  async getExecutionTelemetryCurrent() {
+    return this._request('/api/operator/execution-telemetry/current');
+  }
+
+  async listExecutionProcessRuns({ limit, artifactKind, status, since } = {}) {
+    return this._request('/api/operator/execution-telemetry/process-runs', {
+      query: { limit, artifact_kind: artifactKind, status, since },
+    });
+  }
+
+  async getExecutionProcessRun(processRunId) {
+    return this._request(`/api/operator/execution-telemetry/process-runs/${processRunId}`);
+  }
+
+  async getGeneratedExecutionUsability({ artifactPath, limit } = {}) {
+    return this._request('/api/operator/generated-execution-usability', {
+      query: { artifact_path: artifactPath, limit },
+    });
+  }
+
+  async getLogaGeneratedExecutionUsabilityProjection({ artifactPath, limit } = {}) {
+    return this._requestLogaProjection('/api/loga/ai-engine/generated-execution-usability', {
+      query: { artifact_path: artifactPath, limit },
+    });
+  }
+
   async getAntiPatternRules() {
     return this._request('/api/governance/anti-pattern-rules');
   }