agent-comms 2.21.10 → 2.21.12

package/.claude-plugin/marketplace.json

@@ -15,7 +15,7 @@
         "url": "https://github.com/ExaDev/agent-comms.git"
       },
       "description": "Cross-harness LLM agent communication mesh — rooms, DMs, and presence",
-      "version": "2.21.10"
+      "version": "2.21.12"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-comms",
   "description": "Cross-harness LLM agent communication mesh — rooms, DMs, and presence",
-  "version": "2.21.10",
+  "version": "2.21.12",
   "author": {
     "name": "ExaDev"
   },

package/README.md

@@ -2,7 +2,7 @@
 
 [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/agent-comms)
 [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/agent-comms)
-[![version](https://img.shields.io/badge/version-2.21.10-blue)](https://github.com/ExaDev/agent-comms/releases/tag/v2.21.10)
+[![version](https://img.shields.io/badge/version-2.21.12-blue)](https://github.com/ExaDev/agent-comms/releases/tag/v2.21.12)
 [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/agent-comms/ci.yml?branch=main)](https://github.com/ExaDev/agent-comms/actions)
 
 Cross-harness communication mesh for LLM agents: rooms, DMs, presence, and visibility over TCP with zero filesystem dependencies.

package/dist/test/agent-registry.test.d.ts

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

package/dist/test/agent-registry.test.d.ts.map

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

package/dist/test/agent-registry.test.js

@@ -0,0 +1,275 @@
+/**
+ * Direct, DI-based unit tests for AgentRegistry -- it was previously exercised only indirectly through MeshStore/room-kick-revocation integration tests, which left many individual branches, string literals, and array literals unobserved. AgentRegistryDeps is a narrow, injectable surface built exactly for this: a fake deps object with vi.fn() collaborators lets every branch be asserted on directly.
+ *
+ * One mutant Stryker raises against setAgentOffline is a true equivalent, not a gap -- documented here rather than chased with a contrived test, matching stale-agent-checker.test.ts's own precedent for the identical pattern: `this.deps.agents.set(id, agent)` right after `agent.status = "offline"` re-sets the same key to the exact same object reference `this.deps.agents.get(id)` already returned, so mutating `.status` on it has already mutated what the Map holds. No test can observe removing that call.
+ */
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { AgentRegistry, } from "../core/agent-registry.js";
+import { CommsError } from "../core/store.js";
+const OWNER_ID = "owner-device";
+const OTHER_ID = "other-device";
+const STARTED_AT = "2026-01-01T00:00:00.000Z";
+/** An arbitrary, distinctive pid used only to prove updateAgent's patch actually lands -- no significance beyond "not the seeded pid". */
+const UPDATED_PID = 999;
+function agent(overrides = {}) {
+    return {
+        id: OWNER_ID,
+        version: 1,
+        name: "agent-name",
+        harness: "pi",
+        cwd: "/tmp",
+        pid: 111,
+        startedAt: STARTED_AT,
+        visibility: "visible",
+        status: "active",
+        tags: [],
+        subscribedRooms: [],
+        ...overrides,
+    };
+}
+function makeHarness(peerId = OWNER_ID) {
+    const bump = vi.fn();
+    const broadcastPatch = vi.fn().mockResolvedValue(undefined);
+    const notifyRoomsOfStatus = vi.fn().mockResolvedValue(undefined);
+    const notifyRoomsOfNameChange = vi.fn().mockResolvedValue(undefined);
+    const broadcastAgentVisible = vi.fn().mockResolvedValue(undefined);
+    const broadcastAgentGone = vi.fn().mockResolvedValue(undefined);
+    const deps = {
+        agents: new Map(),
+        identityCache: new Map(),
+        startedAt: STARTED_AT,
+        getPeerId: () => peerId,
+        deliveryEngine: {
+            bump,
+            broadcastPatch,
+            notifyRoomsOfStatus,
+            notifyRoomsOfNameChange,
+        },
+        federation: { broadcastAgentVisible, broadcastAgentGone },
+    };
+    return {
+        deps,
+        registry: new AgentRegistry(deps),
+        bump,
+        broadcastPatch,
+        notifyRoomsOfStatus,
+        notifyRoomsOfNameChange,
+        broadcastAgentVisible,
+        broadcastAgentGone,
+    };
+}
+describe("AgentRegistry — identity cache", () => {
+    it("readIdentity keys by the exact harness+cwd pair, not a blank or partial key", async () => {
+        const { registry, deps } = makeHarness();
+        deps.identityCache.set("pi--/tmp/a", { id: "agent-a" });
+        deps.identityCache.set("codex--/tmp/a", { id: "agent-b" });
+        await expect(registry.readIdentity("pi", "/tmp/a")).resolves.toEqual({
+            id: "agent-a",
+        });
+        await expect(registry.readIdentity("codex", "/tmp/a")).resolves.toEqual({
+            id: "agent-b",
+        });
+        await expect(registry.readIdentity("pi", "/tmp/other")).resolves.toBeUndefined();
+    });
+    it("writeIdentity stores under the harness+cwd composite key, readable back by readIdentity", async () => {
+        const { registry } = makeHarness();
+        await registry.writeIdentity("pi", "/tmp/a", "written-id");
+        await expect(registry.readIdentity("pi", "/tmp/a")).resolves.toEqual({
+            id: "written-id",
+        });
+    });
+});
+describe("AgentRegistry — registerAgent", () => {
+    it("a brand-new (harness, cwd) pair creates a fresh agent with an empty subscribedRooms array", async () => {
+        const { registry, deps } = makeHarness();
+        const created = await registry.registerAgent({
+            name: "fresh",
+            harness: "pi",
+            cwd: "/tmp/fresh",
+            pid: 1,
+            visibility: "visible",
+            tags: ["x"],
+        });
+        expect(created.subscribedRooms).toEqual([]);
+        expect(deps.agents.get(OWNER_ID)).toEqual(created);
+        await expect(registry.readIdentity("pi", "/tmp/fresh")).resolves.toEqual({
+            id: OWNER_ID,
+        });
+    });
+    it("re-registering an already-known (harness, cwd) pair updates the existing agent by its original id rather than minting a fresh one", async () => {
+        let nextId = 0;
+        const peerIds = ["first-id", "second-id"];
+        const { registry, deps } = makeHarness();
+        deps.getPeerId = () => {
+            const id = peerIds[nextId];
+            nextId += 1;
+            if (id === undefined)
+                throw new Error("getPeerId called more times than expected");
+            return id;
+        };
+        const first = await registry.registerAgent({
+            name: "one",
+            harness: "pi",
+            cwd: "/tmp/same",
+            pid: 1,
+            visibility: "visible",
+            tags: [],
+        });
+        const second = await registry.registerAgent({
+            name: "two",
+            harness: "pi",
+            cwd: "/tmp/same",
+            pid: 2,
+            visibility: "hidden",
+            tags: ["updated"],
+        });
+        expect(second.id).toBe(first.id);
+        expect(nextId).toBe(1);
+        expect(second.name).toBe("two");
+        expect(second.visibility).toBe("hidden");
+        expect(second.pid).toBe(2);
+        expect(second.tags).toEqual(["updated"]);
+    });
+    it("broadcasts presence to federated links only for a visible agent, not hidden or ghost", async () => {
+        const visible = makeHarness();
+        await visible.registry.registerAgent({
+            name: "v",
+            harness: "pi",
+            cwd: "/tmp/v",
+            pid: 1,
+            visibility: "visible",
+            tags: [],
+        });
+        expect(visible.broadcastAgentVisible).toHaveBeenCalledTimes(1);
+        const hidden = makeHarness();
+        await hidden.registry.registerAgent({
+            name: "h",
+            harness: "pi",
+            cwd: "/tmp/h",
+            pid: 1,
+            visibility: "hidden",
+            tags: [],
+        });
+        expect(hidden.broadcastAgentVisible).not.toHaveBeenCalled();
+        const ghost = makeHarness();
+        await ghost.registry.registerAgent({
+            name: "g",
+            harness: "pi",
+            cwd: "/tmp/g",
+            pid: 1,
+            visibility: "ghost",
+            tags: [],
+        });
+        expect(ghost.broadcastAgentVisible).not.toHaveBeenCalled();
+    });
+});
+describe("AgentRegistry — getAgent", () => {
+    it("returns the stored agent for a known id, undefined for an unknown one", async () => {
+        const { registry, deps } = makeHarness();
+        const a = agent();
+        deps.agents.set(a.id, a);
+        await expect(registry.getAgent(a.id)).resolves.toEqual(a);
+        await expect(registry.getAgent("nobody")).resolves.toBeUndefined();
+    });
+});
+describe("AgentRegistry — updateAgent", () => {
+    let h;
+    beforeEach(() => {
+        h = makeHarness();
+        h.deps.agents.set(OWNER_ID, agent({ name: "old-name", status: "active" }));
+    });
+    it("throws a CommsError naming the exact missing agent id when the target doesn't exist", async () => {
+        await expect(h.registry.updateAgent("missing-id", {})).rejects.toMatchObject(new CommsError("Agent missing-id not found", "AGENT_NOT_FOUND"));
+    });
+    it("bumps and persists the merged patch into the agents map", async () => {
+        const updated = await h.registry.updateAgent(OWNER_ID, {
+            pid: UPDATED_PID,
+        });
+        expect(h.bump).toHaveBeenCalledWith(updated);
+        expect(h.deps.agents.get(OWNER_ID)).toEqual(updated);
+        expect(updated.pid).toBe(UPDATED_PID);
+    });
+    it("notifies rooms of a name change only when the patch actually changes the name", async () => {
+        await h.registry.updateAgent(OWNER_ID, { name: "new-name" });
+        expect(h.notifyRoomsOfNameChange).toHaveBeenCalledWith(OWNER_ID, "old-name", "new-name");
+    });
+    it("does not notify of a name change when the patch omits name", async () => {
+        await h.registry.updateAgent(OWNER_ID, { pid: 1 });
+        expect(h.notifyRoomsOfNameChange).not.toHaveBeenCalled();
+    });
+    it("does not notify of a name change when the patch repeats the current name", async () => {
+        await h.registry.updateAgent(OWNER_ID, { name: "old-name" });
+        expect(h.notifyRoomsOfNameChange).not.toHaveBeenCalled();
+    });
+    it("notifies rooms of a status change only when the patch actually changes the status", async () => {
+        await h.registry.updateAgent(OWNER_ID, { status: "offline" });
+        expect(h.notifyRoomsOfStatus).toHaveBeenCalledWith(OWNER_ID, "offline");
+    });
+    it("does not notify of a status change when the patch omits status", async () => {
+        await h.registry.updateAgent(OWNER_ID, { pid: 1 });
+        expect(h.notifyRoomsOfStatus).not.toHaveBeenCalled();
+    });
+    it("does not notify of a status change when the patch repeats the current status", async () => {
+        await h.registry.updateAgent(OWNER_ID, { status: "active" });
+        expect(h.notifyRoomsOfStatus).not.toHaveBeenCalled();
+    });
+});
+describe("AgentRegistry — listAgents", () => {
+    it("excludes a ghost agent from a different requester's view", async () => {
+        const { registry, deps } = makeHarness();
+        deps.agents.set("ghost-agent", agent({ id: "ghost-agent", visibility: "ghost" }));
+        deps.agents.set("visible-agent", agent({ id: "visible-agent", visibility: "visible" }));
+        const result = await registry.listAgents("some-requester");
+        expect(result.map((a) => a.id)).toEqual(["visible-agent"]);
+    });
+    it("includes a ghost agent in its own view of itself", async () => {
+        const { registry, deps } = makeHarness();
+        deps.agents.set("ghost-agent", agent({ id: "ghost-agent", visibility: "ghost" }));
+        const result = await registry.listAgents("ghost-agent");
+        expect(result.map((a) => a.id)).toEqual(["ghost-agent"]);
+    });
+    it("always includes a non-ghost agent regardless of who's asking", async () => {
+        const { registry, deps } = makeHarness();
+        deps.agents.set("visible-agent", agent({ id: "visible-agent", visibility: "visible" }));
+        const result = await registry.listAgents("anyone-else");
+        expect(result.map((a) => a.id)).toEqual(["visible-agent"]);
+    });
+});
+describe("AgentRegistry — setAgentOffline", () => {
+    it("is a no-op for an unknown agent id", async () => {
+        const h = makeHarness();
+        await h.registry.setAgentOffline("unknown");
+        expect(h.bump).not.toHaveBeenCalled();
+    });
+    it("is a no-op for an agent already offline", async () => {
+        const h = makeHarness();
+        h.deps.agents.set(OWNER_ID, agent({ status: "offline" }));
+        await h.registry.setAgentOffline(OWNER_ID);
+        expect(h.bump).not.toHaveBeenCalled();
+        expect(h.notifyRoomsOfStatus).not.toHaveBeenCalled();
+    });
+    it("for the owning peer's own agent, sets status offline, bumps, persists, and broadcasts to rooms/mesh/federation", async () => {
+        const h = makeHarness(OWNER_ID);
+        h.deps.agents.set(OWNER_ID, agent({ status: "active" }));
+        await h.registry.setAgentOffline(OWNER_ID);
+        expect(h.deps.agents.get(OWNER_ID)?.status).toBe("offline");
+        expect(h.bump).toHaveBeenCalledTimes(1);
+        expect(h.notifyRoomsOfStatus).toHaveBeenCalledWith(OWNER_ID, "offline");
+        expect(h.broadcastPatch).toHaveBeenCalledWith({
+            type: "agent_offline",
+            agentId: OWNER_ID,
+        });
+        expect(h.broadcastAgentGone).toHaveBeenCalledWith(OWNER_ID);
+    });
+    it("for a non-owning peer's agent, updates local state but does not broadcast anything", async () => {
+        const h = makeHarness(OWNER_ID);
+        h.deps.agents.set(OTHER_ID, agent({ id: OTHER_ID, status: "active" }));
+        await h.registry.setAgentOffline(OTHER_ID);
+        expect(h.deps.agents.get(OTHER_ID)?.status).toBe("offline");
+        expect(h.bump).toHaveBeenCalledTimes(1);
+        expect(h.notifyRoomsOfStatus).not.toHaveBeenCalled();
+        expect(h.broadcastPatch).not.toHaveBeenCalled();
+        expect(h.broadcastAgentGone).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=agent-registry.test.js.map

package/dist/test/agent-registry.test.js.map

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

package/dist/test/connection-approval.test.d.ts

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

package/dist/test/connection-approval.test.d.ts.map

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

package/dist/test/connection-approval.test.js

@@ -0,0 +1,180 @@
+/**
+ * Direct, DI-based unit tests for ConnectionApproval -- it was previously exercised only indirectly through approval.integration.test.ts's end-to-end transport scenarios, which left several individual branches, error messages, and fallback string literals unobserved. ConnectionApprovalDeps is a narrow, injectable surface built exactly for this: a fake deps object with vi.fn() collaborators lets every branch be asserted on directly.
+ */
+import { describe, expect, it, vi } from "vitest";
+import { ConnectionApproval, } from "../core/connection-approval.js";
+const OWNER_ID = "owner-device";
+const STARTED_AT = "2026-01-01T00:00:00.000Z";
+const REMOTE_HOST = "example.test";
+const REMOTE_PORT = 4242;
+const LOCAL_DATA_PORT = 5150;
+function agent(overrides = {}) {
+    return {
+        id: OWNER_ID,
+        version: 1,
+        name: "agent-name",
+        harness: "pi",
+        cwd: "/tmp",
+        pid: 111,
+        startedAt: STARTED_AT,
+        visibility: "visible",
+        status: "active",
+        tags: [],
+        subscribedRooms: [],
+        ...overrides,
+    };
+}
+function makeHarness(options = {}) {
+    const transport = {
+        acceptConnection: vi.fn().mockResolvedValue(undefined),
+        rejectConnection: vi.fn().mockResolvedValue(undefined),
+        connectToRemote: vi.fn().mockResolvedValue(undefined),
+        startDataServer: vi.fn().mockResolvedValue(undefined),
+        unref: vi.fn(),
+        dataPort: LOCAL_DATA_PORT,
+    };
+    const queueDelivery = vi.fn();
+    const onDelivery = options.withOnDelivery === true ? vi.fn() : undefined;
+    const deps = {
+        agents: new Map(),
+        peerInfo: new Map(),
+        startedAt: STARTED_AT,
+        getPeerId: () => OWNER_ID,
+        requireTransport: () => transport,
+        getOnDelivery: () => onDelivery,
+        queueDelivery,
+    };
+    return {
+        deps,
+        approval: new ConnectionApproval(deps),
+        transport,
+        queueDelivery,
+        onDelivery,
+    };
+}
+describe("ConnectionApproval — handleConnectionRequest", () => {
+    it("queues a connection_request delivery event addressed to the owning peer", () => {
+        const h = makeHarness();
+        h.approval.handleConnectionRequest({ id: "conn-1" }, {
+            peerId: "remote-peer",
+            dataPort: 9000,
+            name: "remote-name",
+            fingerprint: "fp",
+        });
+        expect(h.queueDelivery).toHaveBeenCalledWith(OWNER_ID, {
+            type: "connection_request",
+            connectionId: "conn-1",
+            peerId: "remote-peer",
+            dataPort: 9000,
+            name: "remote-name",
+            fingerprint: "fp",
+        });
+    });
+    it("pushes the delivery live via onDelivery when a callback is registered", () => {
+        const h = makeHarness({ withOnDelivery: true });
+        h.approval.handleConnectionRequest({ id: "conn-1" }, {
+            peerId: "remote-peer",
+            dataPort: 9000,
+            name: "remote-name",
+            fingerprint: "fp",
+        });
+        expect(h.onDelivery).toHaveBeenCalledTimes(1);
+    });
+});
+describe("ConnectionApproval — acceptConnection", () => {
+    it("accepts a genuinely pending connection via the transport", async () => {
+        const h = makeHarness();
+        h.approval.handleConnectionRequest({ id: "conn-1" }, {
+            peerId: "remote-peer",
+            dataPort: 9000,
+            name: "remote-name",
+            fingerprint: "fp",
+        });
+        await h.approval.acceptConnection("conn-1");
+        expect(h.transport.acceptConnection).toHaveBeenCalledWith({ id: "conn-1" });
+    });
+    it("throws an error naming the exact unknown connection id, and never touches the transport", async () => {
+        const h = makeHarness();
+        await expect(h.approval.acceptConnection("no-such-conn")).rejects.toThrow("No pending connection no-such-conn");
+        expect(h.transport.acceptConnection).not.toHaveBeenCalled();
+    });
+});
+describe("ConnectionApproval — rejectConnection", () => {
+    it("rejects a genuinely pending connection via the transport with the given reason", async () => {
+        const h = makeHarness();
+        h.approval.handleConnectionRequest({ id: "conn-1" }, {
+            peerId: "remote-peer",
+            dataPort: 9000,
+            name: "remote-name",
+            fingerprint: "fp",
+        });
+        await h.approval.rejectConnection("conn-1", "not now");
+        expect(h.transport.rejectConnection).toHaveBeenCalledWith({ id: "conn-1" }, "not now");
+    });
+    it("throws an error naming the exact unknown connection id, and never touches the transport", async () => {
+        const h = makeHarness();
+        await expect(h.approval.rejectConnection("no-such-conn", "reason")).rejects.toThrow("No pending connection no-such-conn");
+        expect(h.transport.rejectConnection).not.toHaveBeenCalled();
+    });
+});
+describe("ConnectionApproval — connectToRemote", () => {
+    it("dials out with the local agent's real name and an empty fingerprint when the agent is known", async () => {
+        const h = makeHarness();
+        h.deps.agents.set(OWNER_ID, agent({ name: "real-name" }));
+        await h.approval.connectToRemote(REMOTE_HOST, REMOTE_PORT);
+        expect(h.transport.connectToRemote).toHaveBeenCalledWith(REMOTE_HOST, REMOTE_PORT, OWNER_ID, LOCAL_DATA_PORT, "real-name", "");
+    });
+    it("falls back to an empty name (not a placeholder) when the local agent isn't registered yet", async () => {
+        const h = makeHarness();
+        await h.approval.connectToRemote(REMOTE_HOST, REMOTE_PORT);
+        expect(h.transport.connectToRemote).toHaveBeenCalledWith(REMOTE_HOST, REMOTE_PORT, OWNER_ID, LOCAL_DATA_PORT, "", "");
+    });
+    it("does not reject the returned promise when the transport's own connect attempt is rejected", async () => {
+        const h = makeHarness();
+        h.transport.connectToRemote.mockRejectedValue(new Error("coordinator refused"));
+        await expect(h.approval.connectToRemote(REMOTE_HOST, REMOTE_PORT)).resolves.toBeUndefined();
+    });
+});
+describe("ConnectionApproval — startDataServerOnly", () => {
+    it("starts the data server, records this peer's own PeerInfo, and unrefs the transport", async () => {
+        const h = makeHarness();
+        await h.approval.startDataServerOnly();
+        expect(h.transport.startDataServer).toHaveBeenCalledTimes(1);
+        expect(h.deps.peerInfo.get(OWNER_ID)).toEqual({
+            id: OWNER_ID,
+            port: LOCAL_DATA_PORT,
+            startedAt: STARTED_AT,
+        });
+        expect(h.transport.unref).toHaveBeenCalledTimes(1);
+    });
+});
+describe("ConnectionApproval — listPendingConnections", () => {
+    it("lists every still-pending inbound connection with its full request detail", () => {
+        const h = makeHarness();
+        h.approval.handleConnectionRequest({ id: "conn-1" }, { peerId: "peer-a", dataPort: 1, name: "a", fingerprint: "fp-a" });
+        h.approval.handleConnectionRequest({ id: "conn-2" }, { peerId: "peer-b", dataPort: 2, name: "b", fingerprint: "fp-b" });
+        expect(h.approval.listPendingConnections()).toEqual([
+            {
+                connectionId: "conn-1",
+                peerId: "peer-a",
+                dataPort: 1,
+                name: "a",
+                fingerprint: "fp-a",
+            },
+            {
+                connectionId: "conn-2",
+                peerId: "peer-b",
+                dataPort: 2,
+                name: "b",
+                fingerprint: "fp-b",
+            },
+        ]);
+    });
+    it("no longer lists a connection once it's been accepted or rejected", async () => {
+        const h = makeHarness();
+        h.approval.handleConnectionRequest({ id: "conn-1" }, { peerId: "peer-a", dataPort: 1, name: "a", fingerprint: "fp-a" });
+        await h.approval.acceptConnection("conn-1");
+        expect(h.approval.listPendingConnections()).toEqual([]);
+    });
+});
+//# sourceMappingURL=connection-approval.test.js.map

package/dist/test/connection-approval.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comms",
-  "version": "2.21.10",
+  "version": "2.21.12",
   "description": "Cross-harness communication mesh for LLM agents — rooms, DMs, presence, and real-time push delivery over TCP",
   "type": "module",
   "packageManager": "pnpm@12.4.1+sha512.2e81e399d73fe8390dab25e06aa788ab7a5908248d2f5a370f82b481147a6a7a367bf8048f9a6fdb6460f21a66f0542dedb8b94ca2c8723596741920b1656d4c",