kernl 0.6.2 → 0.6.3

package/dist/kernl/types.d.ts

@@ -0,0 +1,91 @@
+import { LanguageModel, EmbeddingModel } from "@kernl-sdk/protocol";
+import { SearchIndex } from "@kernl-sdk/retrieval";
+import { Agent } from "../agent.js";
+import { KernlStorage } from "../storage/index.js";
+/**
+ * Storage configuration for Kernl.
+ */
+export interface StorageOptions {
+    /**
+     * Relational database storage (threads, tasks, traces).
+     */
+    db?: KernlStorage;
+    /**
+     * Vector search index for semantic memory search.
+     * Supports pgvector, Turbopuffer, etc.
+     */
+    vector?: SearchIndex;
+}
+/**
+ * Memory system configuration.
+ */
+export interface MemoryOptions {
+    /**
+     * Embedding model for memory encoding.
+     *
+     * Can be:
+     * - A string like "openai/text-embedding-3-small" (resolved via provider registry)
+     * - An EmbeddingModel instance
+     *
+     * @default "openai/text-embedding-3-small"
+     */
+    embeddingModel?: string | EmbeddingModel<string>;
+    /**
+     * Logical index ID used by the search backend.
+     * - For pgvector: becomes the table name (with schema from indexProviderOptions)
+     * - For Turbopuffer: becomes the namespace
+     * @default "kernl_memories_index"
+     */
+    indexId?: string;
+    /**
+     * Backend-specific options passed to SearchIndex.createIndex().
+     * - For pgvector: { schema?: string } controls schema (default: "kernl")
+     * - For Turbopuffer: not used
+     */
+    indexProviderOptions?: Record<string, unknown>;
+    /**
+     * Vector dimensions for embeddings.
+     * Only needed if embedding model doesn't provide this automatically.
+     * @default 1536
+     */
+    dimensions?: number;
+    /**
+     * Similarity metric for vector search.
+     * @default "cosine"
+     */
+    similarity?: "cosine" | "euclidean" | "dot_product";
+}
+/**
+ * Configuration options for creating a Kernl instance.
+ */
+export interface KernlOptions {
+    /**
+     * Storage configuration for persisting threads, tasks, and traces.
+     */
+    storage?: StorageOptions;
+    /**
+     * Memory system configuration.
+     */
+    memory?: MemoryOptions;
+}
+/**
+ * Agent registry interface.
+ *
+ * Satisfied by Map<string, Agent>.
+ */
+export interface AgentRegistry {
+    get(id: string): Agent<any> | undefined;
+}
+/**
+ * Model registry interface.
+ *
+ * Satisfied by Map<string, LanguageModel>.
+ * Key format: "provider/modelId"
+ *
+ * TODO: Create an exhaustive model registry in the protocol package
+ * with all supported models and their metadata.
+ */
+export interface ModelRegistry {
+    get(key: string): LanguageModel | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/kernl/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kernl/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CAKtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC7C"}

package/dist/lib/error.d.ts

@@ -1,7 +1,7 @@
 import { InputGuardrailResult, OutputGuardrailMetadata, OutputGuardrailResult } from "../guardrail.js";
 type SerializedThread = any;
-import { AgentResponseType } from "../types/agent.js";
-import { TextResponse } from "../types/thread.js";
+import { AgentResponseType } from "../agent/types.js";
+import { TextResponse } from "../thread/types.js";
 /**
  * Abstract base class for all `kernl` errors
  * Requires subclasses to implement JSON serialization

package/dist/lifecycle.d.ts

@@ -3,8 +3,8 @@ import { Agent } from "./agent.js";
 import { Context, UnknownContext } from "./context.js";
 import { Tool } from "./tool/index.js";
 import type { ToolCall } from "@kernl-sdk/protocol";
-import { AgentResponseType } from "./types/agent.js";
-import { TextResponse } from "./types/thread.js";
+import { AgentResponseType } from "./agent/types.js";
+import { TextResponse } from "./thread/types.js";
 export type EventEmitterEvents = Record<string, any[]>;
 /**
  * Generic typed event emitter that wraps Node's EventEmitter with type safety

package/dist/memory/codec.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Memory codecs.
+ */
+import type { Codec, AsyncCodec } from "@kernl-sdk/shared/lib";
+import type { Filter as SearchFilter } from "@kernl-sdk/retrieval";
+import type { MemoryFilter, MemoryRecord, MemoryRecordUpdate, IndexMemoryRecord, IndexMemoryRecordPatch, MemoryByteCodec } from "./types.js";
+/**
+ * Codec for converting MemoryFilter to retrieval Filter.
+ *
+ * - scope.namespace → namespace
+ * - scope.entityId → entityId
+ * - scope.agentId → agentId
+ * - collections → collection: { $in: [...] }
+ * - after/before → timestamp: { $gt/$lt }
+ *
+ * Content field filtering (text, metadata, kind) is not currently supported.
+ * Text relevance is handled via vector similarity in the query, not filters.
+ */
+export declare const MEMORY_FILTER: Codec<MemoryFilter, SearchFilter>;
+/**
+ * Create a codec for MemoryRecord -> IndexMemoryRecord.
+ */
+export declare function recordCodec(bytecodec: MemoryByteCodec): AsyncCodec<MemoryRecord, IndexMemoryRecord>;
+/**
+ * Codec for converting MemoryRecordUpdate to IndexMemoryRecordPatch.
+ *
+ * Maps patchable fields from domain update to index patch format.
+ * wmem/smem are store-only fields and are not included.
+ * content changes require full re-index, not a patch.
+ */
+export declare const PATCH_CODEC: Codec<MemoryRecordUpdate, IndexMemoryRecordPatch>;
+//# sourceMappingURL=codec.d.ts.map

package/dist/memory/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/memory/codec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,YAAY,EAAE,YAAY,CA0B3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,eAAe,GACzB,UAAU,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAqB7C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,kBAAkB,EAAE,sBAAsB,CAqBzE,CAAC"}

package/dist/memory/codec.js

@@ -0,0 +1,97 @@
+/**
+ * Memory codecs.
+ */
+/**
+ * Codec for converting MemoryFilter to retrieval Filter.
+ *
+ * - scope.namespace → namespace
+ * - scope.entityId → entityId
+ * - scope.agentId → agentId
+ * - collections → collection: { $in: [...] }
+ * - after/before → timestamp: { $gt/$lt }
+ *
+ * Content field filtering (text, metadata, kind) is not currently supported.
+ * Text relevance is handled via vector similarity in the query, not filters.
+ */
+export const MEMORY_FILTER = {
+    encode(mf) {
+        const sf = {};
+        // scope
+        if (mf.scope?.namespace !== undefined)
+            sf.namespace = mf.scope.namespace;
+        if (mf.scope?.entityId !== undefined)
+            sf.entityId = mf.scope.entityId;
+        if (mf.scope?.agentId !== undefined)
+            sf.agentId = mf.scope.agentId;
+        if (mf.collections && mf.collections.length > 0) {
+            sf.collection = { $in: mf.collections };
+        }
+        if (mf.after !== undefined || mf.before !== undefined) {
+            const ts = {};
+            if (mf.after !== undefined)
+                ts.$gt = mf.after;
+            if (mf.before !== undefined)
+                ts.$lt = mf.before;
+            sf.timestamp = ts;
+        }
+        return sf;
+    },
+    decode(_filter) {
+        throw new Error("MEMORY_FILTER.decode not implemented");
+    },
+};
+/**
+ * Create a codec for MemoryRecord -> IndexMemoryRecord.
+ */
+export function recordCodec(bytecodec) {
+    return {
+        async encode(record) {
+            const indexable = await bytecodec.encode(record.content);
+            return {
+                id: record.id,
+                namespace: record.scope.namespace ?? null,
+                entityId: record.scope.entityId ?? null,
+                agentId: record.scope.agentId ?? null,
+                kind: record.kind,
+                collection: record.collection,
+                timestamp: record.timestamp,
+                createdAt: record.createdAt,
+                updatedAt: record.updatedAt,
+                ...indexable,
+            };
+        },
+        async decode() {
+            throw new Error("createRecordCodec.decode not implemented");
+        },
+    };
+}
+/**
+ * Codec for converting MemoryRecordUpdate to IndexMemoryRecordPatch.
+ *
+ * Maps patchable fields from domain update to index patch format.
+ * wmem/smem are store-only fields and are not included.
+ * content changes require full re-index, not a patch.
+ */
+export const PATCH_CODEC = {
+    encode(update) {
+        const patch = { id: update.id };
+        if (update.scope?.namespace !== undefined)
+            patch.namespace = update.scope.namespace;
+        if (update.scope?.entityId !== undefined)
+            patch.entityId = update.scope.entityId;
+        if (update.scope?.agentId !== undefined)
+            patch.agentId = update.scope.agentId;
+        if (update.collection !== undefined)
+            patch.collection = update.collection;
+        if (update.timestamp !== undefined)
+            patch.timestamp = update.timestamp;
+        if (update.updatedAt !== undefined)
+            patch.updatedAt = update.updatedAt;
+        if (update.metadata !== undefined)
+            patch.metadata = update.metadata;
+        return patch;
+    },
+    decode(_patch) {
+        throw new Error("PATCH_CODEC.decode not implemented");
+    },
+};

package/dist/memory/codecs/domain.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Domain-level memory codecs.
+ *
+ * Codecs for transforming between memory domain types and search/index formats.
+ */
+import type { Codec, AsyncCodec } from "@kernl-sdk/shared/lib";
+import type { Filter as SearchFilter } from "@kernl-sdk/retrieval";
+import type { MemoryFilter, MemoryRecord, MemoryRecordUpdate, IndexMemoryRecord, IndexMemoryRecordPatch, MemoryByteCodec } from "../types.js";
+/**
+ * Codec for converting MemoryFilter to retrieval Filter.
+ *
+ * - scope.namespace → namespace
+ * - scope.entityId → entityId
+ * - scope.agentId → agentId
+ * - collections → collection: { $in: [...] }
+ * - after/before → timestamp: { $gt/$lt }
+ *
+ * Content field filtering (text, metadata, kind) is not currently supported.
+ * Text relevance is handled via vector similarity in the query, not filters.
+ */
+export declare const MEMORY_FILTER: Codec<MemoryFilter, SearchFilter>;
+/**
+ * Create a codec for MemoryRecord -> IndexMemoryRecord.
+ */
+export declare function recordCodec(bytecodec: MemoryByteCodec): AsyncCodec<MemoryRecord, IndexMemoryRecord>;
+/**
+ * Codec for converting MemoryRecordUpdate to IndexMemoryRecordPatch.
+ *
+ * Maps patchable fields from domain update to index patch format.
+ * wmem/smem are store-only fields and are not included.
+ * content changes require full re-index, not a patch.
+ */
+export declare const PATCH_CODEC: Codec<MemoryRecordUpdate, IndexMemoryRecordPatch>;
+//# sourceMappingURL=domain.d.ts.map

package/dist/memory/codecs/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/memory/codecs/domain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,YAAY,EAAE,YAAY,CA0B3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,eAAe,GACzB,UAAU,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAqB7C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,kBAAkB,EAAE,sBAAsB,CAqBzE,CAAC"}

package/dist/memory/codecs/domain.js

@@ -0,0 +1,99 @@
+/**
+ * Domain-level memory codecs.
+ *
+ * Codecs for transforming between memory domain types and search/index formats.
+ */
+/**
+ * Codec for converting MemoryFilter to retrieval Filter.
+ *
+ * - scope.namespace → namespace
+ * - scope.entityId → entityId
+ * - scope.agentId → agentId
+ * - collections → collection: { $in: [...] }
+ * - after/before → timestamp: { $gt/$lt }
+ *
+ * Content field filtering (text, metadata, kind) is not currently supported.
+ * Text relevance is handled via vector similarity in the query, not filters.
+ */
+export const MEMORY_FILTER = {
+    encode(mf) {
+        const sf = {};
+        // scope
+        if (mf.scope?.namespace !== undefined)
+            sf.namespace = mf.scope.namespace;
+        if (mf.scope?.entityId !== undefined)
+            sf.entityId = mf.scope.entityId;
+        if (mf.scope?.agentId !== undefined)
+            sf.agentId = mf.scope.agentId;
+        if (mf.collections && mf.collections.length > 0) {
+            sf.collection = { $in: mf.collections };
+        }
+        if (mf.after !== undefined || mf.before !== undefined) {
+            const ts = {};
+            if (mf.after !== undefined)
+                ts.$gt = mf.after;
+            if (mf.before !== undefined)
+                ts.$lt = mf.before;
+            sf.timestamp = ts;
+        }
+        return sf;
+    },
+    decode(_filter) {
+        throw new Error("MEMORY_FILTER.decode not implemented");
+    },
+};
+/**
+ * Create a codec for MemoryRecord -> IndexMemoryRecord.
+ */
+export function recordCodec(bytecodec) {
+    return {
+        async encode(record) {
+            const indexable = await bytecodec.encode(record.content);
+            return {
+                id: record.id,
+                namespace: record.scope.namespace ?? null,
+                entityId: record.scope.entityId ?? null,
+                agentId: record.scope.agentId ?? null,
+                kind: record.kind,
+                collection: record.collection,
+                timestamp: record.timestamp,
+                createdAt: record.createdAt,
+                updatedAt: record.updatedAt,
+                ...indexable,
+            };
+        },
+        async decode() {
+            throw new Error("recordCodec.decode not implemented");
+        },
+    };
+}
+/**
+ * Codec for converting MemoryRecordUpdate to IndexMemoryRecordPatch.
+ *
+ * Maps patchable fields from domain update to index patch format.
+ * wmem/smem are store-only fields and are not included.
+ * content changes require full re-index, not a patch.
+ */
+export const PATCH_CODEC = {
+    encode(update) {
+        const patch = { id: update.id };
+        if (update.scope?.namespace !== undefined)
+            patch.namespace = update.scope.namespace;
+        if (update.scope?.entityId !== undefined)
+            patch.entityId = update.scope.entityId;
+        if (update.scope?.agentId !== undefined)
+            patch.agentId = update.scope.agentId;
+        if (update.collection !== undefined)
+            patch.collection = update.collection;
+        if (update.timestamp !== undefined)
+            patch.timestamp = update.timestamp;
+        if (update.updatedAt !== undefined)
+            patch.updatedAt = update.updatedAt;
+        if (update.metadata !== undefined)
+            patch.metadata = update.metadata;
+        return patch;
+    },
+    decode(_patch) {
+        throw new Error("PATCH_CODEC.decode not implemented");
+    },
+};

package/dist/memory/codecs/identity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Identity codecs - pass through unchanged.
+ *
+ * Used for backends that support the full IndexMemoryRecord schema natively.
+ */
+import type { Codec } from "@kernl-sdk/shared/lib";
+import type { FieldSchema, SearchQuery, UnknownDocument } from "@kernl-sdk/retrieval";
+import type { IndexMemoryRecord } from "../types.js";
+export declare const IDENTITY_DOC: Codec<IndexMemoryRecord, UnknownDocument>;
+export declare const IDENTITY_SCHEMA: Codec<Record<string, FieldSchema>, Record<string, FieldSchema>>;
+export declare const IDENTITY_QUERY: Codec<SearchQuery, SearchQuery>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/memory/codecs/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/memory/codecs/identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,iBAAiB,EAAE,eAAe,CAGlE,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAAK,CACjC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAC3B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAI5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,WAAW,CAG1D,CAAC"}

package/dist/memory/codecs/identity.js

@@ -0,0 +1,17 @@
+/**
+ * Identity codecs - pass through unchanged.
+ *
+ * Used for backends that support the full IndexMemoryRecord schema natively.
+ */
+export const IDENTITY_DOC = {
+    encode: (doc) => doc,
+    decode: (row) => row,
+};
+export const IDENTITY_SCHEMA = {
+    encode: (schema) => schema,
+    decode: (schema) => schema,
+};
+export const IDENTITY_QUERY = {
+    encode: (q) => q,
+    decode: (q) => q,
+};

package/dist/memory/codecs/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Memory codecs.
+ *
+ * Re-exports all memory codecs:
+ * - Domain codecs (MEMORY_FILTER, PATCH_CODEC, recordCodec)
+ * - Backend codecs (TPUF_*, IDENTITY_*)
+ * - Backend codec registry (getBackendCodecs)
+ */
+import type { Codec } from "@kernl-sdk/shared/lib";
+import type { FieldSchema, SearchQuery, UnknownDocument } from "@kernl-sdk/retrieval";
+import type { IndexMemoryRecord } from "../types.js";
+export { MEMORY_FILTER, PATCH_CODEC, recordCodec } from "./domain.js";
+export { IDENTITY_DOC, IDENTITY_SCHEMA, IDENTITY_QUERY } from "./identity.js";
+export { TPUF_DOC, TPUF_SCHEMA, TPUF_QUERY } from "./tpuf.js";
+/**
+ * Backend codec set.
+ */
+export interface AdapterCodecs {
+    doc: Codec<IndexMemoryRecord, UnknownDocument>;
+    schema: Codec<Record<string, FieldSchema>, Record<string, FieldSchema>>;
+    query: Codec<SearchQuery, SearchQuery>;
+}
+/**
+ * Registry of backend codecs.
+ */
+export declare const ADAPTER_CODECS: Record<string, AdapterCodecs>;
+/**
+ * Get codecs for a backend, falling back to identity.
+ */
+export declare function getAdapterCodecs(adapterId: string): AdapterCodecs;
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/codecs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/codecs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKlD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,KAAK,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IAC/C,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACxE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAOxD,CAAC;AAWF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAEjE"}

package/dist/memory/codecs/index.js

@@ -0,0 +1,39 @@
+/**
+ * Memory codecs.
+ *
+ * Re-exports all memory codecs:
+ * - Domain codecs (MEMORY_FILTER, PATCH_CODEC, recordCodec)
+ * - Backend codecs (TPUF_*, IDENTITY_*)
+ * - Backend codec registry (getBackendCodecs)
+ */
+import { IDENTITY_DOC, IDENTITY_SCHEMA, IDENTITY_QUERY } from "./identity.js";
+import { TPUF_DOC, TPUF_SCHEMA, TPUF_QUERY } from "./tpuf.js";
+// re-exports
+export { MEMORY_FILTER, PATCH_CODEC, recordCodec } from "./domain.js";
+export { IDENTITY_DOC, IDENTITY_SCHEMA, IDENTITY_QUERY } from "./identity.js";
+export { TPUF_DOC, TPUF_SCHEMA, TPUF_QUERY } from "./tpuf.js";
+/**
+ * Registry of backend codecs.
+ */
+export const ADAPTER_CODECS = {
+    turbopuffer: { doc: TPUF_DOC, schema: TPUF_SCHEMA, query: TPUF_QUERY },
+    pgvector: {
+        doc: IDENTITY_DOC,
+        schema: IDENTITY_SCHEMA,
+        query: IDENTITY_QUERY,
+    },
+};
+/**
+ * Default codecs (identity) for unknown backends.
+ */
+const DEFAULT_CODECS = {
+    doc: IDENTITY_DOC,
+    schema: IDENTITY_SCHEMA,
+    query: IDENTITY_QUERY,
+};
+/**
+ * Get codecs for a backend, falling back to identity.
+ */
+export function getAdapterCodecs(adapterId) {
+    return ADAPTER_CODECS[adapterId] ?? DEFAULT_CODECS;
+}

package/dist/memory/codecs/tpuf.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Turbopuffer backend codecs.
+ *
+ * Turbopuffer constraints:
+ * - Exactly one ANN vector field named "vector" per namespace.
+ *
+ * Memory model:
+ * - IndexMemoryRecord has modality-specific vectors: tvec, ivec, avec, vvec.
+ *
+ * Mapping:
+ * - tvec (text embedding) → vector
+ * - ivec/avec/vvec are dropped (not indexed in Turbopuffer)
+ */
+import type { Codec } from "@kernl-sdk/shared/lib";
+import type { FieldSchema, SearchQuery, UnknownDocument } from "@kernl-sdk/retrieval";
+import type { IndexMemoryRecord } from "../types.js";
+/**
+ * Turbopuffer document codec.
+ *
+ * Maps tvec → vector, drops ivec/avec/vvec.
+ */
+export declare const TPUF_DOC: Codec<IndexMemoryRecord, UnknownDocument>;
+/**
+ * Turbopuffer schema codec.
+ *
+ * Maps tvec → vector, drops ivec/avec/vvec fields.
+ */
+export declare const TPUF_SCHEMA: Codec<Record<string, FieldSchema>, Record<string, FieldSchema>>;
+/**
+ * Turbopuffer query codec.
+ *
+ * Maps tvec → vector in query signals, drops ivec/avec/vvec.
+ * Operates on normalized SearchQuery (after planQuery).
+ *
+ * Defaults include to true so memory searches return all document attributes.
+ */
+export declare const TPUF_QUERY: Codec<SearchQuery, SearchQuery>;
+//# sourceMappingURL=tpuf.d.ts.map

package/dist/memory/codecs/tpuf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tpuf.d.ts","sourceRoot":"","sources":["../../../src/memory/codecs/tpuf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAEX,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,iBAAiB,EAAE,eAAe,CAkB9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAC7B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAC3B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAmB5B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,WAAW,CA6BtD,CAAC"}

package/dist/memory/codecs/tpuf.js

@@ -0,0 +1,90 @@
+/**
+ * Turbopuffer backend codecs.
+ *
+ * Turbopuffer constraints:
+ * - Exactly one ANN vector field named "vector" per namespace.
+ *
+ * Memory model:
+ * - IndexMemoryRecord has modality-specific vectors: tvec, ivec, avec, vvec.
+ *
+ * Mapping:
+ * - tvec (text embedding) → vector
+ * - ivec/avec/vvec are dropped (not indexed in Turbopuffer)
+ */
+/**
+ * Turbopuffer document codec.
+ *
+ * Maps tvec → vector, drops ivec/avec/vvec.
+ */
+export const TPUF_DOC = {
+    encode(doc) {
+        const { tvec, ivec, avec, vvec, metadata, ...rest } = doc;
+        const row = {
+            ...rest,
+            metadata: metadata, // metadata is JSONObject | null, cast to FieldValue for UnknownDocument
+        };
+        if (tvec)
+            row.vector = tvec;
+        return row;
+    },
+    decode(row) {
+        const { vector, ...rest } = row;
+        return {
+            ...rest,
+            tvec: Array.isArray(vector) ? vector : undefined,
+        };
+    },
+};
+/**
+ * Turbopuffer schema codec.
+ *
+ * Maps tvec → vector, drops ivec/avec/vvec fields.
+ */
+export const TPUF_SCHEMA = {
+    encode(schema) {
+        const result = {};
+        for (const [name, field] of Object.entries(schema)) {
+            if (name === "tvec") {
+                result.vector = field;
+            }
+            else if (name === "ivec" || name === "avec" || name === "vvec") {
+                continue;
+            }
+            else {
+                result[name] = field;
+            }
+        }
+        return result;
+    },
+    decode() {
+        throw new Error("TPUF_SCHEMA.decode not implemented");
+    },
+};
+/**
+ * Turbopuffer query codec.
+ *
+ * Maps tvec → vector in query signals, drops ivec/avec/vvec.
+ * Operates on normalized SearchQuery (after planQuery).
+ *
+ * Defaults include to true so memory searches return all document attributes.
+ */
+export const TPUF_QUERY = {
+    encode(input) {
+        // default include to true for memory search (tpuf only returns id + score without it)
+        const include = input.include ?? true;
+        if (!input.query) {
+            return { ...input, include };
+        }
+        const signals = input.query.map((signal) => {
+            const { tvec, ivec, avec, vvec, ...rest } = signal;
+            if (tvec) {
+                return { ...rest, vector: tvec };
+            }
+            return rest;
+        });
+        return { ...input, query: signals, include };
+    },
+    decode() {
+        throw new Error("TPUF_QUERY.decode not implemented");
+    },
+};

package/dist/memory/encoder.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MemoryByte encoder - converts MemoryByte to IndexableByte with embeddings.
+ */
+import type { EmbeddingModel } from "@kernl-sdk/protocol";
+import type { MemoryByte, IndexableByte, MemoryByteCodec } from "./types.js";
+/**
+ * Encoder that converts MemoryByte to IndexableByte.
+ *
+ * Extracts canonical text from content and computes embeddings.
+ */
+export declare class MemoryByteEncoder implements MemoryByteCodec {
+    private readonly embedder;
+    constructor(embedder: EmbeddingModel<string>);
+    /**
+     * Encode a MemoryByte to IndexableByte.
+     * Extracts text and computes embeddings for each modality.
+     */
+    encode(byte: MemoryByte): Promise<IndexableByte>;
+    /**
+     * Decode is not implemented - IndexableByte cannot be converted back to MemoryByte.
+     */
+    decode(_indexable: IndexableByte): Promise<MemoryByte>;
+    /**
+     * Embed a text string.
+     * Exposed for query embedding.
+     */
+    embed(text: string): Promise<number[]>;
+}
+//# sourceMappingURL=encoder.d.ts.map

package/dist/memory/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/memory/encoder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;gBAEtC,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC;IAI5C;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBtD;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAI5D;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAI7C"}