@bpmsoftwaresolutions/ai-engine-client 1.1.33 → 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.33",
+  "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.33';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.34';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',