kernl 0.6.3 → 0.7.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> kernl@0.6.2 build /Users/andjones/Documents/projects/kernl/packages/kernl
+> kernl@0.6.3 build /Users/andjones/Documents/projects/kernl/packages/kernl
 > tsc && tsc-alias --resolve-full-paths
 

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @kernl/core
 
+## 0.7.0
+
+### Minor Changes
+
+- 13545a5: Add memory system tools and agents public API
+  - Add system tools infrastructure (`agent.systools`) for built-in agent capabilities
+  - Add memory toolkit with `memories.search`, `memories.create`, `memories.list` tools
+  - Add `memory: { enabled: true }` agent config to enable memory tools
+  - Add `ctx.agent` reference for tools to access agent APIs
+  - Add `kernl.agents` public API with `get`, `list`, `has`, `unregister` methods
+  - Add `Memory.list()` method for listing memories with filters
+  - Add `agent.description` field for agent metadata
+  - Fix: exclude metadata from thread checkpoint to prevent race conditions
+
 ## 0.6.3
 
 ### Patch Changes

package/dist/agent/__tests__/systools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=systools.test.d.ts.map

package/dist/agent/__tests__/systools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systools.test.d.ts","sourceRoot":"","sources":["../../../src/agent/__tests__/systools.test.ts"],"names":[],"mappings":""}

package/dist/agent/__tests__/systools.test.js

@@ -0,0 +1,121 @@
+import { describe, it, expect } from "vitest";
+import { Agent } from "../../agent.js";
+import { Kernl } from "../../kernl/index.js";
+import { Context } from "../../context.js";
+import { createMockModel } from "../../thread/__tests__/fixtures/mock-model.js";
+import { message } from "@kernl-sdk/protocol";
+describe("Agent systools", () => {
+    const model = createMockModel(async () => ({
+        content: [message({ role: "assistant", text: "Done" })],
+        finishReason: "stop",
+        usage: { inputTokens: 2, outputTokens: 2, totalTokens: 4 },
+        warnings: [],
+    }));
+    describe("memory toolkit", () => {
+        it("adds memory toolkit when memory.enabled is true", () => {
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+                memory: { enabled: true },
+            });
+            const kernl = new Kernl();
+            kernl.register(agent);
+            expect(agent.systools.length).toBe(1);
+            expect(agent.systools[0].id).toBe("sys.memory");
+        });
+        it("has no systools when memory not configured", () => {
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+            });
+            const kernl = new Kernl();
+            kernl.register(agent);
+            expect(agent.systools.length).toBe(0);
+        });
+        it("has no systools when memory.enabled is false", () => {
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+                memory: { enabled: false },
+            });
+            const kernl = new Kernl();
+            kernl.register(agent);
+            expect(agent.systools.length).toBe(0);
+        });
+        it("can retrieve memory tools via agent.tool()", () => {
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+                memory: { enabled: true },
+            });
+            const kernl = new Kernl();
+            kernl.register(agent);
+            expect(agent.tool("memories.search")).toBeDefined();
+            expect(agent.tool("memories.create")).toBeDefined();
+            expect(agent.tool("memories.list")).toBeDefined();
+        });
+        it("includes memory tools in agent.tools() output", async () => {
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+                memory: { enabled: true },
+            });
+            const kernl = new Kernl();
+            kernl.register(agent);
+            const ctx = new Context("test");
+            const tools = await agent.tools(ctx);
+            const ids = tools.map((t) => t.id);
+            expect(ids).toContain("memories.search");
+            expect(ids).toContain("memories.create");
+            expect(ids).toContain("memories.list");
+        });
+        it("systools appear before user toolkits in tools() output", async () => {
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+                memory: { enabled: true },
+            });
+            const kernl = new Kernl();
+            kernl.register(agent);
+            const ctx = new Context("test");
+            const tools = await agent.tools(ctx);
+            // Memory tools should be first (from systools)
+            expect(tools[0].id).toBe("memories.search");
+            expect(tools[1].id).toBe("memories.create");
+            expect(tools[2].id).toBe("memories.list");
+        });
+    });
+    describe("memory config defaults", () => {
+        it("defaults memory to { enabled: false }", () => {
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+            });
+            expect(agent.memory).toEqual({ enabled: false });
+        });
+        it("preserves memory config when provided", () => {
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+                memory: { enabled: true },
+            });
+            expect(agent.memory).toEqual({ enabled: true });
+        });
+    });
+});

package/dist/agent/types.d.ts

@@ -10,6 +10,7 @@ import { TextResponse } from "../thread/types.js";
 export interface AgentConfig<TContext = UnknownContext, TResponse extends AgentResponseType = TextResponse> {
     id: string;
     name: string;
+    description?: string;
     /**
      * The instructions for the agent. Will be used as the "system prompt" when this agent is
      * invoked. Describes what the agent should do, and how it responds.
@@ -53,6 +54,13 @@ export interface AgentConfig<TContext = UnknownContext, TResponse extends AgentR
      * ```
      */
     toolkits?: BaseToolkit<TContext>[];
+    /**
+     * Memory configuration for this agent.
+     * Enables memory system tools (memories.search, memories.create, memories.list).
+     *
+     * Requires kernl to be configured with memory storage.
+     */
+    memory?: AgentMemoryConfig;
     /**
      * A list of checks that run in parallel to the agent's execution on the input + output for the agent,
      * depending on the configuration.
@@ -88,4 +96,13 @@ export interface AgentGuardrails<TResponse extends AgentResponseType = TextRespo
  * 'text' is a special type that indicates the output will be a string.
  */
 export type AgentResponseType = TextResponse | ZodType;
+/**
+ * Memory configuration for an agent.
+ */
+export interface AgentMemoryConfig {
+    /**
+     * Enable memory system tools for this agent.
+     */
+    enabled: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,aAAa,EACb,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW,CAC1B,QAAQ,GAAG,cAAc,EACzB,SAAS,SAAS,iBAAiB,GAAG,YAAY;IAGlD,EAAE,EAAE,MAAM,CAAC;IAGX,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;OAOG;IACH,YAAY,EACR,MAAM,GACN,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;IAe/D;;;;OAIG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,4BAA4B,CAAC;IAE7C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IAEnC;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IAExC;;OAEG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IAsBzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,iBAAiB,GAAG,YAAY;IAElD;;;OAGG;IACH,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;OAGG;IACH,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,aAAa,EACb,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW,CAC1B,QAAQ,GAAG,cAAc,EACzB,SAAS,SAAS,iBAAiB,GAAG,YAAY;IAGlD,EAAE,EAAE,MAAM,CAAC;IAGX,IAAI,EAAE,MAAM,CAAC;IAGb,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;OAOG;IACH,YAAY,EACR,MAAM,GACN,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;IAe/D;;;;OAIG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,4BAA4B,CAAC;IAE7C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IAExC;;OAEG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IAsBzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,iBAAiB,GAAG,YAAY;IAElD;;;OAGG;IACH,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;OAGG;IACH,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/agent.d.ts

@@ -6,17 +6,20 @@ import { Tool } from "./tool/index.js";
 import { BaseToolkit } from "./tool/toolkit.js";
 import { InputGuardrail, OutputGuardrail, type ResolvedAgentResponse } from "./guardrail.js";
 import { AgentHooks } from "./lifecycle.js";
-import type { AgentConfig, AgentResponseType } from "./agent/types.js";
+import type { AgentConfig, AgentMemoryConfig, AgentResponseType } from "./agent/types.js";
 import type { TextResponse, ThreadExecuteOptions, ThreadExecuteResult, ThreadStreamEvent } from "./thread/types.js";
-import type { AgentMemoryCreate, MemorySearchQuery } from "./memory/index.js";
+import type { AgentMemoryCreate, MemoryListOptions, MemorySearchQuery } from "./memory/index.js";
 export declare class Agent<TContext = UnknownContext, TResponse extends AgentResponseType = TextResponse> extends AgentHooks<TContext, TResponse> implements AgentConfig<TContext, TResponse> {
     private kernl?;
     id: string;
     name: string;
+    description?: string;
     instructions: (context: Context<TContext>) => Promise<string> | string;
     model: LanguageModel;
     modelSettings: LanguageModelRequestSettings;
     toolkits: BaseToolkit<TContext>[];
+    systools: BaseToolkit<TContext>[];
+    memory: AgentMemoryConfig;
     guardrails: {
         input: InputGuardrail[];
         output: OutputGuardrail<AgentResponseType>[];
@@ -47,7 +50,7 @@ export declare class Agent<TContext = UnknownContext, TResponse extends AgentRes
     /**
      * @internal
      *
-     * Get a specific tool by ID from all toolkits.
+     * Get a specific tool by ID from systools and toolkits.
      *
      * @param id The tool ID to look up
      * @returns The tool if found, undefined otherwise
@@ -56,7 +59,7 @@ export declare class Agent<TContext = UnknownContext, TResponse extends AgentRes
     /**
      * @internal
      *
-     * Get all tools available from all toolkits for the given context.
+     * Get all tools available from systools and toolkits for the given context.
      * Checks for duplicate tool IDs across toolkits and throws an error if found.
      *
      * (TODO): Consider returning toolkits alongside tools so we can serialize them
@@ -98,6 +101,13 @@ export declare class Agent<TContext = UnknownContext, TResponse extends AgentRes
      * ```
      */
     get memories(): {
+        /**
+         * List memories scoped to this agent.
+         */
+        list: (params?: Omit<MemoryListOptions, "filter"> & {
+            collection?: string;
+            limit?: number;
+        }) => Promise<import("./memory/index.js").MemoryRecord[]>;
         /**
          * Create a new memory scoped to this agent.
          */

package/dist/agent.d.ts.map

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

package/dist/agent.js

@@ -1,5 +1,6 @@
 import { message, } from "@kernl-sdk/protocol";
 import { Thread } from "./thread/index.js";
+import { memory } from "./tool/index.js";
 import { AgentHooks } from "./lifecycle.js";
 import { MisconfiguredError, RuntimeError } from "./lib/error.js";
 import { randomID } from "@kernl-sdk/shared/lib";
@@ -7,10 +8,13 @@ export class Agent extends AgentHooks {
     kernl;
     id;
     name;
+    description;
     instructions;
     model;
     modelSettings;
     toolkits;
+    systools;
+    memory;
     // actions: ActionSet; /* TODO */
     guardrails;
     responseType = "text";
@@ -34,6 +38,7 @@ export class Agent extends AgentHooks {
         }
         this.id = config.id;
         this.name = config.name;
+        this.description = config.description;
         this.instructions =
             typeof config.instructions === "function"
                 ? config.instructions
@@ -41,6 +46,8 @@ export class Agent extends AgentHooks {
         this.model = config.model; // (TODO): include optional default setting for convenience like env.DEFAULT_LLM = "gpt-5"
         this.modelSettings = config.modelSettings ?? {};
         this.toolkits = config.toolkits ?? [];
+        this.systools = [];
+        this.memory = config.memory ?? { enabled: false };
         for (const toolkit of this.toolkits) {
             toolkit.bind(this);
         }
@@ -69,6 +76,13 @@ export class Agent extends AgentHooks {
      */
     bind(kernl) {
         this.kernl = kernl;
+        // initialize system toolkits
+        if (this.memory.enabled) {
+            // safety: system tools only rely on ctx.agent, not ctx.context
+            const toolkit = memory;
+            this.systools.push(toolkit);
+            toolkit.bind(this);
+        }
     }
     /**
      * Blocking execution - spawns or resumes thread and waits for completion
@@ -168,12 +182,19 @@ export class Agent extends AgentHooks {
     /**
      * @internal
      *
-     * Get a specific tool by ID from all toolkits.
+     * Get a specific tool by ID from systools and toolkits.
      *
      * @param id The tool ID to look up
      * @returns The tool if found, undefined otherwise
      */
     tool(id) {
+        // Check systools first
+        for (const toolkit of this.systools) {
+            const tool = toolkit.get(id);
+            if (tool)
+                return tool;
+        }
+        // Then user toolkits
         for (const toolkit of this.toolkits) {
             const tool = toolkit.get(id);
             if (tool)
@@ -184,7 +205,7 @@ export class Agent extends AgentHooks {
     /**
      * @internal
      *
-     * Get all tools available from all toolkits for the given context.
+     * Get all tools available from systools and toolkits for the given context.
      * Checks for duplicate tool IDs across toolkits and throws an error if found.
      *
      * (TODO): Consider returning toolkits alongside tools so we can serialize them
@@ -195,18 +216,16 @@ export class Agent extends AgentHooks {
      * @throws {MisconfiguredError} If duplicate tool IDs are found across toolkits
      */
     async tools(context) {
-        const allTools = [];
-        const toolIds = new Set();
-        for (const toolkit of this.toolkits) {
-            const tools = await toolkit.list(context);
-            const duplicates = tools.map((t) => t.id).filter((id) => toolIds.has(id));
-            if (duplicates.length > 0) {
-                throw new MisconfiguredError(`Duplicate tool IDs found across toolkits: ${duplicates.join(", ")}`);
-            }
-            tools.forEach((t) => toolIds.add(t.id));
-            allTools.push(...tools);
+        const all = [];
+        for (const toolkit of [...this.systools, ...this.toolkits]) {
+            all.push(...(await toolkit.list(context)));
+        }
+        const ids = all.map((t) => t.id);
+        const duplicates = ids.filter((id, i) => ids.indexOf(id) !== i);
+        if (duplicates.length > 0) {
+            throw new MisconfiguredError(`Duplicate tool IDs found: ${[...new Set(duplicates)].join(", ")}`);
         }
-        return allTools;
+        return all;
     }
     /**
      * Thread management scoped to this agent.
@@ -259,6 +278,16 @@ export class Agent extends AgentHooks {
         const agentId = this.id;
         const kmem = this.kernl.memories;
         return {
+            /**
+             * List memories scoped to this agent.
+             */
+            list: (params) => kmem.list({
+                filter: {
+                    scope: { agentId },
+                    collections: params?.collection ? [params.collection] : undefined,
+                },
+                limit: params?.limit,
+            }),
             /**
              * Create a new memory scoped to this agent.
              */

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

@@ -0,0 +1,38 @@
+import type { Agent } from "../../../agent.js";
+import type { AgentResponseType } from "../../../agent/types.js";
+import type { UnknownContext } from "../../../context.js";
+import type { TextResponse } from "../../../thread/types.js";
+/**
+ * Agents resource.
+ *
+ * Thin facade over the in-process agent registry, returning live Agent instances.
+ *
+ * Note: agents are code, not persisted data; this is process-local.
+ */
+export declare class RAgents {
+    private readonly registry;
+    constructor(registry: Map<string, Agent>);
+    /**
+     * Get a live Agent instance by id.
+     *
+     * Callers are expected to know the concrete TContext/TResponse types
+     * for their own agents and can specify them via generics.
+     */
+    get<TContext = UnknownContext, TResponse extends AgentResponseType = TextResponse>(id: string): Agent<TContext, TResponse> | undefined;
+    /**
+     * Check if an agent with the given id is registered.
+     */
+    has(id: string): boolean;
+    /**
+     * List all registered agents as live instances.
+     *
+     * Since this is a heterogeneous collection, we expose the widest safe
+     * type parameters here.
+     */
+    list(): Agent<UnknownContext, AgentResponseType>[];
+    /**
+     * Unregister an agent at runtime.
+     */
+    unregister(id: string): boolean;
+}
+//# sourceMappingURL=agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/agents/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAEzD;;;;;OAKG;IACH,GAAG,CACD,QAAQ,GAAG,cAAc,EACzB,SAAS,SAAS,iBAAiB,GAAG,YAAY,EAClD,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,SAAS;IAKrD;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;;OAKG;IACH,IAAI,IAAI,KAAK,CAAC,cAAc,EAAE,iBAAiB,CAAC,EAAE;IAOlD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGhC"}

package/dist/api/resources/agents/agents.js

@@ -0,0 +1,44 @@
+/**
+ * Agents resource.
+ *
+ * Thin facade over the in-process agent registry, returning live Agent instances.
+ *
+ * Note: agents are code, not persisted data; this is process-local.
+ */
+export class RAgents {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Get a live Agent instance by id.
+     *
+     * Callers are expected to know the concrete TContext/TResponse types
+     * for their own agents and can specify them via generics.
+     */
+    get(id) {
+        const agent = this.registry.get(id);
+        return agent;
+    }
+    /**
+     * Check if an agent with the given id is registered.
+     */
+    has(id) {
+        return this.registry.has(id);
+    }
+    /**
+     * List all registered agents as live instances.
+     *
+     * Since this is a heterogeneous collection, we expose the widest safe
+     * type parameters here.
+     */
+    list() {
+        return Array.from(this.registry.values());
+    }
+    /**
+     * Unregister an agent at runtime.
+     */
+    unregister(id) {
+        return this.registry.delete(id);
+    }
+}

package/dist/api/resources/agents/index.d.ts

@@ -0,0 +1,2 @@
+export { RAgents } from "./agents.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/resources/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/api/resources/agents/index.js

@@ -0,0 +1 @@
+export { RAgents } from "./agents.js";

package/dist/context.d.ts

@@ -1,3 +1,4 @@
+import type { Agent } from "./agent.js";
 /**
  * Context that is being passed around as part of the session is unknown
  */
@@ -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.

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,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;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;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"}
+{"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/kernl/kernl.d.ts

@@ -5,6 +5,7 @@ import type { Thread } from "../thread/index.js";
 import type { ResolvedAgentResponse } from "../guardrail.js";
 import { type KernlStorage } from "../storage/index.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";
@@ -16,11 +17,12 @@ import type { KernlOptions } from "./types.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>>;
     readonly threads: RThreads;
+    readonly agents: RAgents;
     readonly memories: Memory;
     constructor(options?: KernlOptions);
     /**

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

@@ -1 +1 @@
-{"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,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,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;IAGpD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAmCtC;;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"}
+{"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

@@ -2,6 +2,7 @@ import { resolveEmbeddingModel } from "@kernl-sdk/retrieval";
 import { KernlHooks } from "../lifecycle.js";
 import { InMemoryStorage } from "../storage/index.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.
@@ -10,18 +11,20 @@ import { Memory, MemoryByteEncoder, MemoryIndexHandle, buildMemoryIndexSchema, }
  * tracing.
  */
 export class Kernl extends KernlHooks {
-    agents = new Map();
-    models = new Map();
+    _agents = new Map();
+    _models = new Map();
     storage;
     athreads = new Map(); /* active threads */
     // --- public API ---
-    threads; /* Threads resource */
-    memories; /* Memory system */
+    threads;
+    agents;
+    memories;
     constructor(options = {}) {
         super();
         this.storage = options.storage?.db ?? new InMemoryStorage();
-        this.storage.bind({ agents: this.agents, models: this.models });
+        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"
@@ -49,14 +52,14 @@ export class Kernl extends KernlHooks {
      * 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);
         }
     }
     /**

package/dist/memory/memory.d.ts

@@ -1,5 +1,5 @@
 import type { SearchHit } from "@kernl-sdk/retrieval";
-import type { NewMemory, MemoryRecord, MemoryRecordUpdate, MemoryScope, MemoryConfig, MemorySearchQuery, IndexMemoryRecord, WorkingMemorySnapshot, ShortTermMemorySnapshot, MemoryReindexParams } from "./types.js";
+import type { NewMemory, MemoryRecord, MemoryRecordUpdate, MemoryScope, MemoryConfig, MemorySearchQuery, MemoryListOptions, IndexMemoryRecord, WorkingMemorySnapshot, ShortTermMemorySnapshot, MemoryReindexParams } from "./types.js";
 /**
  * Memory is the primary memory abstraction for agents.
  *
@@ -35,6 +35,10 @@ export declare class Memory {
      * adapts based on backend capabilities (e.g. drops text for pgvector).
      */
     search(q: MemorySearchQuery): Promise<SearchHit<IndexMemoryRecord>[]>;
+    /**
+     * List memories matching the filter.
+     */
+    list(options?: MemoryListOptions): Promise<MemoryRecord[]>;
     /**
      * Repair indexing for a memory without modifying the DB row.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/memory/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAInE,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,iBAAiB,EAEjB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAGjB;;;;;;;;;;;GAWG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;gBAEzD,MAAM,EAAE,YAAY;IAShC;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAYtD;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAe/D;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAc3E;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzD;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAO3E;;OAEG;IACG,mBAAmB,CACvB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,uBAAuB,CAAC;CAMpC"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/memory/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAInE,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EAEjB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAGjB;;;;;;;;;;;GAWG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;gBAEzD,MAAM,EAAE,YAAY;IAShC;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAYtD;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAe/D;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAc3E;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIhE;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzD;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAO3E;;OAEG;IACG,mBAAmB,CACvB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,uBAAuB,CAAC;CAMpC"}