fix(twitch): strip internal tool-trace banners from outbound text

clawsweeper[bot] · masatohoshino · clawsweeper[bot] · commit 5dad685b60df · 2026-07-09T21:00:36.000Z
Co-authored-by: Masato Hoshino &lt;246810661+masatohoshino@users.noreply.github.com&gt;
diff --git a/extensions/twitch/src/outbound-tool-trace-sanitize.test.ts b/extensions/twitch/src/outbound-tool-trace-sanitize.test.ts
@@ -0,0 +1,33 @@
+// Twitch outbound must strip assistant internal tool-trace scaffolding before
+// delivery (#90684). The hook runs in core delivery before chunk planning, so
+// the 500-char Twitch chunker only ever sees sanitized text.
+import { describe, expect, it } from "vitest";
+import { twitchPlugin } from "./plugin.js";
+
+function sanitizeOutboundText(text: string): string {
+  const sanitizeText = twitchPlugin.outbound?.sanitizeText;
+  if (!sanitizeText) {
+    throw new Error("Expected Twitch outbound sanitizeText hook");
+  }
+  return sanitizeText({ text, payload: { text } });
+}
+
+describe("twitch outbound sanitizeText", () => {
+  it("strips internal tool-trace banners before outbound delivery", () => {
+    const text = "Done.\n⚠️ 🛠️ `search repos (agent)` failed";
+
+    expect(sanitizeOutboundText(text)).toBe("Done.");
+  });
+
+  it("strips XML tool-call scaffolding leaked into assistant text", () => {
+    const text = '<tool_call>{"name":"exec"}</tool_call>Stream is live.';
+
+    expect(sanitizeOutboundText(text)).toBe("Stream is live.");
+  });
+
+  it("preserves ordinary assistant prose while sanitizing", () => {
+    const text = "The pipeline has 3 open deals.";
+
+    expect(sanitizeOutboundText(text)).toBe(text);
+  });
+});
diff --git a/extensions/twitch/src/outbound.ts b/extensions/twitch/src/outbound.ts
@@ -12,6 +12,7 @@ import {
   type MessageReceiptPartKind,
 } from "openclaw/plugin-sdk/channel-outbound";
 import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { sanitizeAssistantVisibleText } from "openclaw/plugin-sdk/text-chunking";
 import { resolveTwitchAccountContext } from "./config.js";
 import { sendMessageTwitchInternal } from "./send.js";
 import type {
@@ -43,6 +44,9 @@ export const twitchOutbound: ChannelOutboundAdapter = {
   /** Twitch chat message limit is 500 characters */
   textChunkLimit: 500,
 
+  /** Strip internal assistant tool-trace scaffolding before delivery */
+  sanitizeText: ({ text }) => sanitizeAssistantVisibleText(text),
+
   /** Word-boundary chunker with markdown stripping */
   chunker: chunkTextForTwitch,
 
