nemo-relay-openclaw 0.6.0 → 0.7.0-rc.2

package/README.md

@@ -8,8 +8,8 @@ SPDX-License-Identifier: Apache-2.0
 `nemo-relay-openclaw` is the NeMo Relay observability plugin package for
 OpenClaw. It converts supported OpenClaw hook events into NeMo Relay sessions,
 LLM spans, tool spans, and lifecycle marks that the generic NeMo Relay
-observability component can export as ATIF JSON, OpenTelemetry spans, and
-OpenInference/Phoenix spans. The same generic plugin config path can initialize
+observability component can export as ATIF JSON and typed OpenTelemetry spans,
+including the OpenInference projection for Phoenix. The same generic plugin config path can initialize
 Adaptive components for hook-backed telemetry learning.
 
 This public OpenClaw plugin package uses OpenClaw public hooks. It can run
@@ -33,8 +33,8 @@ through a public plugin hook.
 - Generic NeMo Relay plugin initialization through `config.plugins`.
 - ATIF JSON export through the built-in `observability` component.
 - Adaptive plugin initialization through `config.plugins`.
-- Optional OpenTelemetry OTLP export.
-- Optional OpenInference/Phoenix OTLP export.
+- Optional typed OpenTelemetry OTLP endpoints using `full`, `gen_ai`, or
+  `openinference` projection.
 - Bounded LLM replay correlation across supported OpenClaw hooks.
 - Tool span replay with conservative privacy defaults.
 - Admin-scoped `nemoRelay.status` gateway health method.
@@ -82,7 +82,7 @@ OpenClaw plugin configuration under `plugins.entries["nemo-relay"].config`:
                 "kind": "observability",
                 "enabled": true,
                 "config": {
-                  "version": 1,
+                  "version": 3,
                   "atif": {
                     "enabled": true,
                     "agent_name": "openclaw",
@@ -90,15 +90,20 @@ OpenClaw plugin configuration under `plugins.entries["nemo-relay"].config`:
                   },
                   "opentelemetry": {
                     "enabled": false,
-                    "transport": "http_binary",
-                    "endpoint": "http://localhost:4318/v1/traces",
-                    "service_name": "openclaw-nemo-relay"
-                  },
-                  "openinference": {
-                    "enabled": false,
-                    "transport": "http_binary",
-                    "endpoint": "http://localhost:6006/v1/traces",
-                    "service_name": "openclaw-nemo-relay"
+                    "endpoints": [
+                      {
+                        "type": "full",
+                        "transport": "http_binary",
+                        "endpoint": "http://localhost:4318/v1/traces",
+                        "service_name": "openclaw-nemo-relay"
+                      },
+                      {
+                        "type": "openinference",
+                        "transport": "http_binary",
+                        "endpoint": "http://localhost:6006/v1/traces",
+                        "service_name": "openclaw-nemo-relay"
+                      }
+                    ]
                   }
                 }
               },
@@ -156,11 +161,10 @@ do not use, or set their `enabled` fields to `false`.
   `adaptive`.
 - `config.plugins.components[].config.atif` writes ATIF trajectory JSON files.
   Set `output_directory` to the directory where OpenClaw should write files.
-- `config.plugins.components[].config.opentelemetry` sends generic OTLP spans to
-  an OpenTelemetry collector when `enabled` is `true`.
-- `config.plugins.components[].config.openinference` sends OpenInference OTLP
-  spans to Phoenix or another OpenInference-compatible collector when `enabled`
-  is `true`.
+- `config.plugins.components[].config.opentelemetry.endpoints` sends typed OTLP
+  spans when the OpenTelemetry section is enabled. Use `full` for the complete
+  NeMo Relay projection, `gen_ai` for standardized GenAI conventions, or
+  `openinference` for Phoenix and other OpenInference-compatible collectors.
 - `config.plugins.components[]` entries with `kind: "adaptive"` initialize the
   Adaptive plugin. In hook-backed OpenClaw mode, adaptive telemetry can consume
   replayed NeMo Relay events, while request-rewrite features such as adaptive
@@ -191,9 +195,9 @@ sink:
 
 - ATIF: confirm JSON files appear in the configured
   `config.plugins.components[].config.atif.output_directory`.
-- OpenTelemetry: confirm spans arrive at the configured OTLP collector.
-- OpenInference: confirm spans arrive at the configured OpenInference/Phoenix
-  endpoint.
+- Typed OpenTelemetry: confirm spans arrive at every configured OTLP endpoint;
+  for an `openinference` endpoint, confirm the projected spans appear in
+  Phoenix or another OpenInference-compatible backend.
 
 The plugin also registers the `operator.admin` scoped gateway method
 `nemoRelay.status`. If your CLI is already paired with admin-capable gateway
@@ -229,9 +233,9 @@ session emits the relevant LLM, message-write, and tool hooks.
 
 If no export output appears, verify
 `config.plugins.components[].config.atif.output_directory`,
-`config.plugins.components[].config.opentelemetry.endpoint`, or
-`config.plugins.components[].config.openinference.endpoint`, then confirm the
-configured collector or output directory is reachable.
+or each
+`config.plugins.components[].config.opentelemetry.endpoints[].endpoint`, then
+confirm the configured collector or output directory is reachable.
 
 ## Development
 

package/dist/index.js

@@ -12,7 +12,7 @@ import { registerNemoRelayPlugin } from './src/runtime-state.js';
 const nemoRelayPluginEntry = definePluginEntry({
     id: 'nemo-relay',
     name: 'NeMo Relay Observability',
-    description: 'ATIF, OpenInference, and OpenTelemetry telemetry through NeMo Relay',
+    description: 'ATIF and typed OpenTelemetry telemetry through NeMo Relay',
     configSchema: nemoRelayConfigSchema,
     register(api) {
         registerNemoRelayPlugin(api);

package/dist/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
     "id": "nemo-relay",
     "name": "NeMo Relay Observability",
-    "description": "ATIF, OpenInference, and OpenTelemetry telemetry through NeMo Relay.",
+    "description": "ATIF and typed OpenTelemetry telemetry through NeMo Relay.",
     "activation": {
         "onStartup": true
     },
@@ -25,7 +25,7 @@
             },
             "plugins": {
                 "$ref": "#/$defs/nemoRelayPluginConfig",
-                "description": "Generic NeMo Relay plugin configuration document. Use the observability component to configure ATIF, OpenTelemetry, and OpenInference exporters."
+                "description": "Generic NeMo Relay plugin configuration document. Use the observability component to configure ATIF and typed OpenTelemetry exporters."
             },
             "capture": {
                 "type": "object",

package/dist/src/config.js

@@ -119,7 +119,7 @@ function rejectRemovedFields(raw) {
         throw new Error('atif was removed; configure plugins.components[].config.atif on the observability component');
     }
     if (raw.telemetry !== undefined) {
-        throw new Error('telemetry was removed; configure plugins.components[].config.opentelemetry or openinference on the observability component');
+        throw new Error('telemetry was removed; configure plugins.components[].config.opentelemetry.endpoints on the observability component');
     }
 }
 /** Keep parser behavior aligned with the manifest's additionalProperties=false contract. */

package/dist/src/health.js

@@ -36,8 +36,13 @@ function configuredObservabilityOutputs(config) {
         }
         const componentConfig = asRecord(record.config);
         outputs.atif ||= sectionEnabled(componentConfig?.atif);
-        outputs.otel ||= sectionEnabled(componentConfig?.opentelemetry);
-        outputs.openInference ||= sectionEnabled(componentConfig?.openinference);
+        const opentelemetry = asRecord(componentConfig?.opentelemetry);
+        const opentelemetryEnabled = sectionEnabled(opentelemetry);
+        outputs.otel ||= opentelemetryEnabled;
+        outputs.openInference ||=
+            opentelemetryEnabled &&
+                Array.isArray(opentelemetry?.endpoints) &&
+                opentelemetry.endpoints.some((endpoint) => asRecord(endpoint)?.type === 'openinference');
     }
     return outputs;
 }

package/dist/src/hooks-backend.js

@@ -281,7 +281,7 @@ export class HookReplayBackend {
         this.materializeDeferredSessionRoot(session);
         drainSession(this.sessionManager(), session);
         closeSessionRoot(this.sessionManager(), session, summary, session.finalOutput ?? summary, metadata);
-        this.flushSubscriberDelivery('session_close');
+        await this.flushSubscriberDelivery('session_close');
         this.forgetPendingSubagentLineage(session);
         deleteSession(this.stateValue, session);
     }
@@ -316,9 +316,9 @@ export class HookReplayBackend {
         }
     }
     /** Wait for native subscriber/exporter delivery after a replay closure boundary. */
-    flushSubscriberDelivery(label) {
+    async flushSubscriberDelivery(label) {
         try {
-            this.nf.flushSubscribers?.();
+            await this.nf.flushSubscribers?.();
         }
         catch (error) {
             this.logBoundedWarn(`flush-subscribers:${label}`, `nemo-relay subscriber flush failed: label=${label} error=${toMessage(error)}`);

package/index.ts

@@ -17,7 +17,7 @@ type NemoRelayPluginEntry = ReturnType<typeof definePluginEntry>;
 const nemoRelayPluginEntry: NemoRelayPluginEntry = definePluginEntry({
   id: 'nemo-relay',
   name: 'NeMo Relay Observability',
-  description: 'ATIF, OpenInference, and OpenTelemetry telemetry through NeMo Relay',
+  description: 'ATIF and typed OpenTelemetry telemetry through NeMo Relay',
   configSchema: nemoRelayConfigSchema,
   register(api: OpenClawPluginApi) {
     registerNemoRelayPlugin(api);

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "nemo-relay",
   "name": "NeMo Relay Observability",
-  "description": "ATIF, OpenInference, and OpenTelemetry telemetry through NeMo Relay.",
+  "description": "ATIF and typed OpenTelemetry telemetry through NeMo Relay.",
   "activation": {
     "onStartup": true
   },
@@ -25,7 +25,7 @@
       },
       "plugins": {
         "$ref": "#/$defs/nemoRelayPluginConfig",
-        "description": "Generic NeMo Relay plugin configuration document. Use the observability component to configure ATIF, OpenTelemetry, and OpenInference exporters."
+        "description": "Generic NeMo Relay plugin configuration document. Use the observability component to configure ATIF and typed OpenTelemetry exporters."
       },
       "capture": {
         "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nemo-relay-openclaw",
-  "version": "0.6.0",
+  "version": "0.7.0-rc.2",
   "description": "NeMo Relay-authored observability plugin for OpenClaw.",
   "type": "module",
   "repository": {
@@ -63,7 +63,7 @@
     "openclaw": "^2026.7.1"
   },
   "dependencies": {
-    "nemo-relay-node": "0.6.0"
+    "nemo-relay-node": "0.7.0-rc.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/config.ts

@@ -178,7 +178,7 @@ function rejectRemovedFields(raw: Record<string, unknown>): void {
   }
   if (raw.telemetry !== undefined) {
     throw new Error(
-      'telemetry was removed; configure plugins.components[].config.opentelemetry or openinference on the observability component',
+      'telemetry was removed; configure plugins.components[].config.opentelemetry.endpoints on the observability component',
     );
   }
 }

package/src/health.ts

@@ -85,8 +85,13 @@ function configuredObservabilityOutputs(config: NemoRelayHookBackendConfig): {
 
     const componentConfig = asRecord(record.config);
     outputs.atif ||= sectionEnabled(componentConfig?.atif);
-    outputs.otel ||= sectionEnabled(componentConfig?.opentelemetry);
-    outputs.openInference ||= sectionEnabled(componentConfig?.openinference);
+    const opentelemetry = asRecord(componentConfig?.opentelemetry);
+    const opentelemetryEnabled = sectionEnabled(opentelemetry);
+    outputs.otel ||= opentelemetryEnabled;
+    outputs.openInference ||=
+      opentelemetryEnabled &&
+      Array.isArray(opentelemetry?.endpoints) &&
+      opentelemetry.endpoints.some((endpoint) => asRecord(endpoint)?.type === 'openinference');
   }
 
   return outputs;

package/src/hooks-backend.ts

@@ -426,7 +426,7 @@ export class HookReplayBackend {
     this.materializeDeferredSessionRoot(session);
     drainSession(this.sessionManager(), session);
     closeSessionRoot(this.sessionManager(), session, summary, session.finalOutput ?? summary, metadata);
-    this.flushSubscriberDelivery('session_close');
+    await this.flushSubscriberDelivery('session_close');
     this.forgetPendingSubagentLineage(session);
     deleteSession(this.stateValue, session);
   }
@@ -466,9 +466,9 @@ export class HookReplayBackend {
   }
 
   /** Wait for native subscriber/exporter delivery after a replay closure boundary. */
-  private flushSubscriberDelivery(label: string): void {
+  private async flushSubscriberDelivery(label: string): Promise<void> {
     try {
-      this.nf.flushSubscribers?.();
+      await this.nf.flushSubscribers?.();
     } catch (error) {
       this.logBoundedWarn(
         `flush-subscribers:${label}`,