@agentplat/mesh-conformance 0.3.0-beta.1

package/dist/transport.js

@@ -0,0 +1,103 @@
+import { assertCondition, awaitConformanceOperation, bytesEqual, runConformanceCleanup, runBoundedCase, runnerContext, } from "./runner.js";
+export async function runMeshTransportConformance(options) {
+    const context = runnerContext(options);
+    const bytes = options.signedEnvelopeBytes?.slice();
+    if (!(bytes instanceof Uint8Array) ||
+        bytes.byteLength < 1 ||
+        bytes.byteLength > 262_144) {
+        throw new RangeError("Mesh transport conformance bytes are invalid");
+    }
+    return Object.freeze([
+        await runBoundedCase({
+            caseId: "transport.retry.exact_bytes",
+            capability: "transport.exact_byte_retry",
+            context,
+            run: (signal) => withAdapter(options.factory, context, signal, "retry", async (adapter) => {
+                const first = await adapter.deliver(bytes.slice());
+                const second = await adapter.deliver(bytes.slice());
+                assertReceipt(first);
+                assertReceipt(second);
+                assertCondition(first.disposition === "retryable");
+                assertCondition(second.disposition === "accepted");
+                const observed = adapter.observations();
+                assertObservations(observed);
+                assertCondition(observed.attempts.length === 2);
+                assertCondition(bytesEqual(observed.attempts[0], bytes));
+                assertCondition(bytesEqual(observed.attempts[1], bytes));
+                assertCondition(bytesEqual(observed.attempts[0], observed.attempts[1]));
+            }),
+        }),
+        await runBoundedCase({
+            caseId: "transport.redirect.refused",
+            capability: "transport.exact_byte_retry",
+            context,
+            run: (signal) => withAdapter(options.factory, context, signal, "redirect", async (adapter) => {
+                const receipt = await adapter.deliver(bytes.slice());
+                assertReceipt(receipt);
+                const observed = adapter.observations();
+                assertObservations(observed);
+                assertCondition(observed.redirectFollowed === false);
+                assertCondition(observed.attempts.length === 1);
+                assertCondition(receipt.disposition !== "accepted");
+            }),
+        }),
+        await runBoundedCase({
+            caseId: "transport.receipt.coarse",
+            capability: "transport.coarse_receipts",
+            context,
+            run: (signal) => withAdapter(options.factory, context, signal, "receipt", async (adapter) => {
+                const receipt = await adapter.deliver(bytes.slice());
+                assertReceipt(receipt);
+            }),
+        }),
+    ]);
+}
+function assertReceipt(receipt) {
+    if (!receipt || typeof receipt !== "object") {
+        throw new TypeError("Mesh conformance receipt is invalid");
+    }
+    const keys = Object.keys(receipt).sort();
+    const allowed = new Set(["disposition", "messageId", "retryAfterMs"]);
+    assertCondition(keys.every((key) => allowed.has(key)));
+    assertCondition(receipt.disposition === "accepted" ||
+        receipt.disposition === "permanent_rejection" ||
+        receipt.disposition === "retryable");
+    assertCondition(receipt.messageId === undefined ||
+        /^[A-Za-z0-9_-]{21}[AQgw]$/u.test(receipt.messageId));
+    assertCondition(receipt.retryAfterMs === undefined ||
+        (receipt.disposition === "retryable" &&
+            Number.isSafeInteger(receipt.retryAfterMs) &&
+            receipt.retryAfterMs >= 1 &&
+            receipt.retryAfterMs <= 3_600_000));
+    assertCondition(new TextEncoder().encode(JSON.stringify(receipt)).byteLength <= 2_048);
+    assertCondition(!/(?:capabilit|credential|database|high.?water|key|peer.?card|secret|supported.?version)/iu.test(JSON.stringify(receipt)));
+}
+function assertObservations(observed) {
+    if (!observed ||
+        typeof observed !== "object" ||
+        Array.isArray(observed) ||
+        Object.keys(observed).sort().join(",") !== "attempts,redirectFollowed" ||
+        !Array.isArray(observed.attempts) ||
+        observed.attempts.length > 8 ||
+        observed.attempts.some((attempt) => !(attempt instanceof Uint8Array) || attempt.byteLength > 262_144) ||
+        typeof observed.redirectFollowed !== "boolean") {
+        throw new TypeError("Mesh transport conformance observations are invalid");
+    }
+}
+async function withAdapter(factory, context, signal, scenario, run) {
+    const adapter = await awaitConformanceOperation(factory(scenario, Object.freeze({ seed: context.seed, signal })), signal);
+    if (!adapter || typeof adapter !== "object") {
+        throw new TypeError("Mesh transport conformance factory is invalid");
+    }
+    let failed;
+    try {
+        await awaitConformanceOperation(run(adapter), signal);
+    }
+    catch (error) {
+        failed = error;
+    }
+    await runConformanceCleanup(adapter.cleanup?.bind(adapter), context.cleanupTimeoutMs, failed);
+    if (failed !== undefined)
+        throw failed;
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@agentplat/mesh-conformance",
+  "version": "0.3.0-beta.1",
+  "description": "Provider-neutral compatibility runners for Agentplat Mesh adapters.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
+    },
+    "./transport": {
+      "types": "./dist/transport.d.ts",
+      "import": "./dist/transport.js"
+    },
+    "./durability": {
+      "types": "./dist/durability.d.ts",
+      "import": "./dist/durability.js"
+    },
+    "./rooms": {
+      "types": "./dist/rooms.d.ts",
+      "import": "./dist/rooms.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@agentplat/mesh": "^0.3.0-beta.1",
+    "@agentplat/rooms-mesh": "^0.3.0-beta.1",
+    "@agentplat/mesh-protocol": "^0.3.0-beta.1"
+  },
+  "engines": {
+    "node": ">=20.19.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Agentplat/agentplat.git",
+    "directory": "packages/mesh-conformance"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}