kernl 0.6.2 → 0.6.3

package/dist/memory/schema.js

@@ -0,0 +1,112 @@
+/**
+ * Memory index schema builder.
+ */
+/**
+ * Build a canonical memory index schema for vector search.
+ *
+ * Returns a schema Record that can be used with SearchIndex.createIndex().
+ *
+ * Schema includes all fields from IndexMemoryRecord:
+ * - id: primary key
+ * - namespace, entityId, agentId: scope fields (filterable, nullable)
+ * - kind, collection: memory attributes (filterable)
+ * - timestamp, createdAt, updatedAt: timestamps (filterable + sortable)
+ * - text: content text (full-text search)
+ * - tvec, ivec, avec, vvec: vector embeddings for text/image/audio/video
+ * - metadata: structured metadata (object)
+ *
+ * @example
+ * ```ts
+ * const schema = buildMemoryIndexSchema({ dimensions: 1536 });
+ * const handle = new MemoryIndexHandle({ index: vector, indexId: "kernl_memories", schema });
+ * ```
+ */
+export function buildMemoryIndexSchema(options = {}) {
+    const dimensions = options.dimensions ?? 1536;
+    const similarity = options.similarity ?? "cosine";
+    const schema = {
+        id: {
+            type: "string",
+            pk: true,
+            sortable: true,
+        },
+        // scope fields (filterable, nullable)
+        namespace: {
+            type: "string",
+            filterable: true,
+            optional: true,
+        },
+        entityId: {
+            type: "string",
+            filterable: true,
+            optional: true,
+        },
+        agentId: {
+            type: "string",
+            filterable: true,
+            optional: true,
+        },
+        // memory attributes (filterable)
+        kind: {
+            type: "string",
+            filterable: true,
+        },
+        collection: {
+            type: "string",
+            filterable: true,
+        },
+        // timestamps (filterable + sortable) - store as bigint to safely handle
+        // millisecond Unix epoch values without overflow in SQL backends.
+        timestamp: {
+            type: "bigint",
+            filterable: true,
+            sortable: true,
+        },
+        createdAt: {
+            type: "bigint",
+            filterable: true,
+            sortable: true,
+        },
+        updatedAt: {
+            type: "bigint",
+            filterable: true,
+            sortable: true,
+        },
+        // content fields
+        text: {
+            type: "string",
+            fts: true,
+            optional: true,
+        },
+        // vector fields for different modalities
+        tvec: {
+            type: "vector",
+            dimensions,
+            similarity,
+            optional: true,
+        },
+        ivec: {
+            type: "vector",
+            dimensions,
+            similarity,
+            optional: true,
+        },
+        avec: {
+            type: "vector",
+            dimensions,
+            similarity,
+            optional: true,
+        },
+        vvec: {
+            type: "vector",
+            dimensions,
+            similarity,
+            optional: true,
+        },
+        metadata: {
+            type: "object",
+            optional: true,
+        },
+    };
+    return schema;
+}

package/dist/memory/store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Memory store interface.
+ */
+import type { MemoryRecord, NewMemory, MemoryRecordUpdate, MemoryListOptions } from "./types.js";
+/**
+ * Memory persistence store.
+ *
+ * Follows the same pattern as ThreadStore - simple CRUD operations.
+ */
+export interface MemoryStore {
+    /**
+     * Get a memory by ID.
+     */
+    get(id: string): Promise<MemoryRecord | null>;
+    /**
+     * List memories matching the filter.
+     */
+    list(options?: MemoryListOptions): Promise<MemoryRecord[]>;
+    /**
+     * Create a new memory.
+     */
+    create(memory: NewMemory): Promise<MemoryRecord>;
+    /**
+     * Update an existing memory.
+     */
+    update(id: string, patch: MemoryRecordUpdate): Promise<MemoryRecord>;
+    /**
+     * Delete a memory.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Delete multiple memories.
+     */
+    mdelete(ids: string[]): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE3D;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjD;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAErE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/memory/store.js

@@ -0,0 +1,4 @@
+/**
+ * Memory store interface.
+ */
+export {};

package/dist/memory/types.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Memory types.
+ */
+import type { JSONObject } from "@kernl-sdk/protocol";
+import type { AsyncCodec } from "@kernl-sdk/shared/lib";
+import type { IndexHandle } from "@kernl-sdk/retrieval";
+import type { MemoryStore } from "./store.js";
+export type TextByte = string;
+/**
+ * Image content.
+ *
+ * NOTE: Parallels @kernl-sdk/protocol's FilePart type.
+ * @see packages/protocol/src/language-model/item.ts
+ */
+export interface ImageByte {
+    data: Uint8Array | string;
+    mime: string;
+    alt?: string;
+}
+/**
+ * Audio content.
+ */
+export interface AudioByte {
+    data: Uint8Array | string;
+    mime: string;
+}
+/**
+ * Video content.
+ */
+export interface VideoByte {
+    data: Uint8Array | string;
+    mime: string;
+}
+/**
+ * Memory content - the smallest coherent unit of memory.
+ *
+ * May contain multiple modalities (e.g., captioned image, video with transcript).
+ * At most one of each modality type.
+ */
+export interface MemoryByte {
+    text?: TextByte;
+    image?: ImageByte;
+    audio?: AudioByte;
+    video?: VideoByte;
+    object?: JSONObject;
+}
+/**
+ * Search-ready projection of a MemoryByte.
+ *
+ * Contains canonical text plus embeddings for each modality.
+ */
+export interface IndexableByte {
+    text?: string;
+    tvec?: number[];
+    ivec?: number[];
+    avec?: number[];
+    vvec?: number[];
+    metadata?: JSONObject | null;
+}
+/**
+ * Encoder that converts MemoryByte to IndexableByte with embeddings.
+ */
+export interface MemoryByteCodec extends AsyncCodec<MemoryByte, IndexableByte> {
+    embed(text: string): Promise<number[]>;
+}
+export interface MemoryConfig {
+    store: MemoryStore;
+    search?: IndexHandle<IndexMemoryRecord>;
+    /** Encoder for converting MemoryByte to IndexableByte with embeddings. */
+    encoder: MemoryByteCodec;
+}
+/**
+ * Working memory snapshot (L1).
+ */
+export interface WorkingMemorySnapshot {
+    scope: MemoryScope;
+    records: MemoryRecord[];
+}
+/**
+ * Short-term memory snapshot (L2).
+ */
+export interface ShortTermMemorySnapshot {
+    scope: MemoryScope;
+    records: MemoryRecord[];
+}
+/**
+ * Memory scope - identifies who/what this memory belongs to.
+ */
+export interface MemoryScope {
+    namespace?: string;
+    entityId?: string;
+    agentId?: string;
+}
+/**
+ * Memory kind - episodic (events/experiences) or semantic (facts/knowledge).
+ */
+export type MemoryKind = "episodic" | "semantic";
+/**
+ * Input for creating a new memory.
+ */
+export interface NewMemory {
+    id: string;
+    scope: MemoryScope;
+    kind: MemoryKind;
+    collection: string;
+    content: MemoryByte;
+    wmem?: boolean;
+    smem?: {
+        expiresAt: number | null;
+    };
+    timestamp?: number;
+    metadata?: JSONObject | null;
+}
+/**
+ * Simplified input for agent-scoped memory creation.
+ *
+ * Sugar over NewMemory with:
+ * - id auto-generated if not provided
+ * - scope fields flattened (namespace, entityId) - agentId is implicit
+ * - kind defaults to "semantic"
+ */
+export interface AgentMemoryCreate {
+    id?: string;
+    namespace?: string;
+    entityId?: string;
+    collection: string;
+    content: MemoryByte;
+    wmem?: boolean;
+    smem?: {
+        expiresAt: number | null;
+    };
+    timestamp?: number;
+    metadata?: JSONObject | null;
+}
+/**
+ * Base memory record fields.
+ */
+interface BaseMemoryRecord {
+    id: string;
+    scope: MemoryScope;
+    kind: MemoryKind;
+    collection: string;
+    content: MemoryByte;
+    wmem: boolean;
+    smem: {
+        expiresAt: number | null;
+    };
+    timestamp: number;
+    createdAt: number;
+    updatedAt: number;
+    metadata: JSONObject | null;
+}
+/**
+ * Episodic memory - events, experiences, conversations.
+ */
+export interface EpisodicMemoryRecord extends BaseMemoryRecord {
+    kind: "episodic";
+}
+/**
+ * Semantic memory - facts, knowledge, learned information.
+ */
+export interface SemanticMemoryRecord extends BaseMemoryRecord {
+    kind: "semantic";
+}
+/**
+ * A persisted memory record.
+ */
+export type MemoryRecord = EpisodicMemoryRecord | SemanticMemoryRecord;
+/**
+ * Update payload for a memory record.
+ */
+export interface MemoryRecordUpdate {
+    id: string;
+    scope?: MemoryScope;
+    collection?: string;
+    content?: MemoryByte;
+    wmem?: boolean;
+    smem?: {
+        expiresAt: number | null;
+    };
+    timestamp?: number;
+    updatedAt?: number;
+    metadata?: JSONObject | null;
+}
+/**
+ * Filter for listing memories.
+ */
+export interface MemoryFilter {
+    scope?: Partial<MemoryScope>;
+    collections?: string[];
+    wmem?: boolean;
+    smem?: boolean;
+    after?: number;
+    before?: number;
+    metadata?: JSONObject;
+}
+/**
+ * Options for listing memories.
+ */
+export interface MemoryListOptions {
+    filter?: MemoryFilter;
+    limit?: number;
+    offset?: number;
+    order?: "asc" | "desc";
+}
+/**
+ * Query for semantic memory search.
+ */
+export interface MemorySearchQuery {
+    query: string;
+    filter?: MemoryFilter;
+    limit?: number;
+}
+/**
+ * Params for triggering reindexing of a memory record.
+ */
+export interface MemoryReindexParams {
+    id: string;
+    indexes?: ("search" | "graph" | "archive")[];
+}
+/**
+ * Flat document for search indexes.
+ */
+export interface IndexMemoryRecord extends IndexableByte {
+    id: string;
+    namespace: string | null;
+    entityId: string | null;
+    agentId: string | null;
+    kind: MemoryKind;
+    collection: string;
+    timestamp: number;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Patch payload for updating an IndexMemoryRecord.
+ * Content changes require full re-index, not a patch.
+ */
+export interface IndexMemoryRecordPatch {
+    id: string;
+    namespace?: string | null;
+    entityId?: string | null;
+    agentId?: string | null;
+    collection?: string;
+    timestamp?: number;
+    updatedAt?: number;
+    metadata?: JSONObject | null;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/memory/types.js

@@ -0,0 +1,4 @@
+/**
+ * Memory types.
+ */
+export {};

package/dist/storage/base.d.ts

@@ -1,8 +1,9 @@
 /**
  * Core storage contracts.
  */
-import type { AgentRegistry, ModelRegistry } from "../types/kernl.js";
+import type { AgentRegistry, ModelRegistry } from "../kernl/types.js";
 import type { ThreadStore } from "./thread.js";
+import type { MemoryStore } from "../memory/store.js";
 /**
  * The main storage interface for Kernl.
  *
@@ -13,6 +14,10 @@ export interface KernlStorage {
      * Thread store - manages thread execution records and event history.
      */
     threads: ThreadStore;
+    /**
+     * Memory store - manages memory records for agents.
+     */
+    memories: MemoryStore;
     /**
      * Bind runtime registries to storage.
      *

package/dist/storage/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/storage/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAKrB;;;;OAIG;IACH,IAAI,CAAC,UAAU,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI,CAAC;IAEzE;;;;;OAKG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhE;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAMrB;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/storage/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC;IAKtB;;;;OAIG;IACH,IAAI,CAAC,UAAU,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI,CAAC;IAEzE;;;;;OAKG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhE;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAMrB;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/storage/in-memory.d.ts

@@ -7,13 +7,15 @@
  */
 import { Thread } from "../thread/index.js";
 import type { KernlStorage, Transaction, ThreadStore, NewThread, ThreadUpdate, ThreadInclude, ThreadListOptions, ThreadHistoryOptions } from "../storage/index.js";
-import type { ThreadEvent } from "../types/thread.js";
-import type { AgentRegistry, ModelRegistry } from "../types/kernl.js";
+import type { ThreadEvent } from "../thread/types.js";
+import type { AgentRegistry, ModelRegistry } from "../kernl/types.js";
+import type { MemoryStore, MemoryRecord, NewMemory, MemoryRecordUpdate, MemoryListOptions } from "../memory/index.js";
 /**
  * In-memory storage implementation.
  */
 export declare class InMemoryStorage implements KernlStorage {
     threads: InMemoryThreadStore;
+    memories: InMemoryMemoryStore;
     constructor();
     bind(registries: {
         agents: AgentRegistry;
@@ -59,4 +61,24 @@ export declare class InMemoryThreadStore implements ThreadStore {
      */
     private applySorting;
 }
+/**
+ * In-memory memory store implementation.
+ */
+export declare class InMemoryMemoryStore implements MemoryStore {
+    private memories;
+    get(id: string): Promise<MemoryRecord | null>;
+    list(options?: MemoryListOptions): Promise<MemoryRecord[]>;
+    create(memory: NewMemory): Promise<MemoryRecord>;
+    update(id: string, patch: MemoryRecordUpdate): Promise<MemoryRecord>;
+    delete(id: string): Promise<void>;
+    mdelete(ids: string[]): Promise<void>;
+    /**
+     * Apply filters to memory list.
+     */
+    private applyFilters;
+    /**
+     * Apply sorting to memory list.
+     */
+    private applySorting;
+}
 //# sourceMappingURL=in-memory.d.ts.map

package/dist/storage/in-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/storage/in-memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKlC,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EAGrB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAElE;;GAEG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,EAAE,mBAAmB,CAAC;;IAM7B,IAAI,CAAC,UAAU,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI;IAIlE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAM/D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAmBD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,UAAU,CACX;IAEP,IAAI,CAAC,UAAU,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI;IAIlE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAejE,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2BpD,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB1C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,OAAO,CACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC;IAInB,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BlD;;OAEG;IACH,OAAO,CAAC,OAAO;IAgCf;;OAEG;IACH,OAAO,CAAC,aAAa;IAyCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2CpB;;OAEG;IACH,OAAO,CAAC,YAAY;CA6BrB"}
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/storage/in-memory.ts"],"names":[],"mappings":"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"}

package/dist/storage/in-memory.js

@@ -14,8 +14,10 @@ import { UnimplementedError } from "@kernl-sdk/shared/lib";
  */
 export class InMemoryStorage {
     threads;
+    memories;
     constructor() {
         this.threads = new InMemoryThreadStore();
+        this.memories = new InMemoryMemoryStore();
     }
     bind(registries) {
         this.threads.bind(registries);
@@ -281,3 +283,132 @@ export class InMemoryThreadStore {
         });
     }
 }
+/**
+ * In-memory memory store implementation.
+ */
+export class InMemoryMemoryStore {
+    memories = new Map();
+    async get(id) {
+        return this.memories.get(id) ?? null;
+    }
+    async list(options) {
+        let records = Array.from(this.memories.values());
+        // Apply filters
+        if (options?.filter) {
+            records = this.applyFilters(records, options.filter);
+        }
+        // Apply sorting
+        records = this.applySorting(records, options?.order);
+        // Apply pagination
+        if (options?.offset)
+            records = records.slice(options.offset);
+        if (options?.limit)
+            records = records.slice(0, options.limit);
+        return records;
+    }
+    async create(memory) {
+        const now = Date.now();
+        const record = {
+            id: memory.id,
+            scope: memory.scope,
+            kind: memory.kind,
+            collection: memory.collection,
+            content: memory.content,
+            wmem: memory.wmem ?? false,
+            smem: memory.smem ?? { expiresAt: null },
+            timestamp: memory.timestamp ?? now,
+            createdAt: now,
+            updatedAt: now,
+            metadata: memory.metadata ?? null,
+        };
+        this.memories.set(memory.id, record);
+        return record;
+    }
+    async update(id, patch) {
+        const record = this.memories.get(id);
+        if (!record)
+            throw new Error(`Memory ${id} not found`);
+        const updated = {
+            ...record,
+            ...(patch.scope && { scope: patch.scope }),
+            ...(patch.collection && { collection: patch.collection }),
+            ...(patch.content && { content: patch.content }),
+            ...(patch.wmem !== undefined && { wmem: patch.wmem }),
+            ...(patch.smem && { smem: patch.smem }),
+            ...(patch.timestamp && { timestamp: patch.timestamp }),
+            ...(patch.metadata !== undefined && { metadata: patch.metadata }),
+            updatedAt: patch.updatedAt ?? Date.now(),
+        };
+        this.memories.set(id, updated);
+        return updated;
+    }
+    async delete(id) {
+        this.memories.delete(id);
+    }
+    async mdelete(ids) {
+        for (const id of ids) {
+            this.memories.delete(id);
+        }
+    }
+    /**
+     * Apply filters to memory list.
+     */
+    applyFilters(records, filter) {
+        return records.filter((record) => {
+            // Filter by scope
+            if (filter.scope) {
+                if (filter.scope.namespace !== undefined &&
+                    record.scope.namespace !== filter.scope.namespace) {
+                    return false;
+                }
+                if (filter.scope.entityId !== undefined &&
+                    record.scope.entityId !== filter.scope.entityId) {
+                    return false;
+                }
+                if (filter.scope.agentId !== undefined &&
+                    record.scope.agentId !== filter.scope.agentId) {
+                    return false;
+                }
+            }
+            // Filter by collections
+            if (filter.collections && !filter.collections.includes(record.collection)) {
+                return false;
+            }
+            // Filter by wmem
+            if (filter.wmem !== undefined && record.wmem !== filter.wmem) {
+                return false;
+            }
+            // Filter by smem
+            if (filter.smem !== undefined) {
+                const hasSmem = record.smem.expiresAt !== null;
+                if (filter.smem !== hasSmem)
+                    return false;
+            }
+            // Filter by timestamp range
+            if (filter.after !== undefined && record.timestamp <= filter.after) {
+                return false;
+            }
+            if (filter.before !== undefined && record.timestamp >= filter.before) {
+                return false;
+            }
+            // Filter by metadata (simple equality check for now)
+            if (filter.metadata) {
+                const recordMeta = record.metadata ?? {};
+                for (const [key, value] of Object.entries(filter.metadata)) {
+                    if (recordMeta[key] !== value)
+                        return false;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Apply sorting to memory list.
+     */
+    applySorting(records, order) {
+        return records.sort((a, b) => {
+            const diff = a.timestamp - b.timestamp;
+            return order === "desc" ? -diff : diff;
+        });
+    }
+}

package/dist/storage/thread.d.ts

@@ -3,7 +3,7 @@
  */
 import type { Thread } from "../thread/index.js";
 import type { Context } from "../context.js";
-import type { ThreadEvent, ThreadState } from "../types/thread.js";
+import type { ThreadEvent, ThreadState } from "../thread/types.js";
 /**
  * Thread persistence store.
  */

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

@@ -3,7 +3,7 @@ import { z } from "zod";
 import { openai } from "@ai-sdk/openai";
 import { AISDKLanguageModel } from "@kernl-sdk/ai";
 import { Agent } from "../../agent.js";
-import { Kernl } from "../../kernl.js";
+import { Kernl } from "../../kernl/index.js";
 import { tool, Toolkit } from "../../tool/index.js";
 import { Thread } from "../thread.js";
 /**

package/dist/thread/__tests__/mock.d.ts

@@ -1,5 +1,5 @@
 import { LanguageModel, LanguageModelRequest, LanguageModelResponse } from "@kernl-sdk/protocol";
-import type { ThreadStreamEvent } from "../../types/thread.js";
+import type { ThreadStreamEvent } from "../../thread/types.js";
 /**
  * A mock language model that echoes the user input back as an assistant message.
  * Useful for testing the execution flow without calling a real LLM.