@axiom-lattice/pg-stores 3.3.4 → 3.3.5

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/pg-stores@3.3.4 build /home/runner/work/agentic/agentic/packages/pg-stores
+> @axiom-lattice/pg-stores@3.3.5 build /home/runner/work/agentic/agentic/packages/pg-stores
 > tsup src/index.ts --format cjs,esm --dts --sourcemap
 
 CLI Building entry: src/index.ts
@@ -10,11 +10,11 @@
 ESM Build start
 CJS dist/index.js     443.09 KB
 CJS dist/index.js.map 807.74 KB
-CJS ⚡️ Build success in 1017ms
+CJS ⚡️ Build success in 694ms
 ESM dist/index.mjs     434.40 KB
 ESM dist/index.mjs.map 807.39 KB
-ESM ⚡️ Build success in 1084ms
+ESM ⚡️ Build success in 695ms
 DTS Build start
-DTS ⚡️ Build success in 14116ms
+DTS ⚡️ Build success in 10825ms
 DTS dist/index.d.ts  93.36 KB
 DTS dist/index.d.mts 93.36 KB

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @axiom-lattice/pg-stores
 
+## 3.3.5
+
+### Patch Changes
+
+- Updated dependencies [cb75780]
+- Updated dependencies [c0f75e2]
+- Updated dependencies [48e3ce3]
+- Updated dependencies [3e923d0]
+- Updated dependencies [99bf609]
+- Updated dependencies [92bffbb]
+- Updated dependencies [a19e0aa]
+  - @axiom-lattice/core@6.4.1
+
 ## 3.3.4
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiom-lattice/pg-stores",
-  "version": "3.3.4",
+  "version": "3.3.5",
   "description": "PG stores implementation for Axiom Lattice framework",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -25,7 +25,7 @@
     "@langchain/core": "1.1.30",
     "pg": "^8.16.3",
     "uuid": "^9.0.1",
-    "@axiom-lattice/core": "6.4.0",
+    "@axiom-lattice/core": "6.4.1",
     "@axiom-lattice/protocols": "4.8.0"
   },
   "devDependencies": {

package/src/__tests__/PostgreSQLProjectRoomMessageStore.correlatedInterrupt.integration.test.ts

@@ -0,0 +1,74 @@
+import { randomUUID } from "node:crypto";
+import { Pool } from "pg";
+import { PostgreSQLProjectRoomMessageStore } from "../stores/PostgreSQLProjectRoomMessageStore";
+import { MigrationManager } from "../migrations/migration";
+import { createProjectRoomTables } from "../migrations/project_room_migration";
+
+const databaseUrl = process.env.TEST_DATABASE_URL;
+const describeIfDatabase = databaseUrl ? describe : describe.skip;
+
+/**
+ * Real-PostgreSQL contract for the source-less correlated interrupt write path
+ * used by Project Task HITL cards: a bot-authored message with no human source
+ * (`reply_to_message_id` NULL) that is idempotent on the caller key.
+ */
+describeIfDatabase("PostgreSQLProjectRoomMessageStore correlated interrupt", () => {
+  let pool: Pool;
+  let store: PostgreSQLProjectRoomMessageStore;
+  const tenantId = `correlated-interrupt-${randomUUID()}`;
+
+  beforeAll(async () => {
+    pool = new Pool({ connectionString: databaseUrl });
+    const mm = new MigrationManager(pool);
+    mm.register(createProjectRoomTables);
+    await mm.migrate();
+    store = new PostgreSQLProjectRoomMessageStore({ pool });
+  });
+
+  afterEach(async () => {
+    await pool.query("DELETE FROM lattice_project_room_messages WHERE tenant_id = $1", [tenantId]);
+  });
+
+  afterAll(async () => {
+    await pool.end();
+  });
+
+  it("round-trips a source-less bot interrupt without a reply target", async () => {
+    const candidate = {
+      id: randomUUID(), tenantId, workspaceId: "w1", projectId: "p1", roomId: "r1",
+      author: { type: "bot" as const, membershipId: "m1", assistantId: "a1" },
+      content: { type: "text" as const, text: "```clarify\n{}\n```" }, mentions: [],
+      source: "agent" as const, sourceId: "interrupt:task:t1:run1", idempotencyKey: "room-interrupt:m1:task:t1:run1",
+    };
+
+    const first = await store.createIdempotent(candidate);
+    expect(first.author).toEqual({ type: "bot", membershipId: "m1", assistantId: "a1" });
+    expect(first.source).toBe("agent");
+    expect(first.sourceId).toBe("interrupt:task:t1:run1");
+    expect(first.replyToMessageId).toBeUndefined();
+    expect(first.idempotencyKey).toBe("room-interrupt:m1:task:t1:run1");
+
+    const reloaded = await store.findById(tenantId, first.id);
+    expect(reloaded).toMatchObject({ id: first.id, source: "agent", sourceId: "interrupt:task:t1:run1" });
+    expect(reloaded?.replyToMessageId).toBeUndefined();
+  });
+
+  it("is idempotent on the caller correlation key", async () => {
+    const base = {
+      tenantId, workspaceId: "w1", projectId: "p1", roomId: "r1",
+      author: { type: "bot" as const, membershipId: "m1", assistantId: "a1" },
+      content: { type: "text" as const, text: "```clarify\n{}\n```" }, mentions: [],
+      source: "agent" as const, sourceId: "interrupt:task:t2:run1", idempotencyKey: "room-interrupt:m1:task:t2:run1",
+    };
+
+    const first = await store.createIdempotent({ ...base, id: randomUUID() });
+    const second = await store.createIdempotent({ ...base, id: randomUUID() });
+    expect(second.id).toBe(first.id);
+
+    const rows = await pool.query<{ count: string }>(
+      "SELECT COUNT(*)::text AS count FROM lattice_project_room_messages WHERE tenant_id = $1 AND idempotency_key = $2",
+      [tenantId, base.idempotencyKey],
+    );
+    expect(rows.rows[0]?.count).toBe("1");
+  });
+});

package/src/__tests__/PostgreSQLProjectRoomMessageStore.test.ts

@@ -139,4 +139,27 @@ describe("PostgreSQLProjectRoomMessageStore", () => {
     await store.deleteChatOlderThan({ before: now, limit: 99_999 });
     expect(query.mock.calls[0][1]).toEqual([now, 1_000]);
   });
+
+  it("maps a source-less bot interrupt with a NULL reply target and caller idempotency", async () => {
+    const botAuthor = { type: "bot", membershipId: "m1", assistantId: "a1" };
+    query.mockResolvedValueOnce({
+      rows: [{
+        ...row, author: botAuthor, content: { type: "text", text: "```clarify\n{}\n```" },
+        mentions: [], reply_to_message_id: null, source: "agent",
+        source_id: "interrupt:task:t1:run1", idempotency_key: "room-interrupt:m1:task:t1:run1",
+      }],
+    });
+    const store = new PostgreSQLProjectRoomMessageStore({ pool });
+    await store.createIdempotent({
+      id: "candidate", tenantId: "tenant-1", workspaceId: "workspace-1", projectId: "project-1", roomId: "room-1",
+      author: botAuthor, content: { type: "text", text: "```clarify\n{}\n```" }, mentions: [],
+      source: "agent", sourceId: "interrupt:task:t1:run1", idempotencyKey: "room-interrupt:m1:task:t1:run1",
+    });
+    const params = query.mock.calls[0][1] as unknown[];
+    expect(params[8]).toBeNull();
+    expect(params[5]).toBe(JSON.stringify(botAuthor));
+    expect(params[9]).toBe("agent");
+    expect(params[10]).toBe("interrupt:task:t1:run1");
+    expect(params[11]).toBe("room-interrupt:m1:task:t1:run1");
+  });
 });