agent-comms 4.1.2 → 4.1.4

package/dist/test/error-reporting.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporting.unit.test.js","sourceRoot":"","sources":["../../src/test/error-reporting.unit.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,uBAAuB,EACvB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAEpC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAC1D,kCAAkC,CACnC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAA0B,CAAC;QAC9C,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAE9C,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAErC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YAC/B,CAAC,kCAAkC,CAAC;YACpC,CAAC,gCAAgC,CAAC;SACnC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,MAAM,GAAG,EAAE;aACd,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;aAC9B,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,uBAAuB,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;QAC7D,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/identity-store-wait.unit.test.d.ts

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

package/dist/test/identity-store-wait.unit.test.d.ts.map

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

package/dist/test/identity-store-wait.unit.test.js

@@ -0,0 +1,75 @@
+/**
+ * Unit test for the interleaving readStoredIdentityWaitingForConcurrentCreate must survive: the slot's identity file is read (absent), then the file is created and its creator exits, and only then is the lock file read (holder no longer alive). Concluding "no identity" from the lock alone would miss the file that appeared in between, so the file has to be checked once more.
+ *
+ * node:fs is wrapped so a hook can create the identity file at the exact moment the lock file is read, which is the only way to land that interleaving deterministically.
+ */
+import { spawnSync } from "node:child_process";
+import * as fs from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { loadOrCreateIdentity, loadRoomTokens, saveRoomToken, } from "../core/identity-store.js";
+const hooks = vi.hoisted(() => ({
+    onRead: undefined,
+}));
+vi.mock("node:fs", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        default: actual,
+        readFileSync: (filePath, options) => {
+            hooks.onRead?.(String(filePath));
+            return actual.readFileSync(filePath, options);
+        },
+    };
+});
+// A structurally valid stand-in: saveRoomToken only serialises a CapabilityToken's byte-string fields.
+const FAKE_TOKEN = [
+    Uint8Array.from([1]),
+    {},
+    null,
+    Uint8Array.from([2]),
+];
+/** The pid of a process that has already exited, so the lock it "holds" is stale. */
+function deadPid() {
+    const child = spawnSync(process.execPath, ["-e", ""]);
+    if (child.pid === undefined)
+        throw new Error("child had no pid");
+    return child.pid;
+}
+describe("saveRoomToken racing a concurrent identity creation", () => {
+    const dirs = [];
+    afterEach(() => {
+        hooks.onRead = undefined;
+        for (const dir of dirs.splice(0)) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    });
+    function scratchDir() {
+        const dir = fs.mkdtempSync(path.join(tmpdir(), "identity-wait-"));
+        dirs.push(dir);
+        return dir;
+    }
+    it("finds an identity file that appeared, with its creator already gone, between the file read and the lock read", () => {
+        // Real identity text to "appear": made in a separate slot so nothing shares state with the slot under test.
+        const sourceSlot = {
+            harness: "wait",
+            cwd: "/tmp/source",
+            dir: scratchDir(),
+        };
+        loadOrCreateIdentity(sourceSlot);
+        const identityText = fs.readFileSync(path.join(sourceSlot.dir, fs.readdirSync(sourceSlot.dir).find((f) => f.endsWith(".json")) ?? ""), "utf-8");
+        const slot = { harness: "wait", cwd: "/tmp/target", dir: scratchDir() };
+        const targetBase = path.join(slot.dir, "identity-wait--_tmp_target");
+        fs.writeFileSync(`${targetBase}.lock`, `${String(deadPid())}\n`);
+        hooks.onRead = (filePath) => {
+            if (!filePath.endsWith(".lock"))
+                return;
+            hooks.onRead = undefined;
+            fs.writeFileSync(`${targetBase}.json`, identityText);
+        };
+        saveRoomToken(slot, "race-room", FAKE_TOKEN);
+        expect(Object.keys(loadRoomTokens(slot))).toEqual(["race-room"]);
+    });
+});
+//# sourceMappingURL=identity-store-wait.unit.test.js.map

package/dist/test/identity-store-wait.unit.test.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-comms",
   "description": "Cross-harness communication mesh for LLM agents — rooms, DMs, presence, and real-time push delivery over TCP",
-  "version": "4.1.2",
+  "version": "4.1.4",
   "bin": {
     "agent-comms": "dist/cli.js"
   },