agent-comms 9.0.10 → 9.0.12

package/dist/test/room-messaging-durable-send.unit.test.js

@@ -1,122 +0,0 @@
-/**
- * sendRoomMessage's opt-in durable flag (P5's mint-and-append half, agent-comms#50, wired via recordRoomSendNotice from #135): a caller that passes durable: true also gets the message recorded as a room-notice in the sender's own oplog, verifiable end to end via a real verifyRoomNotice, not just an opaque append. Real identities and a real minted token throughout, matching room-lifecycle.test.ts's own established convention for this class of test -- recordRoomSendNotice genuinely mints and signs, so an opaque placeholder token would fail the mint outright.
- */
-import { describe, expect, it } from "vitest";
-import { decode as cborDecode, cdeDecodeOptions } from "cbor2";
-import { deviceIdToHex } from "wire-mesh-core/domain/device-id";
-import { mintCapabilityToken } from "wire-mesh-core/domain/tokens";
-import { createSystemClock } from "wire-mesh-core/adapters/system-clock";
-import { createMemoryStorage } from "wire-mesh-core/adapters/memory-storage";
-import { ownerNamedRoomPath } from "wire-mesh-core/domain/room-path";
-import { verifyRoomNotice } from "wire-mesh-core/domain/room";
-import { createRevocationView } from "wire-mesh-core/domain/revocation-view";
-import { readEntries } from "wire-mesh-core/domain/data-sync";
-import { generateIdentity } from "../core/identity.js";
-import { toIdentityPort } from "../core/wire-mesh-identity.js";
-import { loadOrCreateIdentity, saveRoomToken } from "../core/identity-store.js";
-import { randomId } from "../core/random-id.js";
-import { RoomMessaging, } from "../core/room-messaging.js";
-import { scratchDirectory } from "./scratch-directory.helper.js";
-const NO_DELEGATIONS_REMAINING = 0;
-const MINUTES_PER_HOUR = 60;
-const SECONDS_PER_MINUTE = 60;
-const MS_PER_SECOND = 1000;
-const ONE_HOUR_MS = MINUTES_PER_HOUR * SECONDS_PER_MINUTE * MS_PER_SECOND;
-async function makeHarness() {
-    const ownerIdentity = await toIdentityPort(generateIdentity());
-    const roomPath = ownerNamedRoomPath(deviceIdToHex(ownerIdentity.deviceId), "general");
-    const clock = createSystemClock();
-    const verdict = await mintCapabilityToken({
-        identity: ownerIdentity,
-        clock,
-        tokenId: randomId(),
-        bearer: ownerIdentity.deviceId,
-        capability: "room:member",
-        scope: { kind: "room", path: roomPath },
-        expires: Date.now() + ONE_HOUR_MS,
-        delegationsRemaining: NO_DELEGATIONS_REMAINING,
-    });
-    if (!verdict.ok)
-        throw new Error(`mint failed: ${verdict.reason}`);
-    // saveRoomToken writes into this slot's own persisted identity file, which must already exist on disk -- unrelated to which crypto identity requireIdentity() uses for minting/verifying (room-lifecycle.test.ts's own established convention for this exact precondition).
-    const slotDir = scratchDirectory("room-messaging-durable-send-test-");
-    const slot = { harness: "test", cwd: "room-messaging", dir: slotDir };
-    loadOrCreateIdentity(slot);
-    saveRoomToken(slot, roomPath, verdict.token);
-    const dataStorage = createMemoryStorage();
-    const room = {
-        id: roomPath,
-        version: 1,
-        name: "general",
-        type: "public",
-        owner: deviceIdToHex(ownerIdentity.deviceId),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        description: "",
-        members: [deviceIdToHex(ownerIdentity.deviceId)],
-        invited: [],
-        memberJoins: {},
-        memberLeaves: {},
-        invitedJoins: {},
-        invitedLeaves: {},
-    };
-    const deps = {
-        rooms: new Map([[roomPath, room]]),
-        messages: new Map(),
-        dms: new Map(),
-        requireIdentity: () => ({
-            slot,
-            clock,
-            identity: ownerIdentity,
-            revocation: createRevocationView(),
-            dataStorage,
-            userIdentity: ownerIdentity,
-            accountLedger: {},
-            userIdentityOptions: {},
-            machineIdentity: ownerIdentity,
-            machineIdentityOptions: {},
-        }),
-        roomProtocol: {
-            sendRoomRequestToMember: async () => ({ kind: "delivered" }),
-        },
-        // This harness only sends room messages, never DMs, so DM admission is never reached.
-        requestDmAccess: async () => undefined,
-        resolveAgent: async () => undefined,
-        // Every send here already names the room by its real path.
-        resolveRoomId: (roomIdOrName) => roomIdOrName,
-    };
-    return {
-        messaging: new RoomMessaging(deps),
-        ownerIdentity,
-        roomPath,
-        dataStorage,
-    };
-}
-describe("RoomMessaging — sendRoomMessage durable flag", () => {
-    it("records nothing in the oplog when durable is omitted", async () => {
-        const h = await makeHarness();
-        const ownerDeviceHex = deviceIdToHex(h.ownerIdentity.deviceId);
-        await h.messaging.sendRoomMessage(h.roomPath, ownerDeviceHex, "hello");
-        expect(await readEntries(h.dataStorage, h.ownerIdentity.deviceId, 0)).toEqual([]);
-    });
-    it("appends a verifiable room-notice to the sender's own oplog when durable is true", async () => {
-        const h = await makeHarness();
-        const ownerDeviceHex = deviceIdToHex(h.ownerIdentity.deviceId);
-        await h.messaging.sendRoomMessage(h.roomPath, ownerDeviceHex, "hello, durably", { durable: true });
-        const [entry] = await readEntries(h.dataStorage, h.ownerIdentity.deviceId, 0);
-        expect(entry).toBeDefined();
-        if (entry === undefined)
-            return;
-        const decoded = cborDecode(entry, cdeDecodeOptions);
-        const verdict = await verifyRoomNotice(decoded, {
-            identity: h.ownerIdentity,
-            clock: createSystemClock(),
-            revocation: createRevocationView(),
-        });
-        expect(verdict.ok, `expected the durably-recorded notice to verify, got ${JSON.stringify(verdict)}`).toBeTruthy();
-        if (!verdict.ok)
-            return;
-        expect(verdict.claims.room).toBe(h.roomPath);
-        expect(new TextDecoder().decode(verdict.claims.content)).toBe("hello, durably");
-    });
-});
-//# sourceMappingURL=room-messaging-durable-send.unit.test.js.map

package/dist/test/room-messaging-durable-send.unit.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"room-messaging-durable-send.unit.test.js","sourceRoot":"","sources":["../../src/test/room-messaging-durable-send.unit.test.ts"],"names":[],"mappings":"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"}

package/dist/test/room-messaging.unit.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=room-messaging.unit.test.d.ts.map

package/dist/test/room-messaging.unit.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"room-messaging.unit.test.d.ts","sourceRoot":"","sources":["../../src/test/room-messaging.unit.test.ts"],"names":[],"mappings":""}

package/dist/test/room-messaging.unit.test.js

@@ -1,495 +0,0 @@
-/**
- * Direct, DI-based unit tests for RoomMessaging -- it was previously exercised only indirectly through end-to-end room-send integration tests, leaving many individual branches (optional-field spreads, error message text, since-filtering boundaries, self-DM vs cross-DM key derivation) unobserved. RoomMessagingDeps is a narrow, injectable surface built exactly for this. loadRoomTokens is a free function reading a real identity file, not part of the injectable deps -- mocked here since RoomMessaging only ever forwards its return value opaquely, never inspects or verifies it.
- *
- * Two mutants Stryker raises against readRoomMessages' `since === undefined || since === ""` check are practical equivalents, not gaps -- documented here rather than chased with a contrived test. Both replace the `since === ""` comparison (one with the literal `false`, one with `since === "Stryker was here!"`) and both share the identical root cause: whenever the real code's early-return branch would fire on `since === ""`, the mutant instead falls through to `arr.filter(m => m.timestamp > since)` with `since` still `""` -- and every RoomMessage in this codebase is constructed with `new Date().toISOString()`, never an empty string, so `m.timestamp > ""` is true for every real message regardless of which branch runs. The early-return and the filter produce identical output for any timestamp this codebase can actually produce; only a RoomMessage with an empty-string timestamp (violating that invariant) would distinguish them, and fabricating one would be exactly the kind of contrived test this repo's own convention (see stale-agent-checker.test.ts) says to document instead of force.
- */
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import { dmRoomPath } from "../core/room-path.js";
-import { resolveRoomId } from "../core/room-lookup.js";
-import { loadRoomTokens } from "../core/identity-store.js";
-import { RoomMessaging, } from "../core/room-messaging.js";
-import { CommsError } from "../core/store.js";
-vi.mock("../core/identity-store.js", () => ({
-    loadRoomTokens: vi.fn(),
-}));
-// Opaque placeholder: RoomMessaging never inspects a token's own COSE_Sign1 structure, only forwards whatever loadRoomTokens returns to sendRoomRequestToMember -- so any distinguishable value stands in for a real one in these tests.
-const FAKE_TOKEN = "fake-token";
-/** A device-id is a 64-character lowercase hex SHA-256 digest; room-path.ts's assertDeviceIdHex rejects anything shorter. */
-const DEVICE_ID_HEX_LENGTH = 64;
-/** A message/token id is 16 random bytes, hex-encoded to 32 characters -- randomId()'s own convention, matched here so bytesFromHex doesn't reject the fixture. */
-const MESSAGE_ID_BYTE_LENGTH = 16;
-const FROM_DEVICE_ID = "a".repeat(DEVICE_ID_HEX_LENGTH);
-const TO_DEVICE_ID = "b".repeat(DEVICE_ID_HEX_LENGTH);
-/** A third room member, so a fan-out test can show one member's outcome not affecting another's. */
-const OTHER_DEVICE_ID = "c".repeat(DEVICE_ID_HEX_LENGTH);
-const NOW_MS = 1_700_000_000_000;
-function room(overrides = {}) {
-    return {
-        id: "room-1",
-        version: 1,
-        name: "room-name",
-        type: "public",
-        owner: FROM_DEVICE_ID,
-        createdAt: "2026-01-01T00:00:00.000Z",
-        description: "",
-        members: [FROM_DEVICE_ID],
-        invited: [],
-        memberJoins: {},
-        memberLeaves: {},
-        invitedJoins: {},
-        invitedLeaves: {},
-        ...overrides,
-    };
-}
-function agent(overrides = {}) {
-    return {
-        id: TO_DEVICE_ID,
-        version: 1,
-        name: "recipient",
-        harness: "pi",
-        cwd: "/tmp",
-        pid: 111,
-        startedAt: "2026-01-01T00:00:00.000Z",
-        visibility: "visible",
-        status: "active",
-        tags: [],
-        subscribedRooms: [],
-        ...overrides,
-    };
-}
-function makeHarness() {
-    const sendRoomRequestToMember = vi
-        .fn()
-        .mockResolvedValue({ kind: "delivered" });
-    const requestDmAccess = vi.fn().mockResolvedValue(undefined);
-    // Backs the default resolveAgent mock below -- a plain lookup Map standing in for AgentRegistry.getAgent's own real "known, else gossip-discovered" resolution, which RoomMessaging itself never sees; it only calls resolveAgent opaquely.
-    const agents = new Map();
-    const resolveAgent = vi
-        .fn()
-        .mockImplementation(async (id) => agents.get(id));
-    const rooms = new Map();
-    // Stands in for RoomLifecycle.resolveRoomId, which RoomMessaging only reaches through this dependency: resolves against the harness's own rooms, the same way the real one does for rooms this store holds.
-    const resolveRoomIdMock = vi
-        .fn()
-        .mockImplementation((roomIdOrName) => resolveRoomId(rooms.values(), roomIdOrName));
-    const deps = {
-        rooms,
-        messages: new Map(),
-        dms: new Map(),
-        requireIdentity: () => ({
-            slot: { harness: "pi", cwd: "/tmp" },
-            clock: { now: () => NOW_MS },
-            identity: {},
-            revocation: {},
-            dataStorage: {},
-            userIdentity: {},
-            machineIdentity: {},
-            machineIdentityOptions: {},
-            accountLedger: {},
-            userIdentityOptions: {},
-        }),
-        roomProtocol: { sendRoomRequestToMember },
-        requestDmAccess,
-        resolveAgent,
-        resolveRoomId: resolveRoomIdMock,
-    };
-    return {
-        resolveRoomId: resolveRoomIdMock,
-        agents,
-        resolveAgent,
-        deps,
-        messaging: new RoomMessaging(deps),
-        sendRoomRequestToMember,
-        requestDmAccess,
-    };
-}
-beforeEach(() => {
-    vi.mocked(loadRoomTokens).mockReset();
-    vi.mocked(loadRoomTokens).mockReturnValue({ "room-1": FAKE_TOKEN });
-});
-describe("RoomMessaging — sendRoomMessage", () => {
-    it("throws ROOM_NOT_FOUND naming the exact room id when the room doesn't exist", async () => {
-        const h = makeHarness();
-        await expect(h.messaging.sendRoomMessage("no-such-room", FROM_DEVICE_ID, "hi")).rejects.toMatchObject({
-            message: "Room no-such-room not found",
-            code: "ROOM_NOT_FOUND",
-        });
-    });
-    it("looks the room up by the id its bare name resolves to", async () => {
-        const h = makeHarness();
-        const roomPath = `${TO_DEVICE_ID}/general`;
-        h.deps.rooms.set(roomPath, room({ id: roomPath, name: "general", members: [FROM_DEVICE_ID] }));
-        vi.mocked(loadRoomTokens).mockReturnValue({ [roomPath]: FAKE_TOKEN });
-        const { message } = await h.messaging.sendRoomMessage("general", FROM_DEVICE_ID, "hi");
-        expect(h.resolveRoomId).toHaveBeenCalledWith("general");
-        expect(message.room).toBe(roomPath);
-    });
-    it("propagates the resolver's ambiguity error instead of picking a room", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set(`${FROM_DEVICE_ID}/general`, room({ id: `${FROM_DEVICE_ID}/general`, name: "general" }));
-        h.deps.rooms.set(`${TO_DEVICE_ID}/general`, room({ id: `${TO_DEVICE_ID}/general`, name: "general" }));
-        await expect(h.messaging.sendRoomMessage("general", FROM_DEVICE_ID, "hi")).rejects.toMatchObject({ code: "AMBIGUOUS_ROOM_NAME" });
-    });
-    it("throws NOT_MEMBER naming the exact room id when the sender isn't a member", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room({ members: [] }));
-        await expect(h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi")).rejects.toMatchObject({
-            message: "Not a member of room-1",
-            code: "NOT_MEMBER",
-        });
-    });
-    it("throws NOT_MEMBER naming the exact room id when no room:member token is persisted", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room());
-        vi.mocked(loadRoomTokens).mockReturnValue({});
-        await expect(h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi")).rejects.toMatchObject({
-            message: "No room:member token for room-1",
-            code: "NOT_MEMBER",
-        });
-    });
-    it("stores the message and records it in the room's history", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room());
-        const { message } = await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hello");
-        expect(h.deps.messages.get("room-1")).toEqual([message]);
-        expect(message.content).toBe("hello");
-        expect(message.readBy).toEqual([FROM_DEVICE_ID]);
-    });
-    it("includes replyTo only when explicitly given", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room());
-        const replyToId = "aa".repeat(MESSAGE_ID_BYTE_LENGTH);
-        const { message: withReply } = await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi", { replyTo: replyToId });
-        expect(withReply.replyTo).toBe(replyToId);
-        const { message: withoutReply } = await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi");
-        expect(withoutReply).not.toHaveProperty("replyTo");
-    });
-    it("includes streamingBehavior on the stored message only when given", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room());
-        const { message: withBehavior } = await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi", { streamingBehavior: "steer" });
-        expect(withBehavior.streamingBehavior).toBe("steer");
-        const { message: withoutBehavior } = await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi");
-        expect(withoutBehavior).not.toHaveProperty("streamingBehavior");
-    });
-    it("sends a directed request to every other member, never to the sender itself", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room({ members: [FROM_DEVICE_ID, "member-b", "member-c"] }));
-        await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi");
-        expect(h.sendRoomRequestToMember).toHaveBeenCalledTimes(2);
-        expect(h.sendRoomRequestToMember).toHaveBeenCalledWith("member-b", "room-1", FAKE_TOKEN, expect.anything());
-        expect(h.sendRoomRequestToMember).toHaveBeenCalledWith("member-c", "room-1", FAKE_TOKEN, expect.anything());
-    });
-    it('includes a refs entry with relation "reply" in the wire params only when replyTo is given', async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room({ members: [FROM_DEVICE_ID, "member-b"] }));
-        const replyToId = "aa".repeat(MESSAGE_ID_BYTE_LENGTH);
-        await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi", {
-            replyTo: replyToId,
-        });
-        const params = h.sendRoomRequestToMember.mock.calls[0]?.[3];
-        expect(params.refs).toEqual([
-            { id: expect.any(Uint8Array), relation: "reply" },
-        ]);
-    });
-    it("omits refs from the wire params when no replyTo is given", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room({ members: [FROM_DEVICE_ID, "member-b"] }));
-        await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi");
-        const params = h.sendRoomRequestToMember.mock.calls[0]?.[3];
-        expect(params).not.toHaveProperty("refs");
-    });
-    it("includes streaming-behavior in the wire params only when given", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room({ members: [FROM_DEVICE_ID, "member-b"] }));
-        await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi", {
-            streamingBehavior: "steer",
-        });
-        const params = h.sendRoomRequestToMember.mock.calls[0]?.[3];
-        expect(params["streaming-behavior"]).toBe("steer");
-    });
-    it("omits streaming-behavior from the wire params when not given", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room({ members: [FROM_DEVICE_ID, "member-b"] }));
-        await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi");
-        const params = h.sendRoomRequestToMember.mock.calls[0]?.[3];
-        expect(params).not.toHaveProperty("streaming-behavior");
-    });
-});
-describe("RoomMessaging — readRoomMessages", () => {
-    const OLDER = "2026-01-01T00:00:00.000Z";
-    const MIDDLE = "2026-01-01T00:05:00.000Z";
-    const NEWER = "2026-01-01T00:10:00.000Z";
-    function seeded(h) {
-        h.deps.messages.set("room-1", [
-            {
-                id: "m1",
-                from: "a",
-                room: "room-1",
-                content: "old",
-                timestamp: OLDER,
-                readBy: [],
-            },
-            {
-                id: "m2",
-                from: "a",
-                room: "room-1",
-                content: "mid",
-                timestamp: MIDDLE,
-                readBy: [],
-            },
-            {
-                id: "m3",
-                from: "a",
-                room: "room-1",
-                content: "new",
-                timestamp: NEWER,
-                readBy: [],
-            },
-        ]);
-    }
-    it("returns the full history when since is omitted", async () => {
-        const h = makeHarness();
-        seeded(h);
-        const result = await h.messaging.readRoomMessages("room-1");
-        expect(result.map((m) => m.id)).toEqual(["m1", "m2", "m3"]);
-    });
-    it("returns the full history when since is an empty string", async () => {
-        const h = makeHarness();
-        seeded(h);
-        const result = await h.messaging.readRoomMessages("room-1", "");
-        expect(result.map((m) => m.id)).toEqual(["m1", "m2", "m3"]);
-    });
-    it("returns only messages strictly newer than a real since timestamp", async () => {
-        const h = makeHarness();
-        seeded(h);
-        const result = await h.messaging.readRoomMessages("room-1", MIDDLE);
-        expect(result.map((m) => m.id)).toEqual(["m3"]);
-    });
-    it("returns an empty array for a room with no history", async () => {
-        const h = makeHarness();
-        const result = await h.messaging.readRoomMessages("no-such-room");
-        expect(result).toEqual([]);
-    });
-    it("filters out every message for an arbitrary since lexically greater than any real timestamp", async () => {
-        const h = makeHarness();
-        seeded(h);
-        // Lexically greater than any real ISO timestamp (which starts with a digit) -- proves filtering genuinely runs and genuinely excludes messages for a since value that isn't "" or undefined, distinct from the empty-string shortcut covered (and its equivalent mutants documented) above.
-        const result = await h.messaging.readRoomMessages("room-1", "not-a-real-timestamp");
-        expect(result).toEqual([]);
-    });
-});
-describe("RoomMessaging — sendDm", () => {
-    it("throws AGENT_NOT_FOUND naming the exact recipient id when the recipient doesn't exist", async () => {
-        const h = makeHarness();
-        await expect(h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi")).rejects.toMatchObject({
-            message: `Agent ${TO_DEVICE_ID} not found`,
-            code: "AGENT_NOT_FOUND",
-        });
-    });
-    it("throws AGENT_NOT_FOUND naming the exact recipient id when the recipient has ghost visibility", async () => {
-        const h = makeHarness();
-        h.agents.set(TO_DEVICE_ID, agent({ visibility: "ghost" }));
-        await expect(h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi")).rejects.toMatchObject({
-            message: `Cannot DM agent ${TO_DEVICE_ID}`,
-            code: "AGENT_NOT_FOUND",
-        });
-    });
-    it("resolves the recipient via resolveAgent, not a direct agents-map lookup -- so a remote, gossip-discovered recipient (agent-comms#155) is a valid DM target", async () => {
-        const h = makeHarness();
-        h.resolveAgent.mockResolvedValue(agent({ visibility: "visible" }));
-        vi.mocked(loadRoomTokens).mockReturnValue({
-            [dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID)]: FAKE_TOKEN,
-        });
-        const { message } = await h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi");
-        expect(h.resolveAgent).toHaveBeenCalledWith(TO_DEVICE_ID);
-        expect(message.content).toBe("hi");
-    });
-    it("skips recipient validation entirely for a self-DM", async () => {
-        const h = makeHarness();
-        const { message } = await h.messaging.sendDm(FROM_DEVICE_ID, FROM_DEVICE_ID, "note to self");
-        expect(message.content).toBe("note to self");
-    });
-    it("stores a self-DM under a self:<id> key and never dials out", async () => {
-        const h = makeHarness();
-        const { message } = await h.messaging.sendDm(FROM_DEVICE_ID, FROM_DEVICE_ID, "note to self");
-        expect(h.deps.dms.get(`self:${FROM_DEVICE_ID}`)).toEqual([message]);
-        expect(h.sendRoomRequestToMember).not.toHaveBeenCalled();
-    });
-    it("stores a cross-agent DM under the sorted dmRoomPath key and dials the recipient", async () => {
-        const h = makeHarness();
-        h.agents.set(TO_DEVICE_ID, agent());
-        vi.mocked(loadRoomTokens).mockReturnValue({
-            [dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID)]: FAKE_TOKEN,
-        });
-        const { message } = await h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi");
-        const key = dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID);
-        expect(h.deps.dms.get(key)).toEqual([message]);
-        expect(h.sendRoomRequestToMember).toHaveBeenCalledWith(TO_DEVICE_ID, key, FAKE_TOKEN, expect.anything());
-    });
-    it("sets readBy to exactly the sender on a new DM", async () => {
-        const h = makeHarness();
-        const { message } = await h.messaging.sendDm(FROM_DEVICE_ID, FROM_DEVICE_ID, "hi");
-        expect(message.readBy).toEqual([FROM_DEVICE_ID]);
-    });
-    it("includes streamingBehavior on the stored message only when given", async () => {
-        const h = makeHarness();
-        const { message: withBehavior } = await h.messaging.sendDm(FROM_DEVICE_ID, FROM_DEVICE_ID, "hi", "followUp");
-        expect(withBehavior.streamingBehavior).toBe("followUp");
-        const { message: withoutBehavior } = await h.messaging.sendDm(FROM_DEVICE_ID, FROM_DEVICE_ID, "hi");
-        expect(withoutBehavior).not.toHaveProperty("streamingBehavior");
-    });
-    it("requests DM access from the recipient when no room:member token is persisted, then sends with the token that request granted", async () => {
-        const h = makeHarness();
-        h.agents.set(TO_DEVICE_ID, agent());
-        const key = dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID);
-        vi.mocked(loadRoomTokens)
-            .mockReturnValueOnce({})
-            .mockReturnValue({ [key]: FAKE_TOKEN });
-        const { message } = await h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi");
-        expect(h.requestDmAccess).toHaveBeenCalledExactlyOnceWith(TO_DEVICE_ID);
-        expect(h.sendRoomRequestToMember).toHaveBeenCalledWith(TO_DEVICE_ID, key, FAKE_TOKEN, expect.anything());
-        expect(h.deps.dms.get(key)).toEqual([message]);
-    });
-    it("does not request DM access when a room:member token is already persisted", async () => {
-        const h = makeHarness();
-        h.agents.set(TO_DEVICE_ID, agent());
-        vi.mocked(loadRoomTokens).mockReturnValue({
-            [dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID)]: FAKE_TOKEN,
-        });
-        await h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi");
-        expect(h.requestDmAccess).not.toHaveBeenCalled();
-    });
-    it("never requests DM access for a self-DM", async () => {
-        const h = makeHarness();
-        await h.messaging.sendDm(FROM_DEVICE_ID, FROM_DEVICE_ID, "note");
-        expect(h.requestDmAccess).not.toHaveBeenCalled();
-    });
-    it("surfaces a refused DM access request and records nothing locally or on the wire", async () => {
-        const h = makeHarness();
-        h.agents.set(TO_DEVICE_ID, agent());
-        vi.mocked(loadRoomTokens).mockReturnValue({});
-        h.requestDmAccess.mockRejectedValue(new CommsError("DM access request was refused (denied)", "JOIN_REFUSED"));
-        await expect(h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi")).rejects.toMatchObject({ code: "JOIN_REFUSED" });
-        expect(h.deps.dms.get(dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID))).toBe(undefined);
-        expect(h.sendRoomRequestToMember).not.toHaveBeenCalled();
-    });
-    it("throws NOT_MEMBER naming the exact dm key when access was granted but no token was persisted", async () => {
-        const h = makeHarness();
-        h.agents.set(TO_DEVICE_ID, agent());
-        vi.mocked(loadRoomTokens).mockReturnValue({});
-        const key = dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID);
-        await expect(h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi")).rejects.toMatchObject({
-            message: `No room:member token for ${key}`,
-            code: "NOT_MEMBER",
-        });
-    });
-    it("includes streaming-behavior in the wire params only when given, for a cross-agent DM", async () => {
-        const h = makeHarness();
-        h.agents.set(TO_DEVICE_ID, agent());
-        vi.mocked(loadRoomTokens).mockReturnValue({
-            [dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID)]: FAKE_TOKEN,
-        });
-        await h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi", "info");
-        const params = h.sendRoomRequestToMember.mock.calls[0]?.[3];
-        expect(params["streaming-behavior"]).toBe("info");
-    });
-    it("omits streaming-behavior from the wire params when not given, for a cross-agent DM", async () => {
-        const h = makeHarness();
-        h.agents.set(TO_DEVICE_ID, agent());
-        vi.mocked(loadRoomTokens).mockReturnValue({
-            [dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID)]: FAKE_TOKEN,
-        });
-        await h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi");
-        const params = h.sendRoomRequestToMember.mock.calls[0]?.[3];
-        expect(params).not.toHaveProperty("streaming-behavior");
-    });
-});
-describe("RoomMessaging — reporting what became of a send", () => {
-    /** Makes the DM path's own token already present, so sendDm goes straight to the wire rather than running the consent flow first. */
-    function withDmToken(h) {
-        h.resolveAgent.mockResolvedValue(agent({ visibility: "visible" }));
-        vi.mocked(loadRoomTokens).mockReturnValue({
-            [dmRoomPath(FROM_DEVICE_ID, TO_DEVICE_ID)]: FAKE_TOKEN,
-        });
-    }
-    it("reports a delivered DM as delivered", async () => {
-        const h = makeHarness();
-        withDmToken(h);
-        h.sendRoomRequestToMember.mockResolvedValue({ kind: "delivered" });
-        const sent = await h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi");
-        expect(sent.delivery).toEqual({ status: "delivered" });
-    });
-    it("reports a DM nobody answered as queued, naming why", async () => {
-        const h = makeHarness();
-        withDmToken(h);
-        h.sendRoomRequestToMember.mockResolvedValue({
-            kind: "undelivered",
-            reason: "timeout",
-        });
-        const sent = await h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi");
-        expect(sent.delivery).toEqual({ status: "queued", reason: "timeout" });
-    });
-    it("raises SEND_REFUSED when the recipient refuses a DM, naming its own code", async () => {
-        const h = makeHarness();
-        withDmToken(h);
-        h.sendRoomRequestToMember.mockResolvedValue({
-            kind: "refused",
-            code: "unauthorized",
-        });
-        await expect(h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi")).rejects.toMatchObject({
-            message: `DM to ${TO_DEVICE_ID} refused (unauthorized)`,
-            code: "SEND_REFUSED",
-        });
-    });
-    it("includes the refuser's own message in a refusal, when it sent one", async () => {
-        const h = makeHarness();
-        withDmToken(h);
-        h.sendRoomRequestToMember.mockResolvedValue({
-            kind: "refused",
-            code: "denied",
-            message: "not right now",
-        });
-        await expect(h.messaging.sendDm(FROM_DEVICE_ID, TO_DEVICE_ID, "hi")).rejects.toMatchObject({
-            message: `DM to ${TO_DEVICE_ID} refused (denied: not right now)`,
-        });
-    });
-    it("reports a self-DM as delivered without touching the wire", async () => {
-        const h = makeHarness();
-        const sent = await h.messaging.sendDm(FROM_DEVICE_ID, FROM_DEVICE_ID, "note to self");
-        expect(sent.delivery).toEqual({ status: "delivered" });
-        expect(h.sendRoomRequestToMember).not.toHaveBeenCalled();
-    });
-    it("reports a room send's outcome per member, including a refusal", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room({ members: [FROM_DEVICE_ID, TO_DEVICE_ID, OTHER_DEVICE_ID] }));
-        h.sendRoomRequestToMember
-            .mockResolvedValueOnce({ kind: "undelivered", reason: "not_connected" })
-            .mockResolvedValueOnce({ kind: "refused", code: "unauthorized" });
-        const sent = await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi");
-        expect(sent.deliveries).toEqual([
-            {
-                member: TO_DEVICE_ID,
-                delivery: { status: "queued", reason: "not_connected" },
-            },
-            {
-                member: OTHER_DEVICE_ID,
-                delivery: { status: "refused", code: "unauthorized" },
-            },
-        ]);
-    });
-    it("keeps sending to the rest of a room after one member refuses", async () => {
-        const h = makeHarness();
-        h.deps.rooms.set("room-1", room({ members: [FROM_DEVICE_ID, TO_DEVICE_ID, OTHER_DEVICE_ID] }));
-        h.sendRoomRequestToMember
-            .mockResolvedValueOnce({ kind: "refused", code: "unauthorized" })
-            .mockResolvedValueOnce({ kind: "delivered" });
-        const sent = await h.messaging.sendRoomMessage("room-1", FROM_DEVICE_ID, "hi");
-        expect(h.sendRoomRequestToMember).toHaveBeenCalledTimes(2);
-        expect(sent.deliveries[1]).toEqual({
-            member: OTHER_DEVICE_ID,
-            delivery: { status: "delivered" },
-        });
-    });
-});
-//# sourceMappingURL=room-messaging.unit.test.js.map