@kernl-sdk/turbopuffer 0.1.3 → 0.1.5

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @kernl-sdk/turbopuffer@0.1.2 build /Users/andjones/Documents/projects/kernl/packages/storage/turbopuffer
+> @kernl-sdk/turbopuffer@0.1.5 build /home/runner/work/kernl/kernl/packages/storage/turbopuffer
 > tsc && tsc-alias --resolve-full-paths
 

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @kernl-sdk/turbopuffer
 
+## 0.1.5
+
+### Patch Changes
+
+- @kernl-sdk/retrieval@0.1.4
+
+## 0.1.4
+
+### Patch Changes
+
+- Add PATCH codec export for document updates
+
 ## 0.1.3
 
 ### Patch Changes

package/dist/__tests__/integration/lifecycle.integration.test.js

@@ -317,11 +317,10 @@ describe("Lifecycle edge cases integration tests", () => {
         });
         it("topK of 0 throws", async () => {
             const index = tpuf.index(indexId);
-            // Turbopuffer requires topK between 1 and 1200
             await expect(index.query({
                 query: [{ vector: [0.1, 0.1, 0.1, 0.1] }],
                 topK: 0,
-            })).rejects.toThrow(/top_k must be between 1 and 1200/i);
+            })).rejects.toThrow();
         });
     });
     // ============================================================

package/dist/__tests__/integration/memory.integration.test.js

@@ -41,7 +41,7 @@ describe.sequential("Memory Integration with Turbopuffer", { timeout: 60000 }, (
                 }),
             },
             memory: {
-                embeddingModel: "openai/text-embedding-3-small",
+                embedding: "openai/text-embedding-3-small",
                 dimensions: 1536,
                 indexId: vectorIndexId,
             },
@@ -284,4 +284,47 @@ describe.sequential("Memory Integration with Turbopuffer", { timeout: 60000 }, (
         expect(results.length).toBe(1);
         expect(results[0].document?.id).toBe(id1);
     });
+    it("isolates memories by agentId", async () => {
+        const ns = uid("ns");
+        // Register a second agent
+        const model2 = {
+            spec: "1.0",
+            provider: "test",
+            modelId: "test-model",
+        };
+        const agent2 = new Agent({
+            id: "test-agent-2",
+            name: "Test Agent 2",
+            instructions: () => "test instructions",
+            model: model2,
+        });
+        kernl.register(agent2);
+        // Create memories for each agent in the same namespace
+        await agent.memories.create({
+            namespace: ns,
+            collection: "facts",
+            content: { text: "Agent 1 knows about cats" },
+        });
+        await agent2.memories.create({
+            namespace: ns,
+            collection: "facts",
+            content: { text: "Agent 2 knows about cats" },
+        });
+        // Search from agent1 - should only see agent1's memory
+        const results1 = await agent.memories.search({
+            query: "cats",
+            filter: { scope: { namespace: ns } },
+            limit: 10,
+        });
+        // Search from agent2 - should only see agent2's memory
+        const results2 = await agent2.memories.search({
+            query: "cats",
+            filter: { scope: { namespace: ns } },
+            limit: 10,
+        });
+        expect(results1).toHaveLength(1);
+        expect(results1[0].document?.agentId).toBe("test-agent");
+        expect(results2).toHaveLength(1);
+        expect(results2[0].document?.agentId).toBe("test-agent-2");
+    });
 });

package/dist/__tests__/integration/query.integration.test.js

@@ -275,15 +275,16 @@ describe("Query modes integration tests", () => {
             expect(hits[0].document).toHaveProperty("category");
             expect(hits[0].document).toHaveProperty("priority");
         });
-        it("include: false returns no attributes", async () => {
+        it("include: false returns only id", async () => {
             const hits = await index.query({
                 query: [{ vector: [1.0, 0.0, 0.0, 0.0] }],
                 topK: 1,
                 include: false,
             });
             expect(hits.length).toBe(1);
-            // document should be undefined or empty
-            expect(hits[0].document).toBeUndefined();
+            // Turbopuffer always returns id, but no other attributes
+            const { id, ...rest } = hits[0].document ?? {};
+            expect(Object.keys(rest).length).toBe(0);
         });
         it("include: [fields] returns only specified fields", async () => {
             const hits = await index.query({
@@ -299,16 +300,16 @@ describe("Query modes integration tests", () => {
             expect(hits[0].document).not.toHaveProperty("content");
             expect(hits[0].document).not.toHaveProperty("priority");
         });
-        it("include: [] returns no attributes", async () => {
+        it("include: [] returns only id", async () => {
             const hits = await index.query({
                 query: [{ vector: [1.0, 0.0, 0.0, 0.0] }],
                 topK: 1,
                 include: [],
             });
             expect(hits.length).toBe(1);
-            // Empty include array should return no fields
-            expect(hits[0].document === undefined ||
-                Object.keys(hits[0].document).length === 0).toBe(true);
+            // Turbopuffer always returns id, but no other attributes
+            const { id, ...rest } = hits[0].document ?? {};
+            expect(Object.keys(rest).length).toBe(0);
         });
     });
     // ============================================================

package/dist/handle.js

@@ -2,7 +2,7 @@
  * Turbopuffer index handle implementation.
  */
 import { normalizeQuery } from "@kernl-sdk/retrieval";
-import { DOCUMENT, PATCH, QUERY, SEARCH_HIT } from "./convert.js";
+import { DOCUMENT, PATCH, QUERY, SEARCH_HIT } from "./convert/index.js";
 /**
  * Handle for operating on a specific Turbopuffer namespace (index).
  */

package/dist/search.js

@@ -9,7 +9,7 @@
 import Turbopuffer from "@turbopuffer/turbopuffer";
 import { CursorPage } from "@kernl-sdk/shared";
 import { TurbopufferIndexHandle } from "./handle.js";
-import { INDEX_SCHEMA, SIMILARITY } from "./convert.js";
+import { INDEX_SCHEMA, SIMILARITY } from "./convert/index.js";
 /**
  * Turbopuffer search index adapter.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernl-sdk/turbopuffer",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Turbopuffer search index adapter for kernl",
   "keywords": [
     "kernl",
@@ -31,8 +31,8 @@
   },
   "dependencies": {
     "@turbopuffer/turbopuffer": "^0.10.0",
-    "@kernl-sdk/shared": "0.3.0",
-    "@kernl-sdk/retrieval": "0.1.3"
+    "@kernl-sdk/retrieval": "0.1.4",
+    "@kernl-sdk/shared": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^24.10.0",
@@ -41,10 +41,10 @@
     "tsc-alias": "^1.8.10",
     "typescript": "5.9.2",
     "vitest": "^4.0.8",
-    "@kernl-sdk/protocol": "0.2.8",
-    "@kernl-sdk/ai": "0.2.10",
-    "@kernl-sdk/pg": "0.1.16",
-    "kernl": "0.7.3"
+    "@kernl-sdk/ai": "0.3.1",
+    "@kernl-sdk/pg": "0.1.24",
+    "@kernl-sdk/protocol": "0.3.0",
+    "kernl": "0.9.0"
   },
   "scripts": {
     "build": "tsc && tsc-alias --resolve-full-paths",

package/src/__tests__/integration/lifecycle.integration.test.ts

@@ -392,13 +392,12 @@ describe("Lifecycle edge cases integration tests", () => {
     it("topK of 0 throws", async () => {
       const index = tpuf.index(indexId);
 
-      // Turbopuffer requires topK between 1 and 1200
       await expect(
         index.query({
           query: [{ vector: [0.1, 0.1, 0.1, 0.1] }],
           topK: 0,
         }),
-      ).rejects.toThrow(/top_k must be between 1 and 1200/i);
+      ).rejects.toThrow();
     });
   });
 

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

@@ -55,7 +55,7 @@ describe.sequential(
           }),
         },
         memory: {
-          embeddingModel: "openai/text-embedding-3-small",
+          embedding: "openai/text-embedding-3-small",
           dimensions: 1536,
           indexId: vectorIndexId,
         },
@@ -349,5 +349,57 @@ describe.sequential(
       expect(results.length).toBe(1);
       expect(results[0].document?.id).toBe(id1);
     });
+
+    it("isolates memories by agentId", async () => {
+      const ns = uid("ns");
+
+      // Register a second agent
+      const model2 = {
+        spec: "1.0" as const,
+        provider: "test",
+        modelId: "test-model",
+      } as unknown as LanguageModel;
+
+      const agent2 = new Agent({
+        id: "test-agent-2",
+        name: "Test Agent 2",
+        instructions: () => "test instructions",
+        model: model2,
+      });
+      kernl.register(agent2);
+
+      // Create memories for each agent in the same namespace
+      await agent.memories.create({
+        namespace: ns,
+        collection: "facts",
+        content: { text: "Agent 1 knows about cats" },
+      });
+
+      await agent2.memories.create({
+        namespace: ns,
+        collection: "facts",
+        content: { text: "Agent 2 knows about cats" },
+      });
+
+      // Search from agent1 - should only see agent1's memory
+      const results1 = await agent.memories.search({
+        query: "cats",
+        filter: { scope: { namespace: ns } },
+        limit: 10,
+      });
+
+      // Search from agent2 - should only see agent2's memory
+      const results2 = await agent2.memories.search({
+        query: "cats",
+        filter: { scope: { namespace: ns } },
+        limit: 10,
+      });
+
+      expect(results1).toHaveLength(1);
+      expect(results1[0].document?.agentId).toBe("test-agent");
+
+      expect(results2).toHaveLength(1);
+      expect(results2[0].document?.agentId).toBe("test-agent-2");
+    });
   },
 );

package/src/__tests__/integration/query.integration.test.ts

@@ -342,7 +342,7 @@ describe("Query modes integration tests", () => {
       expect(hits[0].document).toHaveProperty("priority");
     });
 
-    it("include: false returns no attributes", async () => {
+    it("include: false returns only id", async () => {
       const hits = await index.query({
         query: [{ vector: [1.0, 0.0, 0.0, 0.0] }],
         topK: 1,
@@ -350,8 +350,9 @@ describe("Query modes integration tests", () => {
       });
 
       expect(hits.length).toBe(1);
-      // document should be undefined or empty
-      expect(hits[0].document).toBeUndefined();
+      // Turbopuffer always returns id, but no other attributes
+      const { id, ...rest } = hits[0].document ?? {};
+      expect(Object.keys(rest).length).toBe(0);
     });
 
     it("include: [fields] returns only specified fields", async () => {
@@ -370,7 +371,7 @@ describe("Query modes integration tests", () => {
       expect(hits[0].document).not.toHaveProperty("priority");
     });
 
-    it("include: [] returns no attributes", async () => {
+    it("include: [] returns only id", async () => {
       const hits = await index.query({
         query: [{ vector: [1.0, 0.0, 0.0, 0.0] }],
         topK: 1,
@@ -378,11 +379,9 @@ describe("Query modes integration tests", () => {
       });
 
       expect(hits.length).toBe(1);
-      // Empty include array should return no fields
-      expect(
-        hits[0].document === undefined ||
-          Object.keys(hits[0].document).length === 0,
-      ).toBe(true);
+      // Turbopuffer always returns id, but no other attributes
+      const { id, ...rest } = hits[0].document ?? {};
+      expect(Object.keys(rest).length).toBe(0);
     });
   });
 

package/.turbo/turbo-check-types.log

@@ -1,60 +0,0 @@
-
-> @kernl-sdk/turbopuffer@0.0.1 check-types /Users/andjones/Documents/projects/kernl/packages/storage/turbopuffer
-> tsc --noEmit
-
-src/__tests__/convert.test.ts(315,9): error TS2353: Object literal may only specify known properties, and 'index' does not exist in type 'SearchQuery'.
-src/__tests__/convert.test.ts(326,9): error TS2353: Object literal may only specify known properties, and 'index' does not exist in type 'SearchQuery'.
-src/__tests__/convert.test.ts(338,9): error TS2353: Object literal may only specify known properties, and 'index' does not exist in type 'SearchQuery'.
-src/__tests__/convert.test.ts(355,9): error TS2353: Object literal may only specify known properties, and 'index' does not exist in type 'SearchQuery'.
-src/__tests__/convert.test.ts(366,9): error TS2353: Object literal may only specify known properties, and 'index' does not exist in type 'SearchQuery'.
-src/__tests__/convert.test.ts(377,9): error TS2353: Object literal may only specify known properties, and 'index' does not exist in type 'SearchQuery'.
-src/__tests__/convert.test.ts(388,9): error TS2353: Object literal may only specify known properties, and 'index' does not exist in type 'SearchQuery'.
-src/__tests__/convert.test.ts(432,21): error TS2339: Property 'vector' does not exist on type 'SearchHit<UnknownDocument>'.
-src/__tests__/integration.test.ts(27,30): error TS2345: Argument of type '{ id: string; }' is not assignable to parameter of type 'string'.
-src/__tests__/integration.test.ts(45,46): error TS2345: Argument of type '{ id: string; }' is not assignable to parameter of type 'string'.
-src/__tests__/integration.test.ts(121,46): error TS2345: Argument of type '{ id: string; }' is not assignable to parameter of type 'string'.
-src/__tests__/integration.test.ts(135,28): error TS2345: Argument of type '{ id: string; }' is not assignable to parameter of type 'string'.
-src/__tests__/integration.test.ts(153,46): error TS2345: Argument of type '{ id: string; }' is not assignable to parameter of type 'string'.
-src/__tests__/integration.test.ts(157,30): error TS2345: Argument of type '{ id: string; }' is not assignable to parameter of type 'string'.
-src/__tests__/integration.test.ts(160,39): error TS2345: Argument of type '{ id: string; }' is not assignable to parameter of type 'string'.
-src/__tests__/integration.test.ts(168,18): error TS2339: Property 'upsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(179,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(187,30): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(196,18): error TS2339: Property 'upsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(207,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(214,30): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(222,18): error TS2339: Property 'mupsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(244,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(253,29): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(260,18): error TS2339: Property 'mupsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(266,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(279,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(293,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(308,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(333,18): error TS2339: Property 'upsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(344,29): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(350,25): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(353,18): error TS2339: Property 'delete' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(356,25): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(362,25): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(371,18): error TS2339: Property 'mupsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(393,29): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(402,18): error TS2339: Property 'mdelete' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(408,25): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(414,25): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(415,25): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(422,18): error TS2339: Property 'mupsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(444,29): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(453,18): error TS2339: Property 'mdelete' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(459,25): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(474,18): error TS2339: Property 'upsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(485,18): error TS2339: Property 'update' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(494,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(502,30): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(514,18): error TS2339: Property 'mupsert' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(536,18): error TS2339: Property 'mupdate' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(550,31): error TS2339: Property 'query' does not exist on type 'TurbopufferSearchIndex'.
-src/__tests__/integration.test.ts(559,25): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(560,25): error TS7006: Parameter 'h' implicitly has an 'any' type.
-src/__tests__/integration.test.ts(564,18): error TS2339: Property 'mupdate' does not exist on type 'TurbopufferSearchIndex'.
- ELIFECYCLE  Command failed with exit code 2.

package/dist/__tests__/filters.integration.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * Comprehensive filter integration tests.
- *
- * Tests all filter operators against real Turbopuffer API with a
- * deterministic dataset.
- */
-export {};
-//# sourceMappingURL=filters.integration.test.d.ts.map

package/dist/__tests__/filters.integration.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"filters.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/filters.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}