nemo-relay-openclaw 0.3.0-rc.1 → 0.3.0

package/README.md

@@ -12,10 +12,11 @@ observability component can export as ATIF JSON, OpenTelemetry spans, and
 OpenInference/Phoenix spans. 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 does not
-rewrite OpenClaw tool execution, provider routing, policy decisions, or model
-requests. For middleware-backed behavior that changes execution, use the
-patch-based OpenClaw integration from the NeMo Relay repository.
+This public OpenClaw plugin package uses OpenClaw public hooks. It can run
+pre-tool conditional guardrails when OpenClaw invokes the before-tool hook, but
+it does not rewrite provider routing or model requests. For middleware-backed
+behavior that changes execution, use the patch-based OpenClaw integration from
+the NeMo Relay repository.
 
 ## Why Use It?
 
@@ -204,11 +205,10 @@ openclaw gateway call nemoRelay.status --json
 
 ## Current Limits
 
-The plugin maps supported OpenClaw hook events into NeMo Relay telemetry without
-changing OpenClaw execution behavior.
+The plugin maps supported OpenClaw hook events into NeMo Relay telemetry and can
+run pre-tool conditional guardrail checks.
 
-It does not change OpenClaw tool execution, provider routing, policy decisions,
-or provider request payloads.
+It does not rewrite provider routing or provider request payloads.
 
 Current OpenClaw public hooks expose request, response, message-write, and
 provider timing details through separate event streams. The plugin correlates

package/dist/src/hook-replay/llm.js

@@ -324,12 +324,14 @@ export function buildReplayLlmRequest(input, output, config, source = 'openclaw.
 /** Build the response payload passed to NeMo Relay for a replayed LLM span. */
 export function buildReplayLlmResponse(event, timing, config) {
     const usage = mapUsage(event.usage);
-    const assistantToolCallNames = toolCallNames(event.assistantToolCalls);
+    const assistantToolCalls = assistantToolCallsForOutput(event, config);
+    const assistantToolCallNames = toolCallNames(assistantToolCalls);
     return toJsonValue({
         role: 'assistant',
         content: config.capture.includeResponses
             ? responseContent(event.assistantTexts, assistantToolCallNames)
             : undefined,
+        tool_calls: assistantToolCalls.length > 0 ? assistantToolCalls : undefined,
         assistant_texts_count: event.assistantTexts.length,
         resolved_ref: event.resolvedRef,
         harness_id: event.harnessId,
@@ -347,6 +349,13 @@ export function buildReplayLlmResponse(event, timing, config) {
         },
     });
 }
+/** Return assistant tool calls from the current OpenClaw llm_output contract. */
+function assistantToolCallsForOutput(event, config) {
+    const explicit = Array.isArray(event.assistantToolCalls) ? event.assistantToolCalls : [];
+    const inferred = explicit.length > 0 || !isRecord(event.lastAssistant) ? explicit : extractToolCalls(event.lastAssistant);
+    const snapshot = snapshotMessages(inferred);
+    return config.capture.stripToolArgs ? snapshot.map(stripToolCallArgs) : snapshot;
+}
 /** Replay an output whose matching input never arrived before the grace timeout. */
 function replayExpiredPendingOutput(manager, key, record) {
     try {
@@ -658,6 +667,9 @@ function stripToolCallArgs(value) {
             stripped[key] = { stripped: true };
         }
     }
+    if (isRecord(stripped.function) && stripped.function.arguments !== undefined) {
+        stripped.function = { ...stripped.function, arguments: { stripped: true } };
+    }
     return stripped;
 }
 /** Strip provider thinking/signature payloads that are noisy in trace UIs. */
@@ -761,6 +773,8 @@ function extractToolCalls(message) {
 function isToolCallLike(value) {
     return (isRecord(value) &&
         (value.type === 'toolCall' ||
+            value.type === 'toolcall' ||
+            value.type === 'function_call' ||
             value.type === 'tool_use' ||
             value.type === 'tool-call' ||
             value.toolName !== undefined ||
@@ -776,13 +790,21 @@ function toolCallNames(toolCalls) {
         if (!isRecord(toolCall)) {
             continue;
         }
-        const name = stringField(toolCall, 'name') ?? stringField(toolCall, 'toolName') ?? stringField(toolCall, 'functionName');
+        const name = stringField(toolCall, 'name') ??
+            stringField(toolCall, 'toolName') ??
+            stringField(toolCall, 'functionName') ??
+            functionToolCallName(toolCall);
         if (name) {
             names.push(name);
         }
     }
     return names;
 }
+/** Read OpenAI-style nested function tool-call names. */
+function functionToolCallName(toolCall) {
+    const fn = toolCall.function;
+    return isRecord(fn) ? stringField(fn, 'name') : undefined;
+}
 /** Convert stored message-write usage back into the llm_output usage contract. */
 function mapHookUsage(usage) {
     const mapped = mapUsage(usage);

package/package.json

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

package/src/hook-replay/llm.ts

@@ -451,12 +451,14 @@ export function buildReplayLlmResponse(
   config: NemoRelayHookBackendConfig,
 ): JsonValue {
   const usage = mapUsage(event.usage);
-  const assistantToolCallNames = toolCallNames(event.assistantToolCalls);
+  const assistantToolCalls = assistantToolCallsForOutput(event, config);
+  const assistantToolCallNames = toolCallNames(assistantToolCalls);
   return toJsonValue({
     role: 'assistant',
     content: config.capture.includeResponses
       ? responseContent(event.assistantTexts, assistantToolCallNames)
       : undefined,
+    tool_calls: assistantToolCalls.length > 0 ? assistantToolCalls : undefined,
     assistant_texts_count: event.assistantTexts.length,
     resolved_ref: event.resolvedRef,
     harness_id: event.harnessId,
@@ -475,6 +477,17 @@ export function buildReplayLlmResponse(
   });
 }
 
+/** Return assistant tool calls from the current OpenClaw llm_output contract. */
+function assistantToolCallsForOutput(
+  event: PluginHookLlmOutputEvent,
+  config: NemoRelayHookBackendConfig,
+): unknown[] {
+  const explicit = Array.isArray(event.assistantToolCalls) ? event.assistantToolCalls : [];
+  const inferred = explicit.length > 0 || !isRecord(event.lastAssistant) ? explicit : extractToolCalls(event.lastAssistant);
+  const snapshot = snapshotMessages(inferred);
+  return config.capture.stripToolArgs ? snapshot.map(stripToolCallArgs) : snapshot;
+}
+
 /** Replay an output whose matching input never arrived before the grace timeout. */
 function replayExpiredPendingOutput(manager: SessionManager, key: string, record: PendingLlmOutputRecord): void {
   try {
@@ -855,6 +868,9 @@ function stripToolCallArgs(value: unknown): unknown {
       stripped[key] = { stripped: true };
     }
   }
+  if (isRecord(stripped.function) && stripped.function.arguments !== undefined) {
+    stripped.function = { ...stripped.function, arguments: { stripped: true } };
+  }
   return stripped;
 }
 
@@ -969,6 +985,8 @@ function isToolCallLike(value: unknown): boolean {
   return (
     isRecord(value) &&
     (value.type === 'toolCall' ||
+      value.type === 'toolcall' ||
+      value.type === 'function_call' ||
       value.type === 'tool_use' ||
       value.type === 'tool-call' ||
       value.toolName !== undefined ||
@@ -987,7 +1005,10 @@ function toolCallNames(toolCalls: unknown[] | undefined): string[] {
       continue;
     }
     const name =
-      stringField(toolCall, 'name') ?? stringField(toolCall, 'toolName') ?? stringField(toolCall, 'functionName');
+      stringField(toolCall, 'name') ??
+      stringField(toolCall, 'toolName') ??
+      stringField(toolCall, 'functionName') ??
+      functionToolCallName(toolCall);
     if (name) {
       names.push(name);
     }
@@ -995,6 +1016,12 @@ function toolCallNames(toolCalls: unknown[] | undefined): string[] {
   return names;
 }
 
+/** Read OpenAI-style nested function tool-call names. */
+function functionToolCallName(toolCall: Record<string, unknown>): string | undefined {
+  const fn = toolCall.function;
+  return isRecord(fn) ? stringField(fn, 'name') : undefined;
+}
+
 /** Convert stored message-write usage back into the llm_output usage contract. */
 function mapHookUsage(usage: unknown): PluginHookLlmOutputEvent['usage'] | undefined {
   const mapped = mapUsage(usage);