nemo-relay-openclaw 0.8.4 → 0.9.0-rc.2

package/dist/src/modules.d.ts

@@ -8,10 +8,11 @@ import type * as NemoRelayRuntime from 'nemo-relay-node';
 import type * as NemoRelayAdaptive from 'nemo-relay-node/adaptive';
 import type * as NemoRelayPluginHost from 'nemo-relay-node/plugin';
 type NemoRelayRuntimeKeys = 'ScopeType' | 'createScopeStack' | 'currentScopeStack' | 'setThreadScopeStack' | 'pushScope' | 'popScope' | 'event' | 'llmCall' | 'llmCallEnd' | 'toolCall' | 'toolCallEnd' | 'toolConditionalExecution';
-type NemoRelayPluginHostKeys = 'defaultConfig' | 'validate' | 'initialize' | 'clear';
+type NemoRelayPluginHostKeys = 'defaultConfig' | 'validate' | 'initialize';
 type NemoRelayAdaptiveKeys = 'ADAPTIVE_PLUGIN_KIND' | 'ComponentSpec';
 export type ConfigDiagnostic = NemoRelayPluginHost.ConfigDiagnostic;
 export type ConfigReport = NemoRelayPluginHost.ConfigReport;
+export type PluginHostActivation = NemoRelayPluginHost.PluginHostActivation;
 /**
  * @internal Package-owned subset of the dynamically imported `nemo-relay-node`
  * namespace used by this integration.

package/dist/src/runtime-state.d.ts

@@ -19,7 +19,7 @@ export declare class NemoRelayRuntimeState {
     private loadPromise;
     private startPromise;
     private statusValue;
-    private modulesValue?;
+    private pluginHostActivation;
     private backendValue;
     private initializedPluginHost;
     private pluginHostOutputsHealthy;

package/dist/src/runtime-state.js

@@ -15,7 +15,7 @@ export class NemoRelayRuntimeState {
     loadPromise;
     startPromise;
     statusValue = { state: 'not_initialized' };
-    modulesValue;
+    pluginHostActivation;
     backendValue;
     initializedPluginHost = false;
     pluginHostOutputsHealthy = false;
@@ -79,7 +79,6 @@ export class NemoRelayRuntimeState {
         try {
             this.loadPromise ??= this.moduleLoader();
             modules = await this.loadPromise;
-            this.modulesValue = modules;
         }
         catch (error) {
             this.loadPromise = undefined;
@@ -97,19 +96,20 @@ export class NemoRelayRuntimeState {
             degradedReason = validationReport.reason;
             ctx.logger.warn?.(degradedReason);
         }
-        else if (validationReport.report.diagnostics.some((diagnostic) => diagnostic.level === 'error')) {
+        else if (validationReport.report.config.diagnostics.some((diagnostic) => diagnostic.level === 'error')) {
             degradedReason = 'NeMo Relay plugin host config validation failed';
         }
         else {
-            if (validationReport.report.diagnostics.some((diagnostic) => diagnostic.level === 'warning') &&
+            if (validationReport.report.config.diagnostics.some((diagnostic) => diagnostic.level === 'warning') &&
                 degradedReason === undefined) {
                 degradedReason = 'NeMo Relay plugin host config validation produced warnings';
             }
             try {
-                const activationReport = await modules.pluginHost.initialize(hostConfig);
-                logDiagnostics(ctx.logger, activationReport.diagnostics);
+                this.pluginHostActivation = await modules.pluginHost.initialize(hostConfig);
+                const activationDiagnostics = this.pluginHostActivation.report.config.diagnostics;
+                logDiagnostics(ctx.logger, activationDiagnostics);
                 this.initializedPluginHost = true;
-                const hasInitializationErrors = activationReport.diagnostics.some((diagnostic) => diagnostic.level === 'error');
+                const hasInitializationErrors = activationDiagnostics.some((diagnostic) => diagnostic.level === 'error');
                 this.pluginHostOutputsHealthy = !hasInitializationErrors;
                 if (hasInitializationErrors) {
                     degradedReason ??= 'NeMo Relay plugin host initialization reported errors';
@@ -175,18 +175,24 @@ export class NemoRelayRuntimeState {
             this.lastCounters = { ...backendState.counters };
         }
         this.backendValue = undefined;
-        if (this.initializedPluginHost && this.modulesValue) {
+        let pluginHostCloseFailure;
+        if (this.pluginHostActivation) {
             try {
-                this.modulesValue.pluginHost.clear();
+                await this.pluginHostActivation.close();
             }
             catch (error) {
-                log.warn?.(`failed to clear NeMo Relay plugin host: ${toMessage(error)}`);
+                pluginHostCloseFailure = `failed to close NeMo Relay plugin host: ${toMessage(error)}`;
+                log.warn?.(pluginHostCloseFailure);
+            }
+            if (pluginHostCloseFailure === undefined) {
+                this.pluginHostActivation = undefined;
+                this.initializedPluginHost = false;
+                this.pluginHostOutputsHealthy = false;
             }
-            this.initializedPluginHost = false;
-            this.pluginHostOutputsHealthy = false;
         }
         this.started = false;
-        this.statusValue = finalStatus;
+        this.statusValue =
+            pluginHostCloseFailure === undefined ? finalStatus : { state: 'degraded', reason: pluginHostCloseFailure };
     }
     /** Handle OpenClaw runtime lifecycle cleanup for either a session or the backend. */
     async cleanup(ctx) {
@@ -381,7 +387,7 @@ function registerToolCallMiddleware(api, runtime) {
 function validatePluginHostConfig(modules, config, logger) {
     try {
         const report = modules.pluginHost.validate(config);
-        logDiagnostics(logger, report.diagnostics);
+        logDiagnostics(logger, report.config.diagnostics);
         return { ok: true, report };
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nemo-relay-openclaw",
-  "version": "0.8.4",
+  "version": "0.9.0-rc.2",
   "description": "NeMo Relay-authored observability plugin for OpenClaw.",
   "type": "module",
   "repository": {
@@ -42,12 +42,12 @@
       "./dist/index.js"
     ],
     "compat": {
-      "pluginApi": ">=2026.7.1-2",
-      "minGatewayVersion": "2026.7.1-2"
+      "pluginApi": ">=2026.9.3",
+      "minGatewayVersion": "2026.9.3"
     },
     "build": {
-      "openclawVersion": "2026.7.1-2",
-      "pluginSdkVersion": "2026.7.1-2"
+      "openclawVersion": "2026.9.3",
+      "pluginSdkVersion": "2026.9.3"
     }
   },
   "scripts": {
@@ -60,13 +60,19 @@
     "test:live": "npm run build:test && node scripts/test-live.mjs"
   },
   "peerDependencies": {
-    "openclaw": "2026.7.1-2"
+    "openclaw": "2026.9.3"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
   },
   "dependencies": {
-    "nemo-relay-node": "0.8.4"
+    "nemo-relay-node": "0.9.0-rc.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "openclaw": "2026.9.3",
     "typescript": "^5.8.2"
   },
   "license": "Apache-2.0"

package/src/modules.ts

@@ -25,11 +25,12 @@ type NemoRelayRuntimeKeys =
   | 'toolCallEnd'
   | 'toolConditionalExecution';
 
-type NemoRelayPluginHostKeys = 'defaultConfig' | 'validate' | 'initialize' | 'clear';
+type NemoRelayPluginHostKeys = 'defaultConfig' | 'validate' | 'initialize';
 type NemoRelayAdaptiveKeys = 'ADAPTIVE_PLUGIN_KIND' | 'ComponentSpec';
 
 export type ConfigDiagnostic = NemoRelayPluginHost.ConfigDiagnostic;
 export type ConfigReport = NemoRelayPluginHost.ConfigReport;
+export type PluginHostActivation = NemoRelayPluginHost.PluginHostActivation;
 
 /**
  * @internal Package-owned subset of the dynamically imported `nemo-relay-node`

package/src/runtime-state.ts

@@ -26,6 +26,7 @@ import {
   type ConfigDiagnostic,
   type NemoRelayModules,
   type NemoRelayModuleLoader,
+  type PluginHostActivation,
 } from './modules.js';
 import type { RuntimeStateOptions, StartContext } from './types.js';
 
@@ -52,7 +53,7 @@ export class NemoRelayRuntimeState {
   private loadPromise: Promise<NemoRelayModules> | undefined;
   private startPromise: Promise<void> | undefined;
   private statusValue: HookReplayBackendStatus = { state: 'not_initialized' };
-  private modulesValue?: NemoRelayModules;
+  private pluginHostActivation: PluginHostActivation | undefined;
   private backendValue: HookReplayBackend | undefined;
   private initializedPluginHost = false;
   private pluginHostOutputsHealthy = false;
@@ -124,7 +125,6 @@ export class NemoRelayRuntimeState {
     try {
       this.loadPromise ??= this.moduleLoader();
       modules = await this.loadPromise;
-      this.modulesValue = modules;
     } catch (error) {
       this.loadPromise = undefined;
       this.statusValue = { state: 'degraded', reason: `failed to load nemo-relay-node: ${toMessage(error)}` };
@@ -143,21 +143,22 @@ export class NemoRelayRuntimeState {
     if (!validationReport.ok) {
       degradedReason = validationReport.reason;
       ctx.logger.warn?.(degradedReason);
-    } else if (validationReport.report.diagnostics.some((diagnostic) => diagnostic.level === 'error')) {
+    } else if (validationReport.report.config.diagnostics.some((diagnostic) => diagnostic.level === 'error')) {
       degradedReason = 'NeMo Relay plugin host config validation failed';
     } else {
       if (
-        validationReport.report.diagnostics.some((diagnostic) => diagnostic.level === 'warning') &&
+        validationReport.report.config.diagnostics.some((diagnostic) => diagnostic.level === 'warning') &&
         degradedReason === undefined
       ) {
         degradedReason = 'NeMo Relay plugin host config validation produced warnings';
       }
 
       try {
-        const activationReport = await modules.pluginHost.initialize(hostConfig);
-        logDiagnostics(ctx.logger, activationReport.diagnostics);
+        this.pluginHostActivation = await modules.pluginHost.initialize(hostConfig);
+        const activationDiagnostics = this.pluginHostActivation.report.config.diagnostics;
+        logDiagnostics(ctx.logger, activationDiagnostics);
         this.initializedPluginHost = true;
-        const hasInitializationErrors = activationReport.diagnostics.some((diagnostic) => diagnostic.level === 'error');
+        const hasInitializationErrors = activationDiagnostics.some((diagnostic) => diagnostic.level === 'error');
         this.pluginHostOutputsHealthy = !hasInitializationErrors;
         if (hasInitializationErrors) {
           degradedReason ??= 'NeMo Relay plugin host initialization reported errors';
@@ -238,18 +239,24 @@ export class NemoRelayRuntimeState {
     }
     this.backendValue = undefined;
 
-    if (this.initializedPluginHost && this.modulesValue) {
+    let pluginHostCloseFailure: string | undefined;
+    if (this.pluginHostActivation) {
       try {
-        this.modulesValue.pluginHost.clear();
+        await this.pluginHostActivation.close();
       } catch (error) {
-        log.warn?.(`failed to clear NeMo Relay plugin host: ${toMessage(error)}`);
+        pluginHostCloseFailure = `failed to close NeMo Relay plugin host: ${toMessage(error)}`;
+        log.warn?.(pluginHostCloseFailure);
+      }
+      if (pluginHostCloseFailure === undefined) {
+        this.pluginHostActivation = undefined;
+        this.initializedPluginHost = false;
+        this.pluginHostOutputsHealthy = false;
       }
-      this.initializedPluginHost = false;
-      this.pluginHostOutputsHealthy = false;
     }
 
     this.started = false;
-    this.statusValue = finalStatus;
+    this.statusValue =
+      pluginHostCloseFailure === undefined ? finalStatus : { state: 'degraded', reason: pluginHostCloseFailure };
   }
 
   /** Handle OpenClaw runtime lifecycle cleanup for either a session or the backend. */
@@ -513,7 +520,7 @@ function validatePluginHostConfig(
 ): { ok: true; report: ReturnType<NemoRelayModules['pluginHost']['validate']> } | { ok: false; reason: string } {
   try {
     const report = modules.pluginHost.validate(config);
-    logDiagnostics(logger, report.diagnostics);
+    logDiagnostics(logger, report.config.diagnostics);
     return { ok: true, report };
   } catch (error) {
     return {