docs(gateway): update originAgent JSDoc to reflect separate display field

wherewolf87 · wherewolf87 · commit abbb28f27a0c · 2026-05-09T20:05:02.000-04:00
Stale JSDoc claimed originAgent stamps the persisted entry's provider field, but the revised design (commit bf61a0c) preserves the provider/model sentinel pair unchanged and persists originAgent as a separate display-attribution field. Doc now matches behavior; also notes that empty/whitespace values are treated as unset. Addresses clawsweeper P3 review feedback on PR #79959.
diff --git a/src/gateway/server-methods/chat-transcript-inject.ts b/src/gateway/server-methods/chat-transcript-inject.ts
@@ -48,9 +48,12 @@ export async function appendInjectedAssistantMessageToTranscript(params: {
   message: string;
   label?: string;
   /**
-   * When set, stamps the persisted assistant entry's `provider` field so
+   * When set, persists a separate `originAgent` field on the assistant entry so
    * downstream UIs (avatar/handle resolvers) can attribute the inject to a
-   * non-OpenClaw source (e.g. "hermes", "codex"). Default remains "openclaw".
+   * non-OpenClaw source (e.g. "hermes", "codex"). The sentinel `provider:
+   * "openclaw"` + `model: "gateway-injected"` pair is preserved unchanged so
+   * the replay-history filter still drops these rows from model replay.
+   * Whitespace-only or empty values are treated as unset.
    */
   originAgent?: string;
   /** When set, used as the assistant `content` array (e.g. text + embedded audio blocks). */
