kernl 0.6.2 → 0.7.0

package/dist/api/resources/threads/threads.d.ts

@@ -1,6 +1,6 @@
 import type { ThreadStore } from "../../../storage/index.js";
 import type { MThread, MThreadEvent } from "../../../api/models/index.js";
-import { CursorPage } from "../../../api/pagination/cursor.js";
+import { CursorPage } from "@kernl-sdk/shared";
 import { RThreadEvents } from "./events.js";
 import type { RThreadCreateParams, RThreadGetOptions, RThreadHistoryParams, RThreadsListParams, RThreadUpdateParams } from "./types.js";
 /**

package/dist/api/resources/threads/threads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/threads/threads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,WAAW,CAAC;AAOnB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAA2B,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAGjB;;;;GAIG;AACH,qBAAa,QAAQ;IAGP,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEF,KAAK,EAAE,WAAW;IAI/C;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAgB5E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqC3D;;;;;;;;;;;OAWG;IACG,IAAI,CACR,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAkDnD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;OAIG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,EAAE,CAAC;IAY1B;;;;;OAKG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAyD3B"}
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/threads/threads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,WAAW,CAAC;AAOnB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAA2B,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAGjB;;;;GAIG;AACH,qBAAa,QAAQ;IAGP,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEF,KAAK,EAAE,WAAW;IAI/C;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAgB5E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqC3D;;;;;;;;;;;OAWG;IACG,IAAI,CACR,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAkDnD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;OAIG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,EAAE,CAAC;IAY1B;;;;;OAKG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAyD3B"}

package/dist/api/resources/threads/threads.js

@@ -2,7 +2,7 @@ import { isPublicEvent } from "../../../thread/utils.js";
 import { Context } from "../../../context.js";
 import { randomID } from "@kernl-sdk/shared/lib";
 import { RUNNING } from "@kernl-sdk/protocol";
-import { CursorPage } from "../../../api/pagination/cursor.js";
+import { CursorPage } from "@kernl-sdk/shared";
 import { RThreadEvents } from "./events.js";
 import { MThreadCodec, ThreadsFilterCodec, ThreadsOrderCodec } from "./utils.js";
 /**

package/dist/api/resources/threads/types.d.ts

@@ -1,6 +1,6 @@
-import type { ThreadState } from "../../../types/thread.js";
+import type { ThreadState } from "../../../thread/types.js";
 import type { SortOrder } from "../../../storage/index.js";
-import type { CursorPageParams } from "../../../api/pagination/cursor.js";
+import type { CursorPageParams } from "@kernl-sdk/shared";
 export interface RThreadHistoryParams {
     /**
      * Only return events with seq greater than this value.

package/dist/api/resources/threads/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/threads/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,oBAAoB,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;OAEG;IACH,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE1C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/threads/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,oBAAoB,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;OAEG;IACH,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE1C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/dist/context.d.ts

@@ -1,7 +1,8 @@
+import type { Agent } from "./agent.js";
 /**
- * Status of a tool call approval.
+ * Context that is being passed around as part of the session is unknown
  */
-export type ApprovalStatus = "approved" | "rejected" | "pending";
+export type UnknownContext = unknown;
 /**
  * A propagation mechanism which carries execution-scoped values across API boundaries and between logically associated
  * execution units.
@@ -15,6 +16,11 @@ export declare class Context<TContext = UnknownContext> {
      * The inner context object.
      */
     context: TContext;
+    /**
+     * The agent executing this context.
+     * Set by the thread during execution.
+     */
+    agent?: Agent<TContext, any>;
     /**
      * Map of tool call IDs to their approval status.
      * (TEMPORARY) Used until the actions system is refined.
@@ -68,7 +74,7 @@ export declare class Context<TContext = UnknownContext> {
     };
 }
 /**
- * Context that is being passed around as part of the session is unknown
+ * Status of a tool call approval.
  */
-export type UnknownContext = unknown;
+export type ApprovalStatus = "approved" | "rejected" | "pending";
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjE;;;GAGG;AACH,qBAAa,OAAO,CAAC,QAAQ,GAAG,cAAc;IAC5C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC;IAMlB;;;OAGG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEvC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;gBAyB1B,SAAS,GAAE,MAAgB,EAC3B,OAAO,GAAE,QAAyB;IAUpC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM;IAevC;;;;;;;;;;;;;;OAcG;IACH,EAAE,IAAI,MAAM;IAIZ;;;;;;;;;;OAUG;IACH,IAAI,IAAI,MAAM;IAId,MAAM,IAAI;QACR,OAAO,EAAE,GAAG,CAAC;KAGd;CAsIF;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;AAErC;;;GAGG;AACH,qBAAa,OAAO,CAAC,QAAQ,GAAG,cAAc;IAC5C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAM7B;;;OAGG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEvC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;gBAwBhB,SAAS,GAAE,MAAgB,EAAE,OAAO,GAAE,QAAyB;IAS3E;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM;IAevC;;;;;;;;;;;;;;OAcG;IACH,EAAE,IAAI,MAAM;IAIZ;;;;;;;;;;OAUG;IACH,IAAI,IAAI,MAAM;IAId,MAAM,IAAI;QACR,OAAO,EAAE,GAAG,CAAC;KAGd;CAOF;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC"}

package/dist/context.js

@@ -11,6 +11,11 @@ export class Context {
      * The inner context object.
      */
     context;
+    /**
+     * The agent executing this context.
+     * Set by the thread during execution.
+     */
+    agent;
     // ----------------------
     // TEMPORARY: Tool approval tracking until actions system is refined
     // ----------------------

package/dist/guardrail.d.ts

@@ -2,8 +2,8 @@ import { z, type ZodType } from "zod";
 import { LanguageModelResponse } from "@kernl-sdk/protocol";
 import { Agent } from "./agent.js";
 import { Context, UnknownContext } from "./context.js";
-import type { AgentResponseType } from "./types/agent.js";
-import type { TextResponse, ThreadEvent } from "./types/thread.js";
+import type { AgentResponseType } from "./agent/types.js";
+import type { TextResponse, ThreadEvent } from "./thread/types.js";
 /**
  * Resolves the agent output type based on the response type.
  * - If TResponse is "text" → output is string

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { Kernl } from "./kernl.js";
-export type { KernlOptions, StorageOptions, AgentRegistry, ModelRegistry, } from "./types/kernl.js";
+export { Kernl } from "./kernl/index.js";
+export type { KernlOptions, StorageOptions, AgentRegistry, ModelRegistry, } from "./kernl/index.js";
 export { Agent } from "./agent.js";
 export { Context } from "./context.js";
 export { tool, Toolkit, FunctionToolkit, MCPToolkit } from "./tool/index.js";
@@ -8,6 +8,8 @@ export { MCPServerStdio } from "./mcp/stdio.js";
 export { MCPServerStreamableHttp } from "./mcp/http.js";
 export type { MThread as Thread, MThreadEvent as ThreadEvent, MThreadEventBase as ThreadEventBase, } from "./api/models/index.js";
 export type { RThreadsListParams as ThreadsListParams, RThreadGetOptions as ThreadGetOptions, RThreadHistoryParams as ThreadHistoryParams, RThreadCreateParams as ThreadCreateParams, RThreadUpdateParams as ThreadUpdateParams, } from "./api/resources/threads/index.js";
-export { THREAD_STATES, type ThreadState, type PublicThreadEvent, } from "./types/thread.js";
+export { THREAD_STATES, type ThreadState, type PublicThreadEvent, } from "./thread/types.js";
 export type { ThreadStore, NewThread, ThreadUpdate, ThreadFilter, ThreadHistoryOptions, ThreadInclude, ThreadListOptions, SortOrder, KernlStorage, Transaction, } from "./storage/index.js";
+export { Memory, MemoryByteEncoder } from "./memory/index.js";
+export type { MemoryStore, MemoryScope, NewMemory, MemoryConfig, MemoryReindexParams, MemoryRecord, MemoryKind, MemoryRecordUpdate, MemoryFilter, MemoryListOptions, MemorySearchQuery, WorkingMemorySnapshot, ShortTermMemorySnapshot, MemoryIndexBase, MemorySearchIndex, MemoryGraphIndex, MemoryArchiveIndex, GraphTraversalQuery, GraphTraversalResult, ArchiveQuery, ArchiveResult, MemoryByte, MemoryByteCodec, } from "./memory/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGrD,YAAY,EACV,OAAO,IAAI,MAAM,EACjB,YAAY,IAAI,WAAW,EAC3B,gBAAgB,IAAI,eAAe,GACpC,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,kBAAkB,IAAI,iBAAiB,EACvC,iBAAiB,IAAI,gBAAgB,EACrC,oBAAoB,IAAI,mBAAmB,EAC3C,mBAAmB,IAAI,kBAAkB,EACzC,mBAAmB,IAAI,kBAAkB,GAC1C,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAIrD,YAAY,EACV,OAAO,IAAI,MAAM,EACjB,YAAY,IAAI,WAAW,EAC3B,gBAAgB,IAAI,eAAe,GACpC,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,IAAI,iBAAiB,EACvC,iBAAiB,IAAI,gBAAgB,EACrC,oBAAoB,IAAI,mBAAmB,EAC3C,mBAAmB,IAAI,kBAAkB,EACzC,mBAAmB,IAAI,kBAAkB,GAC1C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-export { Kernl } from "./kernl.js";
+export { Kernl } from "./kernl/index.js";
 export { Agent } from "./agent.js";
 export { Context } from "./context.js";
 // --- tools --
@@ -6,5 +6,6 @@ export { tool, Toolkit, FunctionToolkit, MCPToolkit } from "./tool/index.js";
 export { MCPServerSSE } from "./mcp/sse.js";
 export { MCPServerStdio } from "./mcp/stdio.js";
 export { MCPServerStreamableHttp } from "./mcp/http.js";
-// --- thread state enums ---
-export { THREAD_STATES, } from "./types/thread.js";
+export { THREAD_STATES, } from "./thread/types.js";
+// --- memory ---
+export { Memory, MemoryByteEncoder } from "./memory/index.js";

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
 export { Thread } from "./thread/thread.js";
-export type { IThread, ThreadEvent, ThreadEventBase, ThreadEventInner, ThreadSystemEvent, ThreadState, PublicThreadEvent, } from "./types/thread.js";
-export { THREAD_STATES } from "./types/thread.js";
+export type { IThread, ThreadEvent, ThreadEventBase, ThreadEventInner, ThreadSystemEvent, ThreadState, PublicThreadEvent, } from "./thread/types.js";
+export { THREAD_STATES } from "./thread/types.js";
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.js

@@ -1,2 +1,2 @@
 export { Thread } from "./thread/thread.js";
-export { THREAD_STATES } from "./types/thread.js";
+export { THREAD_STATES } from "./thread/types.js";

package/dist/kernl/index.d.ts

@@ -1,3 +1,3 @@
 export { Kernl } from "./kernl.js";
-export { ThreadsResource, type ThreadsListParams, type ThreadGetOptions } from "./threads.js";
+export type { KernlOptions, StorageOptions, MemoryOptions, AgentRegistry, ModelRegistry, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kernl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kernl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/kernl/index.js

@@ -1,2 +1 @@
 export { Kernl } from "./kernl.js";
-export { ThreadsResource } from "./threads.js";

package/dist/kernl/kernl.d.ts

@@ -4,10 +4,12 @@ import { KernlHooks } from "../lifecycle.js";
 import type { Thread } from "../thread/index.js";
 import type { ResolvedAgentResponse } from "../guardrail.js";
 import { type KernlStorage } from "../storage/index.js";
-import type { KernlOptions } from "../types/kernl.js";
-import type { ThreadExecuteResult, ThreadStreamEvent } from "../types/thread.js";
-import type { AgentResponseType } from "../types/agent.js";
-import { ThreadsResource } from "./threads.js";
+import { RThreads } from "../api/resources/threads/index.js";
+import { RAgents } from "../api/resources/agents/index.js";
+import { Memory } from "../memory/index.js";
+import type { ThreadExecuteResult, ThreadStreamEvent } from "../thread/types.js";
+import type { AgentResponseType } from "../agent/types.js";
+import type { KernlOptions } from "./types.js";
 /**
  * The kernl - manages agent processes, scheduling, and task lifecycle.
  *
@@ -15,16 +17,13 @@ import { ThreadsResource } from "./threads.js";
  * tracing.
  */
 export declare class Kernl extends KernlHooks<UnknownContext, AgentResponseType> {
-    private agents;
-    private models;
+    private readonly _agents;
+    private readonly _models;
     readonly storage: KernlStorage;
     athreads: Map<string, Thread<any, any>>;
-    private initPromise;
-    /**
-     * Thread management API.
-     * Provides methods to get, list, and delete threads.
-     */
-    readonly threads: ThreadsResource;
+    readonly threads: RThreads;
+    readonly agents: RAgents;
+    readonly memories: Memory;
     constructor(options?: KernlOptions);
     /**
      * Registers a new agent with the kernl instance.
@@ -52,13 +51,5 @@ export declare class Kernl extends KernlHooks<UnknownContext, AgentResponseType>
      * Schedule an existing thread - streaming execution
      */
     scheduleStream<TContext, TResponse extends AgentResponseType>(thread: Thread<TContext, TResponse>): AsyncIterable<ThreadStreamEvent>;
-    /**
-     * Ensure the underlying storage backend has been initialized.
-     *
-     * This is called lazily on first use so that callers do not need to worry
-     * about calling storage.init() themselves. Safe and idempotent to call
-     * multiple times; concurrent calls share the same initialization promise.
-     */
-    private ensureInitialized;
 }
 //# sourceMappingURL=kernl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC;IACtE,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAAyC;IAEvD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAa;IAEpD,OAAO,CAAC,WAAW,CAA8B;IAEjD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEtB,OAAO,GAAE,YAAiB;IAOtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAa5B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EACvD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;IAUjE;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;IAUjE;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EAC9D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,aAAa,CAAC,iBAAiB,CAAC;IAUnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EACjE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,aAAa,CAAC,iBAAiB,CAAC;IAUnC;;;;;;OAMG;YACW,iBAAiB;CAWhC"}
+{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EACL,MAAM,EAIP,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAa;IAGpD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAoCtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAa5B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EACvD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;IASjE;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;IASjE;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EAC9D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,aAAa,CAAC,iBAAiB,CAAC;IASnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EACjE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,aAAa,CAAC,iBAAiB,CAAC;CAQpC"}

package/dist/kernl/kernl.js

@@ -1,6 +1,9 @@
+import { resolveEmbeddingModel } from "@kernl-sdk/retrieval";
 import { KernlHooks } from "../lifecycle.js";
 import { InMemoryStorage } from "../storage/index.js";
-import { ThreadsResource } from "./threads.js";
+import { RThreads } from "../api/resources/threads/index.js";
+import { RAgents } from "../api/resources/agents/index.js";
+import { Memory, MemoryByteEncoder, MemoryIndexHandle, buildMemoryIndexSchema, } from "../memory/index.js";
 /**
  * The kernl - manages agent processes, scheduling, and task lifecycle.
  *
@@ -8,41 +11,61 @@ import { ThreadsResource } from "./threads.js";
  * tracing.
  */
 export class Kernl extends KernlHooks {
-    agents = new Map();
-    models = new Map();
+    _agents = new Map();
+    _models = new Map();
     storage;
     athreads = new Map(); /* active threads */
-    initPromise = null;
-    /**
-     * Thread management API.
-     * Provides methods to get, list, and delete threads.
-     */
+    // --- public API ---
     threads;
+    agents;
+    memories;
     constructor(options = {}) {
         super();
         this.storage = options.storage?.db ?? new InMemoryStorage();
-        this.storage.bind({ agents: this.agents, models: this.models });
-        this.threads = new ThreadsResource(this.storage.threads);
+        this.storage.bind({ agents: this._agents, models: this._models });
+        this.threads = new RThreads(this.storage.threads);
+        this.agents = new RAgents(this._agents);
+        // initialize memory
+        const embeddingModel = options.memory?.embeddingModel ?? "openai/text-embedding-3-small";
+        const embedder = typeof embeddingModel === "string"
+            ? resolveEmbeddingModel(embeddingModel)
+            : embeddingModel;
+        const encoder = new MemoryByteEncoder(embedder);
+        const vector = options.storage?.vector;
+        const indexId = options.memory?.indexId ?? "memories_sindex";
+        const dimensions = options.memory?.dimensions ?? 1536;
+        const providerOptions = options.memory?.indexProviderOptions ?? { schema: "kernl" };
+        this.memories = new Memory({
+            store: this.storage.memories,
+            search: vector !== undefined
+                ? new MemoryIndexHandle({
+                    index: vector,
+                    indexId,
+                    schema: buildMemoryIndexSchema({ dimensions }),
+                    providerOptions,
+                })
+                : undefined,
+            encoder,
+        });
     }
     /**
      * Registers a new agent with the kernl instance.
      */
     register(agent) {
-        this.agents.set(agent.id, agent);
+        this._agents.set(agent.id, agent);
         agent.bind(this);
         // (TODO): implement exhaustive model registry in protocol/ package
         //
         // auto-populate model registry for storage hydration
         const key = `${agent.model.provider}/${agent.model.modelId}`;
-        if (!this.models.has(key)) {
-            this.models.set(key, agent.model);
+        if (!this._models.has(key)) {
+            this._models.set(key, agent.model);
         }
     }
     /**
      * Spawn a new thread - blocking execution
      */
     async spawn(thread) {
-        await this.ensureInitialized();
         this.athreads.set(thread.tid, thread);
         try {
             return await thread.execute();
@@ -57,7 +80,6 @@ export class Kernl extends KernlHooks {
      * NOTE: just blocks for now
      */
     async schedule(thread) {
-        await this.ensureInitialized();
         this.athreads.set(thread.tid, thread);
         try {
             return await thread.execute();
@@ -72,7 +94,6 @@ export class Kernl extends KernlHooks {
      * Spawn a new thread - streaming execution
      */
     async *spawnStream(thread) {
-        await this.ensureInitialized();
         this.athreads.set(thread.tid, thread);
         try {
             yield* thread.stream();
@@ -87,7 +108,6 @@ export class Kernl extends KernlHooks {
      * Schedule an existing thread - streaming execution
      */
     async *scheduleStream(thread) {
-        await this.ensureInitialized();
         this.athreads.set(thread.tid, thread);
         try {
             yield* thread.stream();
@@ -96,21 +116,4 @@ export class Kernl extends KernlHooks {
             this.athreads.delete(thread.tid);
         }
     }
-    /**
-     * Ensure the underlying storage backend has been initialized.
-     *
-     * This is called lazily on first use so that callers do not need to worry
-     * about calling storage.init() themselves. Safe and idempotent to call
-     * multiple times; concurrent calls share the same initialization promise.
-     */
-    async ensureInitialized() {
-        if (!this.initPromise) {
-            this.initPromise = this.storage.init().catch((error) => {
-                // Allow a retry if initialization fails.
-                this.initPromise = null;
-                throw error;
-            });
-        }
-        await this.initPromise;
-    }
 }

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");
+    },
+};