@kernl-sdk/pg 0.1.25 → 0.1.26

package/dist/pgvector/sql/__tests__/query.test.js

@@ -22,7 +22,7 @@ describe("sqlize", () => {
             schema: "public",
             table: "docs",
         });
-        expect(result.limit).toEqual({ topK: 10, offset: 0 });
+        expect(result.limit).toEqual({ limit: 10, offset: 0 });
     });
     it("throws on multi-signal fusion (not supported by pgvector)", () => {
         expect(() => sqlize({
@@ -55,14 +55,14 @@ describe("sqlize", () => {
     it("converts query with pagination", () => {
         const result = sqlize({
             query: [{ embedding: [0.1, 0.2] }],
-            topK: 25,
+            limit: 25,
             offset: 50,
         }, { pkey: "id", schema: "public", table: "docs" });
-        expect(result.limit).toEqual({ topK: 25, offset: 50 });
+        expect(result.limit).toEqual({ limit: 25, offset: 50 });
     });
     it("uses default pagination values", () => {
         const result = sqlize({ query: [{ embedding: [0.1, 0.2] }] }, { pkey: "id", schema: "public", table: "docs" });
-        expect(result.limit).toEqual({ topK: 10, offset: 0 });
+        expect(result.limit).toEqual({ limit: 10, offset: 0 });
     });
     it("passes binding through to all inputs", () => {
         const binding = {
@@ -90,7 +90,7 @@ describe("sqlize", () => {
         const result = sqlize({
             filter: { status: "active" },
             orderBy: { field: "created_at", direction: "desc" },
-            topK: 100,
+            limit: 100,
         }, { pkey: "id", schema: "public", table: "docs" });
         expect(result.select.signals).toEqual([]);
         expect(result.order.signals).toEqual([]);
@@ -132,7 +132,7 @@ describe("sqlize", () => {
                     },
                 },
             };
-            const result = sqlize({ filter: { status: "active" }, topK: 50 }, { pkey: "id", schema: "public", table: "docs", binding });
+            const result = sqlize({ filter: { status: "active" }, limit: 50 }, { pkey: "id", schema: "public", table: "docs", binding });
             expect(result.select.binding).toBe(binding);
             expect(result.order.binding).toBe(binding);
             expect(result.select.signals).toEqual([]);
@@ -142,7 +142,7 @@ describe("sqlize", () => {
         it("handles orderBy without query signals", () => {
             const result = sqlize({
                 orderBy: { field: "created_at", direction: "asc" },
-                topK: 20,
+                limit: 20,
             }, { pkey: "id", schema: "public", table: "docs" });
             expect(result.select.signals).toEqual([]);
             expect(result.order.signals).toEqual([]);
@@ -150,7 +150,7 @@ describe("sqlize", () => {
                 field: "created_at",
                 direction: "asc",
             });
-            expect(result.limit).toEqual({ topK: 20, offset: 0 });
+            expect(result.limit).toEqual({ limit: 20, offset: 0 });
         });
     });
     describe("edge cases", () => {
@@ -177,7 +177,7 @@ describe("sqlize", () => {
                 query: [{ embedding: [0.1, 0.2, 0.3] }],
                 filter: { status: "active", views: { $gt: 100 } },
                 orderBy: { field: "created_at", direction: "desc" },
-                topK: 50,
+                limit: 50,
                 offset: 25,
             }, { pkey: "doc_id", schema: "public", table: "documents", binding });
             expect(result.select.pkey).toBe("doc_id");
@@ -192,7 +192,7 @@ describe("sqlize", () => {
                 direction: "desc",
             });
             expect(result.order.binding).toBe(binding);
-            expect(result.limit).toEqual({ topK: 50, offset: 25 });
+            expect(result.limit).toEqual({ limit: 50, offset: 25 });
         });
         it("handles undefined filter", () => {
             const result = sqlize({ query: [{ embedding: [0.1, 0.2] }] }, { pkey: "id", schema: "public", table: "docs" });
@@ -228,7 +228,7 @@ describe("full pipeline integration", () => {
         const query = sqlize({
             query: [{ embedding: vector }],
             filter: { status: "active", views: { $gt: 100 } },
-            topK: 25,
+            limit: 25,
             offset: 50,
         }, { pkey: "doc_id", schema: "public", table: "documents", binding });
         // Step 2: encode each clause (include: false to exclude extra columns)
@@ -266,7 +266,7 @@ describe("full pipeline integration", () => {
                 $or: [{ featured: true }, { views: { $gte: 1000 } }],
             },
             orderBy: { field: "created_at", direction: "desc" },
-            topK: 10,
+            limit: 10,
         }, { pkey: "id", schema: "public", table: "docs" });
         const select = SQL_SELECT.encode(query.select);
         const whereStartIdx = 1 + select.params.length;
@@ -302,7 +302,7 @@ describe("full pipeline integration", () => {
                 ],
                 deleted_at: null,
             },
-            topK: 5,
+            limit: 5,
         }, { pkey: "id", schema: "public", table: "docs" });
         const select = SQL_SELECT.encode(query.select);
         const whereStartIdx = 1 + select.params.length;
@@ -333,7 +333,7 @@ describe("full pipeline integration", () => {
                 },
             },
         };
-        const query = sqlize({ query: [{ embedding: vector }], topK: 10 }, { pkey: "id", schema: "public", table: "docs", binding });
+        const query = sqlize({ query: [{ embedding: vector }], limit: 10 }, { pkey: "id", schema: "public", table: "docs", binding });
         const select = SQL_SELECT.encode({ ...query.select, include: false });
         const order = SQL_ORDER.encode(query.order);
         // Euclidean uses <-> operator
@@ -355,7 +355,7 @@ describe("full pipeline integration", () => {
                 },
             },
         };
-        const query = sqlize({ query: [{ embedding: vector }], topK: 10 }, { pkey: "id", schema: "public", table: "docs", binding });
+        const query = sqlize({ query: [{ embedding: vector }], limit: 10 }, { pkey: "id", schema: "public", table: "docs", binding });
         const select = SQL_SELECT.encode({ ...query.select, include: false });
         const order = SQL_ORDER.encode(query.order);
         // Dot product uses <#> operator
@@ -368,7 +368,7 @@ describe("full pipeline integration", () => {
         const query = sqlize({
             query: [{ embedding: [0.1, 0.2] }],
             filter: { a: 1, b: 2, c: 3 },
-            topK: 10,
+            limit: 10,
             offset: 20,
         }, { pkey: "id", schema: "public", table: "docs" });
         const select = SQL_SELECT.encode(query.select);
@@ -379,7 +379,7 @@ describe("full pipeline integration", () => {
         // Verify no gaps in indices
         // SELECT: $1 (vector)
         // WHERE: $2, $3, $4 (a, b, c)
-        // LIMIT: $5, $6 (topK, offset)
+        // LIMIT: $5, $6 (limit, offset)
         expect(select.params).toHaveLength(1); // $1
         expect(whereStartIdx).toBe(2);
         expect(where.params).toHaveLength(3); // $2, $3, $4

package/dist/pgvector/sql/limit.js

@@ -2,12 +2,12 @@
  * Codec for building sql LIMIT clause.
  */
 export const SQL_LIMIT = {
-    encode({ topK, offset, startIdx }) {
+    encode({ limit, offset, startIdx }) {
         const parts = [];
         const params = [];
         let idx = startIdx;
         parts.push(`LIMIT $${idx++}`);
-        params.push(topK);
+        params.push(limit);
         if (offset > 0) {
             parts.push(`OFFSET $${idx++}`);
             params.push(offset);

package/dist/pgvector/sql/query.d.ts

@@ -39,7 +39,7 @@ export interface OrderInput {
     table?: string;
 }
 export interface LimitInput {
-    topK: number;
+    limit: number;
     offset: number;
     startIdx: number;
 }

package/dist/pgvector/sql/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/pgvector/sql/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EACP,WAAW,EACX,aAAa,EACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CAsD7E;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACpC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/pgvector/sql/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EACP,WAAW,EACX,aAAa,EACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CAsD7E;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACpC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/pgvector/sql/query.js

@@ -49,6 +49,6 @@ export function sqlize(query, config) {
             schema: config.schema,
             table: config.table,
         },
-        limit: { topK: query.topK ?? 10, offset: query.offset ?? 0 },
+        limit: { limit: query.limit ?? 10, offset: query.offset ?? 0 },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernl-sdk/pg",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "PostgreSQL storage adapter for kernl",
   "keywords": [
     "kernl",
@@ -35,15 +35,15 @@
     "tsc-alias": "^1.8.10",
     "typescript": "5.9.2",
     "vitest": "^4.0.8",
-    "@kernl-sdk/ai": "^0.3.2",
-    "@kernl-sdk/protocol": "^0.3.1"
+    "@kernl-sdk/ai": "^0.3.3",
+    "@kernl-sdk/protocol": "^0.4.0"
   },
   "dependencies": {
     "pg": "^8.16.3",
-    "kernl": "^0.9.1",
-    "@kernl-sdk/retrieval": "^0.1.5",
+    "kernl": "^0.10.0",
+    "@kernl-sdk/retrieval": "^0.1.6",
     "@kernl-sdk/shared": "^0.3.1",
-    "@kernl-sdk/storage": "0.1.25"
+    "@kernl-sdk/storage": "0.1.26"
   },
   "scripts": {
     "clean": "rm -rf dist",

package/src/__tests__/memory-integration.test.ts

@@ -202,7 +202,7 @@ describe.sequential(
       expect(results[0].document?.id).toBe("m1");
     });
 
-    it("respects topK limit", async () => {
+    it("respects limit", async () => {
       await kernl.memories.create({
         id: "m1",
         scope: { namespace: "test" },

package/src/pgvector/__tests__/handle.test.ts

@@ -120,7 +120,7 @@ describe.sequential("PGIndexHandle", () => {
       const handle = search.index("docs");
       const results = await handle.query({
         query: [{ embedding: [0.1, 0.2, 0.3] }],
-        topK: 2,
+        limit: 2,
       });
 
       expect(results).toHaveLength(2);
@@ -136,7 +136,7 @@ describe.sequential("PGIndexHandle", () => {
       const results = await handle.query({
         query: [{ embedding: [0.1, 0.2, 0.3] }],
         filter: { status: "active" },
-        topK: 10,
+        limit: 10,
       });
 
       expect(results).toHaveLength(2);
@@ -152,7 +152,7 @@ describe.sequential("PGIndexHandle", () => {
       const results = await handle.query({
         query: [{ embedding: [0.1, 0.2, 0.3] }],
         filter: { views: { $gte: 100 } },
-        topK: 10,
+        limit: 10,
       });
 
       expect(results.length).toBeGreaterThanOrEqual(2);
@@ -170,7 +170,7 @@ describe.sequential("PGIndexHandle", () => {
         filter: {
           $or: [{ status: "draft" }, { status: "archived" }],
         },
-        topK: 10,
+        limit: 10,
       });
 
       expect(results).toHaveLength(2);
@@ -186,19 +186,19 @@ describe.sequential("PGIndexHandle", () => {
       const results = await handle.query({
         query: [{ embedding: [0.1, 0.2, 0.3] }],
         filter: { status: { $in: ["active", "draft"] } },
-        topK: 10,
+        limit: 10,
       });
 
       expect(results).toHaveLength(3);
     });
 
-    it("respects topK limit", async () => {
+    it("respects limit", async () => {
       await insertDocs();
 
       const handle = search.index("docs");
       const results = await handle.query({
         query: [{ embedding: [0.5, 0.5, 0.5] }],
-        topK: 2,
+        limit: 2,
       });
 
       expect(results).toHaveLength(2);
@@ -212,14 +212,14 @@ describe.sequential("PGIndexHandle", () => {
       // Get first 2
       const page1 = await handle.query({
         query: [{ embedding: [0.5, 0.5, 0.5] }],
-        topK: 2,
+        limit: 2,
         offset: 0,
       });
 
       // Get next 2
       const page2 = await handle.query({
         query: [{ embedding: [0.5, 0.5, 0.5] }],
-        topK: 2,
+        limit: 2,
         offset: 2,
       });
 
@@ -235,7 +235,7 @@ describe.sequential("PGIndexHandle", () => {
       const results = await handle.query({
         filter: { status: "active" },
         orderBy: { field: "views", direction: "desc" },
-        topK: 10,
+        limit: 10,
       });
 
       expect(results).toHaveLength(2);
@@ -249,7 +249,7 @@ describe.sequential("PGIndexHandle", () => {
       const handle = search.index("docs");
       const results = await handle.query({
         query: [{ embedding: [0.1, 0.2, 0.3] }],
-        topK: 1,
+        limit: 1,
       });
 
       expect(results[0].document).toHaveProperty("title");
@@ -266,7 +266,7 @@ describe.sequential("PGIndexHandle", () => {
       const results = await handle.query({
         query: [{ embedding: [0.1, 0.2, 0.3] }],
         filter: { status: "nonexistent" },
-        topK: 10,
+        limit: 10,
       });
 
       expect(results).toEqual([]);
@@ -311,7 +311,7 @@ describe.sequential("PGIndexHandle", () => {
       const handle = search.index<DocFields>("typed-docs");
       const results = await handle.query({
         query: [{ embedding: [0.1, 0.2, 0.3] }],
-        topK: 1,
+        limit: 1,
       });
 
       // TypeScript should allow these without errors

package/src/pgvector/__tests__/integration/document.integration.test.ts

@@ -93,7 +93,7 @@ describe.sequential("pgvector document operations integration tests", () => {
       // Verify document was inserted
       const hits = await handle.query({
         query: [{ embedding: [0.1, 0.2, 0.3, 0.4] }],
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits).toHaveLength(1);
@@ -162,7 +162,7 @@ describe.sequential("pgvector document operations integration tests", () => {
       // Verify update
       const hits = await handle.query({
         filter: { id: "doc-1" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits[0].document?.title).toBe("Updated Title");
@@ -244,7 +244,7 @@ describe.sequential("pgvector document operations integration tests", () => {
       // Verify count
       const hits = await handle.query({
         query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-        topK: 1000,
+        limit: 1000,
       });
 
       expect(hits).toHaveLength(100);
@@ -264,7 +264,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { id: "vec-test" },
-        topK: 1,
+        limit: 1,
       });
 
       // Vector values should be preserved (within floating point precision)
@@ -298,7 +298,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await nullHandle.query({
         filter: { id: "doc-null" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits[0].document?.title).toBe("Has Title");
@@ -343,7 +343,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { id: "patch-1" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits[0].document?.title).toBe("Updated Title");
@@ -363,7 +363,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { id: "patch-1" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits[0].document?.title).toBe("New Title");
@@ -382,7 +382,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { id: "patch-1" },
-        topK: 1,
+        limit: 1,
       });
 
       const stored = hits[0].document?.embedding;
@@ -399,7 +399,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-        topK: 10,
+        limit: 10,
       });
 
       const doc1 = hits.find((h) => h.id === "patch-1");
@@ -438,7 +438,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await nullHandle.query({
         filter: { id: "doc-1" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits[0].document?.subtitle).toBeNull();
@@ -467,7 +467,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { id: "patch-1" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits[0].document?.title).toBe("Updated");
@@ -527,7 +527,7 @@ describe.sequential("pgvector document operations integration tests", () => {
       // Verify deletion
       const hits = await handle.query({
         filter: { id: "del-1" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits).toHaveLength(0);
@@ -541,7 +541,7 @@ describe.sequential("pgvector document operations integration tests", () => {
       // Verify only del-3 remains
       const hits = await handle.query({
         query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-        topK: 10,
+        limit: 10,
       });
 
       expect(hits).toHaveLength(1);
@@ -570,7 +570,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-        topK: 10,
+        limit: 10,
       });
 
       expect(hits).toHaveLength(0);
@@ -594,7 +594,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { views: 0 },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits).toHaveLength(1);
@@ -613,7 +613,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { views: -50 },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits).toHaveLength(1);
@@ -642,12 +642,12 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const trueHits = await handle.query({
         filter: { published: true },
-        topK: 10,
+        limit: 10,
       });
 
       const falseHits = await handle.query({
         filter: { published: false },
-        topK: 10,
+        limit: 10,
       });
 
       expect(trueHits).toHaveLength(1);
@@ -668,7 +668,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { title: "" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits).toHaveLength(1);
@@ -687,7 +687,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { id: "unicode-test" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits[0].document?.title).toBe("Hello 世界 🌍");
@@ -708,7 +708,7 @@ describe.sequential("pgvector document operations integration tests", () => {
 
       const hits = await handle.query({
         filter: { id: "long-string" },
-        topK: 1,
+        limit: 1,
       });
 
       expect(hits[0].document?.content).toBe(longString);