kernl 0.6.2 → 0.6.3

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

@@ -1,7 +1,7 @@
 import { describe, it, expect } from "vitest";
 import { Thread } from "../thread.js";
 import { Agent } from "../../agent.js";
-import { Kernl } from "../../kernl.js";
+import { Kernl } from "../../kernl/index.js";
 import { InMemoryStorage } from "../../storage/in-memory.js";
 import { createMockModel } from "./fixtures/mock-model.js";
 // Helper to create user message input

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

@@ -3,7 +3,7 @@ import { z } from "zod";
 import { IN_PROGRESS, COMPLETED, FAILED } from "@kernl-sdk/protocol";
 import { Thread } from "../thread.js";
 import { Agent } from "../../agent.js";
-import { Kernl } from "../../kernl.js";
+import { Kernl } from "../../kernl/index.js";
 import { tool, FunctionToolkit } from "../../tool/index.js";
 import { ModelBehaviorError } from "../../lib/error.js";
 import { createMockModel } from "./fixtures/mock-model.js";

package/dist/thread/thread.d.ts

@@ -3,8 +3,8 @@ import { Context } from "../context.js";
 import type { Task } from "../task.js";
 import type { ResolvedAgentResponse } from "../guardrail.js";
 import { LanguageModel } from "@kernl-sdk/protocol";
-import type { ThreadEvent, ThreadState, ThreadOptions, ThreadEventInner, ThreadStreamEvent, ThreadExecuteResult } from "../types/thread.js";
-import type { AgentResponseType } from "../types/agent.js";
+import type { ThreadEvent, ThreadState, ThreadOptions, ThreadEventInner, ThreadStreamEvent, ThreadExecuteResult } from "./types.js";
+import type { AgentResponseType } from "../agent/types.js";
 /**
  * A thread drives the execution loop for an agent.
  *

package/dist/thread/thread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/thread/thread.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKzD,OAAO,EAML,aAAa,EAGd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAEV,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,MAAM,CACjB,QAAQ,GAAG,OAAO,EAClB,SAAS,SAAS,iBAAiB,GAAG,MAAM;IAE5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAIlD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,OAAO,CAAwE;IAEvF,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAc;gBAElB,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC;IA+BvD;;OAEG;IACG,OAAO,IAAI,OAAO,CACtB,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CACtD;IAoBD;;OAEG;IACI,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAuBjD;;;;;OAKG;YACY,QAAQ;IAgEvB;;;;;OAKG;YACY,IAAI;IA8BnB;;;;;OAKG;YACW,UAAU;IAuCxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE;IAiBnD;;OAEG;IACH,MAAM;IAQN;;OAEG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,YAAY;IA2C1B;;OAEG;YACW,mBAAmB;CA2ClC"}
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/thread/thread.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKzD,OAAO,EAML,aAAa,EAGd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAEV,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,MAAM,CACjB,QAAQ,GAAG,OAAO,EAClB,SAAS,SAAS,iBAAiB,GAAG,MAAM;IAE5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAIlD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,OAAO,CAAwE;IAEvF,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAc;gBAElB,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC;IA+BvD;;OAEG;IACG,OAAO,IAAI,OAAO,CACtB,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CACtD;IAoBD;;OAEG;IACI,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAuBjD;;;;;OAKG;YACY,QAAQ;IAgEvB;;;;;OAKG;YACY,IAAI;IA8BnB;;;;;OAKG;YACW,UAAU;IAuCxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE;IAiBnD;;OAEG;IACH,MAAM;IAQN;;OAEG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,YAAY;IA2C1B;;OAEG;YACW,mBAAmB;CA2ClC"}

package/dist/{types/thread.d.ts → thread/types.d.ts}

@@ -2,7 +2,7 @@ import { ToolCall, LanguageModel, LanguageModelItem, LanguageModelStreamEvent, R
 import { Task } from "../task.js";
 import { Context } from "../context.js";
 import { Agent } from "../agent.js";
-import type { AgentResponseType } from "./agent.js";
+import type { AgentResponseType } from "../agent/types.js";
 import type { ThreadStore } from "../storage/index.js";
 /**
  * Public/client-facing thread events (excludes internal system events).
@@ -148,4 +148,4 @@ export interface PerformActionsResult {
      */
     pendingApprovals: ToolCall[];
 }
-//# sourceMappingURL=thread.d.ts.map
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/thread/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,OAAO,EACP,OAAO,EACP,aAAa,EACb,eAAe,EACf,MAAM,EACN,IAAI,EACL,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,aAAa,uFAOhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,OAAO,GACd,OAAO,OAAO,GACd,OAAO,aAAa,GACpB,OAAO,eAAe,GACtB,OAAO,MAAM,GACb,OAAO,IAAI,CAAC;AAEhB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,OAAO,CACtB,QAAQ,GAAG,OAAO,EAClB,SAAS,SAAS,iBAAiB,GAAG,MAAM;IAE5C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClC,KAAK,EAAE,aAAa,CAAC;IAErB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,KAAK,EAAE,iBAAiB,EAAE,CAAoC;IAC9D,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAsD;IAGjF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAA+B;IACjD,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CAEzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,CAAC,iBAAiB,GAAG,eAAe,CAAC,GACrC,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,SAAS,GAAG,OAAO;IACtD;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAC5B,QAAQ,GAAG,OAAO,EAClB,SAAS,SAAS,iBAAiB,GAAG,MAAM;IAE5C,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,QAAQ;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAC;CAEvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B;;OAEG;IACH,gBAAgB,EAAE,QAAQ,EAAE,CAAC;CAC9B"}

package/dist/thread/utils.d.ts

@@ -1,7 +1,7 @@
 import type { ResolvedAgentResponse } from "../guardrail.js";
 import { ToolCall, LanguageModelItem } from "@kernl-sdk/protocol";
-import type { AgentResponseType } from "../types/agent.js";
-import type { ThreadEvent, ThreadStreamEvent, ActionSet, PublicThreadEvent } from "../types/thread.js";
+import type { AgentResponseType } from "../agent/types.js";
+import type { ThreadEvent, ThreadStreamEvent, ActionSet, PublicThreadEvent } from "./types.js";
 /**
  * Create a ThreadEvent from a LanguageModelItem with thread metadata.
  *

package/dist/thread/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/thread/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,WAAW,CAad;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,QAAQ,CAE7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,SAAS,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,iBAAiB,CAY7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,iBAAiB,CAc5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,IAAI,CAc1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,SAAS,iBAAiB,EACpE,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,SAAS,GACtB,qBAAqB,CAAC,SAAS,CAAC,CAsBlC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/thread/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,WAAW,CAad;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,QAAQ,CAE7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,SAAS,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,iBAAiB,CAY7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,iBAAiB,CAc5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,IAAI,CAc1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,SAAS,iBAAiB,EACpE,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,SAAS,GACtB,qBAAqB,CAAC,SAAS,CAAC,CAsBlC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kernl",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "A modern AI agent framework",
   "keywords": [
     "kernl",
@@ -36,6 +36,7 @@
     "pino": "^9.6.0",
     "zod": "^4.1.12",
     "@kernl-sdk/protocol": "0.2.5",
+    "@kernl-sdk/retrieval": "0.1.0",
     "@kernl-sdk/shared": "^0.1.6"
   },
   "devDependencies": {
@@ -44,9 +45,10 @@
     "tsc-alias": "^1.8.10",
     "typescript": "5.9.2",
     "vitest": "^4.0.8",
-    "@kernl-sdk/ai": "0.2.6"
+    "@kernl-sdk/ai": "0.2.7"
   },
   "scripts": {
+    "clean": "rm -rf dist",
     "build": "tsc && tsc-alias --resolve-full-paths",
     "dev": "tsc --watch",
     "lint": "eslint src/",

package/src/{types/agent.ts → agent/types.ts}

@@ -8,7 +8,7 @@ import {
 import { InputGuardrail, OutputGuardrail } from "@/guardrail";
 import { BaseToolkit } from "@/tool";
 
-import { TextResponse } from "./thread";
+import { TextResponse } from "@/thread/types";
 
 /**
  * Configuration for an agent.

package/src/agent.ts

@@ -25,13 +25,15 @@ import {
 import { AgentHooks } from "./lifecycle";
 
 import { MisconfiguredError, RuntimeError } from "./lib/error";
-import type { AgentConfig, AgentResponseType } from "./types/agent";
+import type { AgentConfig, AgentResponseType } from "@/agent/types";
 import type {
   TextResponse,
   ThreadExecuteOptions,
   ThreadExecuteResult,
   ThreadStreamEvent,
-} from "./types/thread";
+} from "@/thread/types";
+import type { AgentMemoryCreate, MemorySearchQuery } from "./memory";
+import { randomID } from "@kernl-sdk/shared/lib";
 
 export class Agent<
     TContext = UnknownContext,
@@ -328,4 +330,78 @@ export class Agent<
         kthreads.update(tid, patch),
     };
   }
+
+  /**
+   * Memory management scoped to this agent.
+   *
+   * Provides a simplified API for creating memories with:
+   * - Auto-generated IDs
+   * - Flattened scope fields (namespace, entityId) - agentId is implicit
+   * - Default kind of "semantic"
+   *
+   * @example
+   * ```ts
+   * await agent.memories.create({
+   *   namespace: "user-123",
+   *   collection: "preferences",
+   *   content: { text: "User prefers TypeScript" },
+   * });
+   * ```
+   */
+  get memories() {
+    if (!this.kernl) {
+      throw new MisconfiguredError(
+        `Agent ${this.id} not bound to kernl. Call kernl.register(agent) first.`,
+      );
+    }
+
+    const agentId = this.id;
+    const kmem = this.kernl.memories;
+
+    return {
+      /**
+       * Create a new memory scoped to this agent.
+       */
+      create: (params: AgentMemoryCreate) =>
+        kmem.create({
+          id: params.id ?? `mem_${randomID()}`,
+          scope: {
+            namespace: params.namespace,
+            entityId: params.entityId,
+            agentId,
+          },
+          kind: "semantic",
+          collection: params.collection,
+          content: params.content,
+          wmem: params.wmem,
+          smem: params.smem,
+          timestamp: params.timestamp,
+          metadata: params.metadata,
+        }),
+
+      /**
+       * Search memories scoped to this agent.
+       */
+      search: (
+        params: Omit<MemorySearchQuery, "filter"> & {
+          filter?: Omit<NonNullable<MemorySearchQuery["filter"]>, "scope"> & {
+            scope?: Omit<
+              NonNullable<NonNullable<MemorySearchQuery["filter"]>["scope"]>,
+              "agentId"
+            >;
+          };
+        },
+      ) =>
+        kmem.search({
+          ...params,
+          filter: {
+            ...params.filter,
+            scope: {
+              ...params.filter?.scope,
+              agentId,
+            },
+          },
+        }),
+    };
+  }
 }

package/src/api/__tests__/threads.test.ts

@@ -4,10 +4,10 @@ import { message, RUNNING } from "@kernl-sdk/protocol";
 
 import { Agent } from "@/agent";
 import { InMemoryThreadStore } from "@/storage/in-memory";
-import type { AgentRegistry, ModelRegistry } from "@/types/kernl";
+import type { AgentRegistry, ModelRegistry } from "@/kernl/types";
 import type { NewThread } from "@/storage";
 import { tevent } from "@/thread/utils";
-import type { ThreadEvent } from "@/types/thread";
+import type { ThreadEvent } from "@/thread/types";
 import { RThreads } from "@/api/resources/threads";
 import type { MThread } from "@/api/models";
 

package/src/api/models/thread.ts

@@ -1,5 +1,5 @@
 import type { LanguageModelItem } from "@kernl-sdk/protocol";
-import type { ThreadState } from "@/types/thread";
+import type { ThreadState } from "@/thread/types";
 
 /**
  * Model metadata for the language model used by a thread.

package/src/api/resources/threads/events.ts

@@ -1,7 +1,7 @@
 import type { ThreadStore } from "@/storage";
 import { isPublicEvent } from "@/thread/utils";
 import type { MThreadEvent } from "@/api/models";
-import type { ThreadEvent } from "@/types/thread";
+import type { ThreadEvent } from "@/thread/types";
 
 /**
  * Events subresource for threads.

package/src/api/resources/threads/threads.ts

@@ -3,14 +3,14 @@ import type {
   ThreadListOptions,
   ThreadHistoryOptions,
 } from "@/storage";
-import type { ThreadEvent } from "@/types/thread";
+import type { ThreadEvent } from "@/thread/types";
 import { isPublicEvent } from "@/thread/utils";
 import { Context } from "@/context";
 import { randomID } from "@kernl-sdk/shared/lib";
 import { RUNNING } from "@kernl-sdk/protocol";
 
 import type { MThread, MThreadEvent } from "@/api/models";
-import { CursorPage, type CursorPageResponse } from "@/api/pagination/cursor";
+import { CursorPage, type CursorPageResponse } from "@kernl-sdk/shared";
 
 import { RThreadEvents } from "./events";
 import type {

package/src/api/resources/threads/types.ts

@@ -1,6 +1,6 @@
-import type { ThreadState } from "@/types/thread";
+import type { ThreadState } from "@/thread/types";
 import type { SortOrder } from "@/storage";
-import type { CursorPageParams } from "@/api/pagination/cursor";
+import type { CursorPageParams } from "@kernl-sdk/shared";
 
 export interface RThreadHistoryParams {
   /**

package/src/context.ts

@@ -1,7 +1,7 @@
 /**
- * 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
@@ -12,7 +12,7 @@ export class Context<TContext = UnknownContext> {
    * The namespace that this context belongs to.
    */
   namespace: string;
-  
+
   /**
    * The inner context object.
    */
@@ -64,10 +64,7 @@ export class Context<TContext = UnknownContext> {
   //  */
   // #approvals: Map<string, ApprovalRecord>;
 
-  constructor(
-    namespace: string = "kernl",
-    context: TContext = {} as TContext,
-  ) {
+  constructor(namespace: string = "kernl", context: TContext = {} as TContext) {
     this.namespace = namespace;
     this.context = context;
     this.approvals = new Map();
@@ -139,136 +136,9 @@ export class Context<TContext = UnknownContext> {
       // approvals: Object.fromEntries(this.#approvals.entries()),
     };
   }
-
-  // /**
-  //  * Rebuild the approvals map from a serialized state.
-  //  * @internal
-  //  *
-  //  * @param approvals - The approvals map to rebuild.
-  //  */
-  // _rebuildApprovals(approvals: Record<string, ApprovalRecord>) {
-  //   this.#approvals = new Map(Object.entries(approvals));
-  // }
-
-  // /**
-  //  * Check if a tool call has been approved.
-  //  *
-  //  * @param approval - Details about the tool call being evaluated.
-  //  * @returns `true` if the tool call has been approved, `false` if blocked and `undefined` if not yet approved or rejected.
-  //  */
-  // isToolApproved(approval: { toolName: string; callId: string }) {
-  //   const { toolName, callId } = approval;
-  //   const approvalEntry = this.#approvals.get(toolName);
-  //   if (approvalEntry?.approved === true && approvalEntry.rejected === true) {
-  //     logger.warn(
-  //       "Tool is permanently approved and rejected at the same time. Approval takes precedence",
-  //     );
-  //     return true;
-  //   }
-
-  //   if (approvalEntry?.approved === true) {
-  //     return true;
-  //   }
-
-  //   if (approvalEntry?.rejected === true) {
-  //     return false;
-  //   }
-
-  //   const individualCallApproval = Array.isArray(approvalEntry?.approved)
-  //     ? approvalEntry.approved.includes(callId)
-  //     : false;
-  //   const individualCallRejection = Array.isArray(approvalEntry?.rejected)
-  //     ? approvalEntry.rejected.includes(callId)
-  //     : false;
-
-  //   if (individualCallApproval && individualCallRejection) {
-  //     logger.warn(
-  //       `Tool call ${callId} is both approved and rejected at the same time. Approval takes precedence`,
-  //     );
-  //     return true;
-  //   }
-
-  //   if (individualCallApproval) {
-  //     return true;
-  //   }
-
-  //   if (individualCallRejection) {
-  //     return false;
-  //   }
-
-  //   return undefined;
-  // }
-
-  // /**
-  //  * Approve a tool call.
-  //  *
-  //  * @param approvalItem - The tool approval item to approve.
-  //  * @param options - Additional approval behavior options.
-  //  */
-  // approveTool(
-  //   approvalItem: RunToolApprovalItem,
-  //   { alwaysApprove = false }: { alwaysApprove?: boolean } = {},
-  // ) {
-  //   const toolName = approvalItem.rawItem.name;
-  //   if (alwaysApprove) {
-  //     this.#approvals.set(toolName, {
-  //       approved: true,
-  //       rejected: [],
-  //     });
-  //     return;
-  //   }
-
-  //   const approvalEntry = this.#approvals.get(toolName) ?? {
-  //     approved: [],
-  //     rejected: [],
-  //   };
-  //   if (Array.isArray(approvalEntry.approved)) {
-  //     // function tool has call_id, hosted tool call has id
-  //     const callId =
-  //       "callId" in approvalItem.rawItem
-  //         ? approvalItem.rawItem.callId // function tools
-  //         : approvalItem.rawItem.id!; // hosted tools
-  //     approvalEntry.approved.push(callId);
-  //   }
-  //   this.#approvals.set(toolName, approvalEntry);
-  // }
-
-  // /**
-  //  * Reject a tool call.
-  //  *
-  //  * @param approvalItem - The tool approval item to reject.
-  //  */
-  // rejectTool(
-  //   approvalItem: RunToolApprovalItem,
-  //   { alwaysReject = false }: { alwaysReject?: boolean } = {},
-  // ) {
-  //   const toolName = approvalItem.rawItem.name;
-  //   if (alwaysReject) {
-  //     this.#approvals.set(toolName, {
-  //       approved: false,
-  //       rejected: true,
-  //     });
-  //     return;
-  //   }
-
-  //   const approvalEntry = this.#approvals.get(toolName) ?? {
-  //     approved: [] as string[],
-  //     rejected: [] as string[],
-  //   };
-
-  //   if (Array.isArray(approvalEntry.rejected)) {
-  //     // function tool has call_id, hosted tool call has id
-  //     const callId =
-  //       "callId" in approvalItem.rawItem
-  //         ? approvalItem.rawItem.callId // function tools
-  //         : approvalItem.rawItem.id!; // hosted tools
-  //     approvalEntry.rejected.push(callId);
-  //   }
-  //   this.#approvals.set(toolName, approvalEntry);
-  // }
 }
 
 /**
- * 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";

package/src/guardrail.ts

@@ -4,8 +4,8 @@ import { LanguageModelResponse } from "@kernl-sdk/protocol";
 
 import { Agent } from "./agent";
 import { Context, UnknownContext } from "./context";
-import type { AgentResponseType } from "./types/agent";
-import type { TextResponse, ThreadEvent } from "./types/thread";
+import type { AgentResponseType } from "@/agent/types";
+import type { TextResponse, ThreadEvent } from "@/thread/types";
 
 /**
  * Resolves the agent output type based on the response type.

package/src/index.ts

@@ -4,24 +4,25 @@ export type {
   StorageOptions,
   AgentRegistry,
   ModelRegistry,
-} from "./types/kernl";
+} from "./kernl";
 export { Agent } from "./agent";
 export { Context } from "./context";
 
 // --- tools --
+
 export { tool, Toolkit, FunctionToolkit, MCPToolkit } from "./tool";
 export { MCPServerSSE } from "./mcp/sse";
 export { MCPServerStdio } from "./mcp/stdio";
 export { MCPServerStreamableHttp } from "./mcp/http";
 
-// --- thread models ---
+// --- threads ---
+
 export type {
   MThread as Thread,
   MThreadEvent as ThreadEvent,
   MThreadEventBase as ThreadEventBase,
 } from "./api/models";
 
-// --- thread resource types ---
 export type {
   RThreadsListParams as ThreadsListParams,
   RThreadGetOptions as ThreadGetOptions,
@@ -30,14 +31,14 @@ export type {
   RThreadUpdateParams as ThreadUpdateParams,
 } from "./api/resources/threads";
 
-// --- thread state enums ---
 export {
   THREAD_STATES,
   type ThreadState,
   type PublicThreadEvent,
-} from "./types/thread";
+} from "./thread/types";
+
+// --- storage ---
 
-// --- storage types ---
 export type {
   ThreadStore,
   NewThread,
@@ -50,3 +51,31 @@ export type {
   KernlStorage,
   Transaction,
 } from "./storage";
+
+// --- memory ---
+export { Memory, MemoryByteEncoder } from "./memory";
+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";

package/src/internal.ts

@@ -8,8 +8,8 @@ export type {
   ThreadSystemEvent,
   ThreadState,
   PublicThreadEvent,
-} from "./types/thread";
+} from "@/thread/types";
 
-export { THREAD_STATES } from "./types/thread";
+export { THREAD_STATES } from "@/thread/types";
 
 

package/src/kernl/index.ts

@@ -0,0 +1,8 @@
+export { Kernl } from "./kernl";
+export type {
+  KernlOptions,
+  StorageOptions,
+  MemoryOptions,
+  AgentRegistry,
+  ModelRegistry,
+} from "./types";

package/src/{kernl.ts → kernl/kernl.ts}

@@ -1,4 +1,5 @@
 import type { LanguageModel } from "@kernl-sdk/protocol";
+import { resolveEmbeddingModel } from "@kernl-sdk/retrieval";
 
 import { Agent } from "@/agent";
 import { UnknownContext } from "@/context";
@@ -7,10 +8,17 @@ import type { Thread } from "@/thread";
 import type { ResolvedAgentResponse } from "@/guardrail";
 import { InMemoryStorage, type KernlStorage } from "@/storage";
 import { RThreads } from "@/api/resources/threads";
+import {
+  Memory,
+  MemoryByteEncoder,
+  MemoryIndexHandle,
+  buildMemoryIndexSchema,
+} from "@/memory";
 
-import type { KernlOptions } from "@/types/kernl";
-import type { ThreadExecuteResult, ThreadStreamEvent } from "@/types/thread";
-import type { AgentResponseType } from "@/types/agent";
+import type { ThreadExecuteResult, ThreadStreamEvent } from "@/thread/types";
+import type { AgentResponseType } from "@/agent/types";
+
+import type { KernlOptions } from "./types";
 
 /**
  * The kernl - manages agent processes, scheduling, and task lifecycle.
@@ -27,12 +35,41 @@ export class Kernl extends KernlHooks<UnknownContext, AgentResponseType> {
 
   // --- public API ---
   readonly threads: RThreads; /* Threads resource */
+  readonly memories: Memory; /* Memory system */
 
   constructor(options: KernlOptions = {}) {
     super();
     this.storage = options.storage?.db ?? new InMemoryStorage();
     this.storage.bind({ agents: this.agents, models: this.models });
     this.threads = new RThreads(this.storage.threads);
+
+    // initialize memory
+    const embeddingModel =
+      options.memory?.embeddingModel ?? "openai/text-embedding-3-small";
+    const embedder =
+      typeof embeddingModel === "string"
+        ? resolveEmbeddingModel<string>(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,
+    });
   }
 
   /**