kernl 0.11.2 → 0.12.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> kernl@0.11.2 build /home/runner/work/kernl/kernl/packages/kernl
+> kernl@0.12.0 build /home/runner/work/kernl/kernl/packages/kernl
 > tsc && tsc-alias --resolve-full-paths
 

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # @kernl/core
 
+## 0.12.0
+
+### Minor Changes
+
+- 8815744: **BREAKING:** Refactor event kind naming from kebab-case to dot notation
+
+  This aligns the language model stream/item kinds with the existing realtime events naming convention.
+
+  ### Kind value changes
+
+  | Old                | New                |
+  | ------------------ | ------------------ |
+  | `tool-call`        | `tool.call`        |
+  | `tool-result`      | `tool.result`      |
+  | `text-start`       | `text.start`       |
+  | `text-delta`       | `text.delta`       |
+  | `text-end`         | `text.end`         |
+  | `reasoning-start`  | `reasoning.start`  |
+  | `reasoning-delta`  | `reasoning.delta`  |
+  | `reasoning-end`    | `reasoning.end`    |
+  | `tool-input-start` | `tool.input.start` |
+  | `tool-input-delta` | `tool.input.delta` |
+  | `tool-input-end`   | `tool.input.end`   |
+  | `stream-start`     | `stream.start`     |
+
+  ### ToolInputStartEvent: `toolName` → `toolId`
+
+  The `ToolInputStartEvent` now uses `toolId` to match `ToolCall` and `ToolResult`.
+
+  ### Migration
+
+  If you have persisted thread events, run:
+
+  ```sql
+  UPDATE thread_events SET kind = 'tool.call' WHERE kind = 'tool-call';
+  UPDATE thread_events SET kind = 'tool.result' WHERE kind = 'tool-result';
+  ```
+
+### Patch Changes
+
+- Updated dependencies [8815744]
+  - @kernl-sdk/protocol@0.5.0
+  - @kernl-sdk/retrieval@0.1.9
+
+## 0.11.4
+
+### Patch Changes
+
+- Updated dependencies [830b52a]
+  - @kernl-sdk/shared@0.4.0
+  - @kernl-sdk/protocol@0.4.2
+  - @kernl-sdk/retrieval@0.1.8
+
+## 0.11.3
+
+### Patch Changes
+
+- 97c66df: Fix type variance for toolkit composition
+  - Use `any` instead of generic context types in stored agent references to break invariance
+  - Allows toolkits with different context types to be composed in the same agent
+  - Remove unused agent parameter from isEnabled signature
+
 ## 0.11.2
 
 ### Patch Changes

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

@@ -218,7 +218,7 @@ describe("Agent.stream() lifecycle", () => {
         for await (const event of agent.stream("Hello")) {
             events.push(event);
         }
-        expect(events[0]).toEqual({ kind: "stream-start" });
+        expect(events[0]).toEqual({ kind: "stream.start" });
     });
     it("should have same persistence behavior as run()", async () => {
         const storage = new InMemoryStorage();
@@ -247,7 +247,7 @@ describe("Agent.stream() lifecycle", () => {
         expect(history.length).toBeGreaterThan(0);
         // Should have streamed events
         expect(events).toEqual(expect.arrayContaining([
-            { kind: "stream-start" },
+            { kind: "stream.start" },
             expect.objectContaining({ kind: "message" }),
         ]));
     });

package/dist/context.d.ts

@@ -21,8 +21,9 @@ export declare class Context<TContext = UnknownContext> {
      * Set by the thread during execution.
      *
      * NOTE: Primarily used by system tools (e.g., memory) that need agent access.
+     * Uses `any` to avoid invariance issues when composing toolkits.
      */
-    agent?: Agent<TContext, any>;
+    agent?: Agent<any, 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,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;;;;;OAKG;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"}
+{"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;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAMxB;;;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

@@ -16,6 +16,7 @@ export class Context {
      * Set by the thread during execution.
      *
      * NOTE: Primarily used by system tools (e.g., memory) that need agent access.
+     * Uses `any` to avoid invariance issues when composing toolkits.
      */
     agent;
     // ----------------------

package/dist/kernl/kernl.d.ts

@@ -30,7 +30,7 @@ export declare class Kernl extends KernlHooks {
     /**
      * Registers a new agent with the kernl instance.
      */
-    register(agent: BaseAgent): void;
+    register(agent: BaseAgent<any>): void;
     /**
      * Spawn a new thread - blocking execution
      */

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,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,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;AAIlB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,SAAS,CAAC;AAE3E;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,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;IAEpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,OAAO,CAAC,QAAQ,CAGd;IAGF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAatC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAgChC;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACtD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IASnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC7D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IAWnC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA6BzB"}
+{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,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;AAIlB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,SAAS,CAAC;AAE3E;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,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;IAEpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,OAAO,CAAC,QAAQ,CAGd;IAGF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAatC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI;IAgCrC;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACtD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IASnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC7D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IAWnC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA6BzB"}

package/dist/lifecycle/__tests__/hooks.test.js

@@ -238,7 +238,7 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "echo",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -302,7 +302,7 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "add",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -359,7 +359,7 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "add",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -415,7 +415,7 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "failing",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -473,14 +473,14 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "tool1",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
                                 arguments: JSON.stringify({ value: "a" }),
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "tool2",
                                 state: IN_PROGRESS,
                                 callId: "call_2",

package/dist/storage/__tests__/in-memory.test.js

@@ -312,7 +312,7 @@ describe("InMemoryThreadStore", () => {
         it("should filter by kinds", async () => {
             await store.append([
                 {
-                    kind: "tool-call",
+                    kind: "tool.call",
                     id: "tc-1",
                     tid: "thread-1",
                     seq: 3,

package/dist/thread/__tests__/fixtures/mock-model.js

@@ -10,18 +10,18 @@ async function* streamFromResponse(response) {
                 if (contentItem.kind === "text") {
                     // Yield text-start
                     yield {
-                        kind: "text-start",
+                        kind: "text.start",
                         id: item.id,
                     };
                     // Yield text-delta
                     yield {
-                        kind: "text-delta",
+                        kind: "text.delta",
                         id: item.id,
                         text: contentItem.text,
                     };
                     // Yield text-end
                     yield {
-                        kind: "text-end",
+                        kind: "text.end",
                         id: item.id,
                     };
                 }

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

@@ -48,13 +48,13 @@ describe.skipIf(SKIP_INTEGRATION_TESTS)("Thread streaming integration", () => {
             }
             expect(events.length).toBeGreaterThan(0);
             // Should have text-delta events (for streaming UX)
-            const textDeltas = events.filter((e) => e.kind === "text-delta");
+            const textDeltas = events.filter((e) => e.kind === "text.delta");
             expect(textDeltas.length).toBeGreaterThan(0);
             // Should have text-start event
-            const textStarts = events.filter((e) => e.kind === "text-start");
+            const textStarts = events.filter((e) => e.kind === "text.start");
             expect(textStarts.length).toBeGreaterThan(0);
             // Should have text-end event
-            const textEnds = events.filter((e) => e.kind === "text-end");
+            const textEnds = events.filter((e) => e.kind === "text.end");
             expect(textEnds.length).toBeGreaterThan(0);
             // Should have complete Message item (for history)
             const messages = events.filter((e) => e.kind === "message");
@@ -103,9 +103,9 @@ describe.skipIf(SKIP_INTEGRATION_TESTS)("Thread streaming integration", () => {
                 expect(["message", "reasoning", "tool-call", "tool-result"]).toContain(event.kind);
             }
             // Stream events should include deltas (but history should not)
-            const streamDeltas = streamEvents.filter((e) => e.kind === "text-delta" ||
-                e.kind === "text-start" ||
-                e.kind === "text-end");
+            const streamDeltas = streamEvents.filter((e) => e.kind === "text.delta" ||
+                e.kind === "text.start" ||
+                e.kind === "text.end");
             expect(streamDeltas.length).toBeGreaterThan(0);
             // History should contain the input message (with ThreadEvent headers added)
             expect(history[0]).toMatchObject({
@@ -162,14 +162,14 @@ describe.skipIf(SKIP_INTEGRATION_TESTS)("Thread streaming integration", () => {
             }
             expect(events.length).toBeGreaterThan(0);
             // Should have tool calls
-            const toolCalls = events.filter((e) => e.kind === "tool-call");
+            const toolCalls = events.filter((e) => e.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
             // Verify tool was called with correct parameters
             const addToolCall = toolCalls.find((tc) => tc.toolId === "add");
             expect(addToolCall).toBeDefined();
             expect(JSON.parse(addToolCall.arguments)).toEqual({ a: 25, b: 17 });
             // Should have tool results
-            const toolResults = events.filter((e) => e.kind === "tool-result");
+            const toolResults = events.filter((e) => e.kind === "tool.result");
             expect(toolResults.length).toBeGreaterThan(0);
             // Verify tool result is correct
             const addToolResult = toolResults.find((tr) => tr.callId === addToolCall.callId);
@@ -177,8 +177,8 @@ describe.skipIf(SKIP_INTEGRATION_TESTS)("Thread streaming integration", () => {
             expect(addToolResult.result).toBe(42);
             // History should contain tool calls and results
             const history = thread.history;
-            const historyToolCalls = history.filter((e) => e.kind === "tool-call");
-            const historyToolResults = history.filter((e) => e.kind === "tool-result");
+            const historyToolCalls = history.filter((e) => e.kind === "tool.call");
+            const historyToolResults = history.filter((e) => e.kind === "tool.result");
             expect(historyToolCalls.length).toBe(toolCalls.length);
             expect(historyToolResults.length).toBe(toolResults.length);
             // Verify the assistant's final response references the correct answer
@@ -228,8 +228,8 @@ describe.skipIf(SKIP_INTEGRATION_TESTS)("Thread streaming integration", () => {
                 events.push(event);
             }
             // Find the tool call and result
-            const toolCalls = events.filter((e) => e.kind === "tool-call");
-            const toolResults = events.filter((e) => e.kind === "tool-result");
+            const toolCalls = events.filter((e) => e.kind === "tool.call");
+            const toolResults = events.filter((e) => e.kind === "tool.result");
             expect(toolCalls.length).toBeGreaterThan(0);
             expect(toolResults.length).toBeGreaterThan(0);
             const multiplyCall = toolCalls[0];
@@ -244,8 +244,8 @@ describe.skipIf(SKIP_INTEGRATION_TESTS)("Thread streaming integration", () => {
             expect(multiplyResult.callId.length).toBeGreaterThan(0);
             // Verify history contains both with matching callIds
             const history = thread.history;
-            const historyToolCall = history.find((e) => e.kind === "tool-call" && e.toolId === "multiply");
-            const historyToolResult = history.find((e) => e.kind === "tool-result" && e.toolId === "multiply");
+            const historyToolCall = history.find((e) => e.kind === "tool.call" && e.toolId === "multiply");
+            const historyToolResult = history.find((e) => e.kind === "tool.result" && e.toolId === "multiply");
             expect(historyToolCall).toBeDefined();
             expect(historyToolResult).toBeDefined();
             expect(historyToolCall.callId).toBe(historyToolResult.callId);

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

@@ -67,7 +67,7 @@ describe("Thread Persistence", () => {
             //     return {
             //       content: [
             //         message({ role: "assistant", text: "" }),
-            //         { kind: "tool-call", toolId: "test", callId: "call_1", state: IN_PROGRESS, arguments: "{}" },
+            //         { kind: "tool.call", toolId: "test", callId: "call_1", state: IN_PROGRESS, arguments: "{}" },
             //       ],
             //       finishReason: "stop",
             //       usage: { inputTokens: 2, outputTokens: 2, totalTokens: 4 },
@@ -127,7 +127,7 @@ describe("Thread Persistence", () => {
             //     return {
             //       content: [
             //         message({ role: "assistant", text: "" }),
-            //         { kind: "tool-call", toolId: "echo", callId: "call_1", state: IN_PROGRESS, arguments: '{"text":"test"}' },
+            //         { kind: "tool.call", toolId: "echo", callId: "call_1", state: IN_PROGRESS, arguments: '{"text":"test"}' },
             //       ],
             //       finishReason: "stop",
             //       usage: { inputTokens: 2, outputTokens: 2, totalTokens: 4 },
@@ -167,7 +167,7 @@ describe("Thread Persistence", () => {
             //
             // // Find the append call for tick 1 (should include model message, tool-call, and tool-result)
             // const tick1Events = storage.calls.append.find(batch =>
-            //   batch.some(e => e.kind === "tool-result")
+            //   batch.some(e => e.kind === "tool.result")
             // );
             //
             // expect(tick1Events).toBeDefined();
@@ -177,8 +177,8 @@ describe("Thread Persistence", () => {
             // expect(tick1Events).toEqual(
             //   expect.arrayContaining([
             //     expect.objectContaining({ kind: "message", role: "assistant" }),
-            //     expect.objectContaining({ kind: "tool-call", toolId: "echo" }),
-            //     expect.objectContaining({ kind: "tool-result", toolId: "echo", result: "Echo: test" }),
+            //     expect.objectContaining({ kind: "tool.call", toolId: "echo" }),
+            //     expect.objectContaining({ kind: "tool.result", toolId: "echo", result: "Echo: test" }),
             //   ])
             // );
         });
@@ -220,7 +220,7 @@ describe("Thread Persistence", () => {
             // expect(lastUpdate.patch.state).toBe(STOPPED);
             //
             // // Verify stream-start event
-            // expect(events[0]).toEqual({ kind: "stream-start" });
+            // expect(events[0]).toEqual({ kind: "stream.start" });
         });
         it.skip("should persist STOPPED state even on model error", async () => {
             // TODO: Enable once InMemoryStorage is implemented

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

@@ -164,7 +164,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "echo",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -233,7 +233,7 @@ describe("Thread", () => {
                 }),
                 // Tool call (tick 1)
                 expect.objectContaining({
-                    kind: "tool-call",
+                    kind: "tool.call",
                     toolId: "echo",
                     callId: "call_1",
                     state: IN_PROGRESS,
@@ -241,7 +241,7 @@ describe("Thread", () => {
                 }),
                 // Tool result (executed after tick 1)
                 expect.objectContaining({
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: "call_1",
                     toolId: "echo",
                     state: COMPLETED,
@@ -271,7 +271,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -297,7 +297,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_2",
@@ -371,7 +371,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "nonexistent",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -418,9 +418,9 @@ describe("Thread", () => {
             await thread.execute();
             const history = thread.history;
             // Check that the tool result is an error
-            const toolResult = history.find((e) => e.kind === "tool-result");
+            const toolResult = history.find((e) => e.kind === "tool.result");
             expect(toolResult).toEqual(expect.objectContaining({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call_1",
                 toolId: "nonexistent",
                 state: FAILED,
@@ -443,7 +443,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "failing",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -499,9 +499,9 @@ describe("Thread", () => {
             const thread = new Thread({ agent, input: userMessage("test") });
             await thread.execute();
             const history = thread.history;
-            const toolResult = history.find((e) => e.kind === "tool-result");
+            const toolResult = history.find((e) => e.kind === "tool.result");
             expect(toolResult).toMatchObject({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call_1",
                 toolId: "failing",
                 state: FAILED,
@@ -524,7 +524,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "add",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -577,9 +577,9 @@ describe("Thread", () => {
             await thread.execute();
             // @ts-expect-error
             const history = thread.history;
-            const toolResult = history.find((e) => e.kind === "tool-result");
+            const toolResult = history.find((e) => e.kind === "tool.result");
             expect(toolResult).toEqual(expect.objectContaining({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call_1",
                 toolId: "add",
                 state: COMPLETED,
@@ -604,14 +604,14 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "tool1",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
                                 arguments: JSON.stringify({ value: "a" }),
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "tool2",
                                 state: IN_PROGRESS,
                                 callId: "call_2",
@@ -672,11 +672,11 @@ describe("Thread", () => {
             await thread.execute();
             const history = thread.history;
             // Should have both tool results in history
-            const toolResults = history.filter((e) => e.kind === "tool-result");
+            const toolResults = history.filter((e) => e.kind === "tool.result");
             expect(toolResults).toHaveLength(2);
             expect(toolResults).toEqual(expect.arrayContaining([
                 expect.objectContaining({
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: "call_1",
                     toolId: "tool1",
                     state: COMPLETED,
@@ -684,7 +684,7 @@ describe("Thread", () => {
                     error: null,
                 }),
                 expect.objectContaining({
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: "call_2",
                     toolId: "tool2",
                     state: COMPLETED,
@@ -709,7 +709,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: `call_${callCount}`,
@@ -777,7 +777,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -880,7 +880,7 @@ describe("Thread", () => {
                                 content: [{ kind: "text", text: "Let me use a tool" }],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_1",

package/dist/thread/thread.js

@@ -127,7 +127,7 @@ export class Thread {
             namespace: this.namespace,
             context: this.context,
         });
-        yield { kind: "stream-start" }; // always yield start immediately
+        yield { kind: "stream.start" }; // always yield start immediately
         try {
             yield* this._execute();
             this.agent.emit("thread.stop", {
@@ -380,7 +380,7 @@ export class Thread {
         const pendingApprovals = [];
         // (TODO): clean this - approval tracking should be handled differently
         for (const e of toolEvents) {
-            if (e.kind === "tool-result" &&
+            if (e.kind === "tool.result" &&
                 e.state === "requires_approval" // (TODO): fix this
             ) {
                 // find the original tool call for this pending approval
@@ -440,7 +440,7 @@ export class Thread {
                     error: res.error,
                 });
                 return {
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: call.callId,
                     toolId: call.toolId,
                     state: res.state,
@@ -460,7 +460,7 @@ export class Thread {
                     error: error instanceof Error ? error.message : String(error),
                 });
                 return {
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: call.callId,
                     toolId: call.toolId,
                     state: FAILED,
@@ -495,7 +495,7 @@ export class Thread {
         const filtered = input;
         // serialize action repertoire
         const all = await this.agent.tools(this.context);
-        const enabled = await filter(all, async (tool) => await tool.isEnabled(this.context, this.agent));
+        const enabled = await filter(all, async (tool) => await tool.isEnabled(this.context));
         const tools = enabled.map((tool) => tool.serialize());
         // derive responseType from agent.output
         let responseType;

package/dist/thread/utils.js

@@ -32,7 +32,7 @@ export function tevent(event) {
  * Check if an event is a tool call
  */
 export function isActionIntention(event) {
-    return event.kind === "tool-call";
+    return event.kind === "tool.call";
 }
 /**
  * Extract action intentions from a list of events.
@@ -50,8 +50,8 @@ export function notDelta(event) {
     switch (event.kind) {
         case "message":
         case "reasoning":
-        case "tool-call":
-        case "tool-result":
+        case "tool.call":
+        case "tool.result":
             return true;
         // all other events are streaming deltas/control events
         default:
@@ -66,8 +66,8 @@ export function isPublicEvent(event) {
     switch (event.kind) {
         case "message":
         case "reasoning":
-        case "tool-call":
-        case "tool-result":
+        case "tool.call":
+        case "tool.result":
             return true;
         case "system":
             return false;

package/dist/tool/__tests__/tool.test.js

@@ -138,7 +138,7 @@ describe("FunctionTool", () => {
     describe("isEnabled", () => {
         it("should default to enabled", async () => {
             const ctx = mockContext();
-            const enabled = await simpleStringTool.isEnabled(ctx, null);
+            const enabled = await simpleStringTool.isEnabled(ctx);
             expect(enabled).toBe(true);
         });
         it("should evaluate boolean isEnabled", async () => {
@@ -150,7 +150,7 @@ describe("FunctionTool", () => {
                 execute: async () => "result",
             });
             const ctx = mockContext();
-            const enabled = await disabledTool.isEnabled(ctx, null);
+            const enabled = await disabledTool.isEnabled(ctx);
             expect(enabled).toBe(false);
         });
         it("should evaluate function isEnabled with typed context", async () => {
@@ -165,8 +165,8 @@ describe("FunctionTool", () => {
             });
             const enabledCtx = mockContext({ enabled: true });
             const disabledCtx = mockContext({ enabled: false });
-            expect(await conditionalTool.isEnabled(enabledCtx, null)).toBe(true);
-            expect(await conditionalTool.isEnabled(disabledCtx, null)).toBe(false);
+            expect(await conditionalTool.isEnabled(enabledCtx)).toBe(true);
+            expect(await conditionalTool.isEnabled(disabledCtx)).toBe(false);
         });
     });
 });

package/dist/tool/tool.d.ts

@@ -1,5 +1,4 @@
 import { Context, UnknownContext } from "../context.js";
-import type { BaseAgent } from "../agent/base.js";
 import { type LanguageModelTool } from "@kernl-sdk/protocol";
 import type { ToolConfig, ToolApprovalFunction, ToolEnabledFunction, ToolErrorFunction, ToolInputParameters, ToolResult } from "./types.js";
 /**
@@ -27,7 +26,7 @@ export declare abstract class BaseTool<TContext = UnknownContext> {
     /**
      * Determines whether the tool should be exposed to the model for the current run.
      */
-    abstract isEnabled(context: Context<TContext>, agent: BaseAgent<TContext>): Promise<boolean>;
+    abstract isEnabled(context: Context<TContext>): Promise<boolean>;
     /**
      * Serialize this tool for sending to the model
      */