fix: contain block reply media failures

src/auto-reply/reply/agent-runner-payloads.test.ts

@@ -32,6 +32,32 @@ describe("buildReplyPayloads media filter integration", () => {
     expect(replyPayloads[0].mediaUrl).toBe("file:///tmp/photo.jpg");
   });
 
+  it("normalizes sent media URLs before deduping normalized reply media", async () => {
+    const normalizeMediaPaths = async (payload: { mediaUrl?: string; mediaUrls?: string[] }) => {
+      const normalizeMedia = (value?: string) =>
+        value === "./out/photo.jpg" ? "/tmp/workspace/out/photo.jpg" : value;
+      return {
+        ...payload,
+        mediaUrl: normalizeMedia(payload.mediaUrl),
+        mediaUrls: payload.mediaUrls?.map((value) => normalizeMedia(value) ?? value),
+      };
+    };
+
+    const { replyPayloads } = await buildReplyPayloads({
+      ...baseParams,
+      payloads: [{ text: "hello", mediaUrl: "./out/photo.jpg" }],
+      messagingToolSentMediaUrls: ["./out/photo.jpg"],
+      normalizeMediaPaths,
+    });
+
+    expect(replyPayloads).toHaveLength(1);
+    expect(replyPayloads[0]).toMatchObject({
+      text: "hello",
+      mediaUrl: undefined,
+      mediaUrls: undefined,
+    });
+  });
+
   it("applies media filter after text filter", async () => {
     const { replyPayloads } = await buildReplyPayloads({
       ...baseParams,

src/auto-reply/reply/agent-runner-payloads.ts

@@ -20,6 +20,51 @@ import {
   shouldSuppressMessagingToolReplies,
 } from "./reply-payloads.js";
 
+async function normalizeSentMediaUrlsForDedupe(params: {
+  sentMediaUrls: string[];
+  normalizeMediaPaths?: (payload: ReplyPayload) => Promise<ReplyPayload>;
+}): Promise<string[]> {
+  if (params.sentMediaUrls.length === 0 || !params.normalizeMediaPaths) {
+    return params.sentMediaUrls;
+  }
+
+  const normalizedUrls: string[] = [];
+  const seen = new Set<string>();
+  for (const raw of params.sentMediaUrls) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+      continue;
+    }
+    if (!seen.has(trimmed)) {
+      seen.add(trimmed);
+      normalizedUrls.push(trimmed);
+    }
+    try {
+      const normalized = await params.normalizeMediaPaths({
+        mediaUrl: trimmed,
+        mediaUrls: [trimmed],
+      });
+      const normalizedMediaUrls = normalized.mediaUrls?.length
+        ? normalized.mediaUrls
+        : normalized.mediaUrl
+          ? [normalized.mediaUrl]
+          : [];
+      for (const mediaUrl of normalizedMediaUrls) {
+        const candidate = mediaUrl.trim();
+        if (!candidate || seen.has(candidate)) {
+          continue;
+        }
+        seen.add(candidate);
+        normalizedUrls.push(candidate);
+      }
+    } catch (err) {
+      logVerbose(`messaging tool sent-media normalization failed: ${String(err)}`);
+    }
+  }
+
+  return normalizedUrls;
+}
+
 export async function buildReplyPayloads(params: {
   payloads: ReplyPayload[];
   isHeartbeat: boolean;
@@ -113,6 +158,12 @@ export async function buildReplyPayloads(params: {
   // If target metadata is unavailable, keep legacy dedupe behavior.
   const dedupeMessagingToolPayloads =
     suppressMessagingToolReplies || messagingToolSentTargets.length === 0;
+  const messagingToolSentMediaUrls = dedupeMessagingToolPayloads
+    ? await normalizeSentMediaUrlsForDedupe({
+        sentMediaUrls: params.messagingToolSentMediaUrls ?? [],
+        normalizeMediaPaths: params.normalizeMediaPaths,
+      })
+    : (params.messagingToolSentMediaUrls ?? []);
   const dedupedPayloads = dedupeMessagingToolPayloads
     ? filterMessagingToolDuplicates({
         payloads: replyTaggedPayloads,
@@ -122,7 +173,7 @@ export async function buildReplyPayloads(params: {
   const mediaFilteredPayloads = dedupeMessagingToolPayloads
     ? filterMessagingToolMediaDuplicates({
         payloads: dedupedPayloads,
-        sentMediaUrls: params.messagingToolSentMediaUrls ?? [],
+        sentMediaUrls: messagingToolSentMediaUrls,
       })
     : dedupedPayloads;
   // Filter out payloads already sent via pipeline or directly during tool flush.