feat: mirror delivered outbound messages (#1031)

Co-authored-by: T Savo <TSavo@users.noreply.github.com>

src/gateway/server-methods/send.test.ts

@@ -0,0 +1,102 @@
+import { describe, expect, it, vi } from "vitest";
+
+import type { GatewayRequestContext } from "./types.js";
+import { sendHandlers } from "./send.js";
+
+const mocks = vi.hoisted(() => ({
+  deliverOutboundPayloads: vi.fn(),
+  appendAssistantMessageToSessionTranscript: vi.fn(async () => ({ ok: true, sessionFile: "x" })),
+}));
+
+vi.mock("../../config/config.js", () => ({
+  loadConfig: () => ({}),
+}));
+
+vi.mock("../../channels/plugins/index.js", () => ({
+  getChannelPlugin: () => ({ outbound: {} }),
+  normalizeChannelId: (value: string) => value,
+}));
+
+vi.mock("../../infra/outbound/targets.js", () => ({
+  resolveOutboundTarget: () => ({ ok: true, to: "resolved" }),
+}));
+
+vi.mock("../../infra/outbound/deliver.js", () => ({
+  deliverOutboundPayloads: mocks.deliverOutboundPayloads,
+}));
+
+vi.mock("../../config/sessions.js", async () => {
+  const actual = await vi.importActual<typeof import("../../config/sessions.js")>(
+    "../../config/sessions.js",
+  );
+  return {
+    ...actual,
+    appendAssistantMessageToSessionTranscript: mocks.appendAssistantMessageToSessionTranscript,
+  };
+});
+
+const makeContext = (): GatewayRequestContext =>
+  ({
+    dedupe: new Map(),
+  }) as unknown as GatewayRequestContext;
+
+describe("gateway send mirroring", () => {
+  it("does not mirror when delivery returns no results", async () => {
+    mocks.deliverOutboundPayloads.mockResolvedValue([]);
+
+    const respond = vi.fn();
+    await sendHandlers.send({
+      params: {
+        to: "channel:C1",
+        message: "hi",
+        channel: "slack",
+        idempotencyKey: "idem-1",
+        sessionKey: "agent:main:main",
+      },
+      respond,
+      context: makeContext(),
+      req: { type: "req", id: "1", method: "send" },
+      client: null,
+      isWebchatConnect: () => false,
+    });
+
+    expect(mocks.deliverOutboundPayloads).toHaveBeenCalledWith(
+      expect.objectContaining({
+        mirror: expect.objectContaining({
+          sessionKey: "agent:main:main",
+        }),
+      }),
+    );
+  });
+
+  it("mirrors media filenames when delivery succeeds", async () => {
+    mocks.deliverOutboundPayloads.mockResolvedValue([{ messageId: "m1", channel: "slack" }]);
+
+    const respond = vi.fn();
+    await sendHandlers.send({
+      params: {
+        to: "channel:C1",
+        message: "caption",
+        mediaUrl: "https://example.com/files/report.pdf?sig=1",
+        channel: "slack",
+        idempotencyKey: "idem-2",
+        sessionKey: "agent:main:main",
+      },
+      respond,
+      context: makeContext(),
+      req: { type: "req", id: "1", method: "send" },
+      client: null,
+      isWebchatConnect: () => false,
+    });
+
+    expect(mocks.deliverOutboundPayloads).toHaveBeenCalledWith(
+      expect.objectContaining({
+        mirror: expect.objectContaining({
+          sessionKey: "agent:main:main",
+          text: "caption",
+          mediaUrls: ["https://example.com/files/report.pdf?sig=1"],
+        }),
+      }),
+    );
+  });
+});

src/gateway/server-methods/send.ts

@@ -3,6 +3,7 @@ import type { ChannelId } from "../../channels/plugins/types.js";
 import { DEFAULT_CHAT_CHANNEL } from "../../channels/registry.js";
 import { loadConfig } from "../../config/config.js";
 import { deliverOutboundPayloads } from "../../infra/outbound/deliver.js";
+import { resolveSessionAgentId } from "../../agents/agent-scope.js";
 import type { OutboundChannel } from "../../infra/outbound/targets.js";
 import { resolveOutboundTarget } from "../../infra/outbound/targets.js";
 import { normalizePollInput } from "../../polls.js";
@@ -37,6 +38,7 @@ export const sendHandlers: GatewayRequestHandlers = {
       gifPlayback?: boolean;
       channel?: string;
       accountId?: string;
+      sessionKey?: string;
       idempotencyKey: string;
     };
     const idem = request.idempotencyKey;
@@ -94,7 +96,20 @@ export const sendHandlers: GatewayRequestHandlers = {
         accountId,
         payloads: [{ text: message, mediaUrl: request.mediaUrl }],
         gifPlayback: request.gifPlayback,
+        mirror:
+          typeof request.sessionKey === "string" && request.sessionKey.trim()
+            ? {
+                sessionKey: request.sessionKey.trim(),
+                agentId: resolveSessionAgentId({
+                  sessionKey: request.sessionKey.trim(),
+                  config: cfg,
+                }),
+                text: message,
+                mediaUrls: request.mediaUrl ? [request.mediaUrl] : undefined,
+              }
+            : undefined,
       });
+
       const result = results.at(-1);
       if (!result) {
         throw new Error("No delivery result");