kernl 0.11.1 → 0.11.2

package/.turbo/turbo-build.log

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

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @kernl/core
 
+## 0.11.2
+
+### Patch Changes
+
+- 47e44c0: Fix lifecycle event architecture: Thread now owns all lifecycle events and emits via agent for uniform observability
+  - Move thread.start/stop emissions from Kernl to Thread.stream()
+  - Both agent.on() and kernl.on() now receive all lifecycle events
+  - Remove redundant outcome field from ThreadStopEvent (use result/error instead)
+  - Fix: schedule() was missing thread events, agent.on("thread.\*") never fired
+
 ## 0.11.1
 
 ### Patch Changes

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;IA2C/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;IAwCnC;;;;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,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"}

package/dist/kernl/kernl.js

@@ -68,39 +68,8 @@ export class Kernl extends KernlHooks {
      */
     async spawn(thread) {
         this.athreads.set(thread.tid, thread);
-        this.emit("thread.start", {
-            kind: "thread.start",
-            threadId: thread.tid,
-            agentId: thread.agent.id,
-            namespace: thread.namespace,
-            context: thread.context,
-        });
         try {
-            const result = await thread.execute();
-            this.emit("thread.stop", {
-                kind: "thread.stop",
-                threadId: thread.tid,
-                agentId: thread.agent.id,
-                namespace: thread.namespace,
-                context: thread.context,
-                state: thread.state,
-                outcome: "success",
-                result: result.response,
-            });
-            return result;
-        }
-        catch (err) {
-            this.emit("thread.stop", {
-                kind: "thread.stop",
-                threadId: thread.tid,
-                agentId: thread.agent.id,
-                namespace: thread.namespace,
-                context: thread.context,
-                state: thread.state,
-                outcome: "error",
-                error: err instanceof Error ? err.message : String(err),
-            });
-            throw err;
+            return await thread.execute();
         }
         finally {
             this.athreads.delete(thread.tid);
@@ -127,37 +96,8 @@ export class Kernl extends KernlHooks {
      */
     async *spawnStream(thread) {
         this.athreads.set(thread.tid, thread);
-        this.emit("thread.start", {
-            kind: "thread.start",
-            threadId: thread.tid,
-            agentId: thread.agent.id,
-            namespace: thread.namespace,
-            context: thread.context,
-        });
         try {
             yield* thread.stream();
-            this.emit("thread.stop", {
-                kind: "thread.stop",
-                threadId: thread.tid,
-                agentId: thread.agent.id,
-                namespace: thread.namespace,
-                context: thread.context,
-                state: thread.state,
-                outcome: "success",
-            });
-        }
-        catch (err) {
-            this.emit("thread.stop", {
-                kind: "thread.stop",
-                threadId: thread.tid,
-                agentId: thread.agent.id,
-                namespace: thread.namespace,
-                context: thread.context,
-                state: thread.state,
-                outcome: "error",
-                error: err instanceof Error ? err.message : String(err),
-            });
-            throw err;
         }
         finally {
             this.athreads.delete(thread.tid);

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

@@ -35,7 +35,7 @@ describe("Lifecycle Hooks", () => {
             expect(events[0].threadId).toBeDefined();
             expect(events[0].context).toBeDefined();
         });
-        it("emits thread.stop with outcome=success on successful run", async () => {
+        it("emits thread.stop with result on successful run", async () => {
             const events = [];
             const model = createMockModel(async () => ({
                 content: [message({ role: "assistant", text: "Done" })],
@@ -58,12 +58,11 @@ describe("Lifecycle Hooks", () => {
                 kind: "thread.stop",
                 agentId: "test-agent",
                 namespace: "kernl",
-                outcome: "success",
                 state: "stopped",
                 result: "Done",
             });
         });
-        it("emits thread.stop with outcome=error on failure", async () => {
+        it("emits thread.stop with error on failure", async () => {
             const events = [];
             const model = createMockModel(async () => {
                 throw new Error("Model exploded");
@@ -82,7 +81,6 @@ describe("Lifecycle Hooks", () => {
             expect(events[0]).toMatchObject({
                 kind: "thread.stop",
                 agentId: "test-agent",
-                outcome: "error",
                 error: "Model exploded",
             });
         });
@@ -112,6 +110,41 @@ describe("Lifecycle Hooks", () => {
             expect(kernlEvents).toHaveLength(1);
             expect(agentEvents[0].threadId).toBe(kernlEvents[0].threadId);
         });
+        it("agent.on receives thread events (emitted by Thread via agent.emit)", async () => {
+            const agentStartEvents = [];
+            const agentStopEvents = [];
+            const kernlStartEvents = [];
+            const kernlStopEvents = [];
+            const model = createMockModel(async () => ({
+                content: [message({ role: "assistant", text: "Done" })],
+                finishReason: "stop",
+                usage: { inputTokens: 2, outputTokens: 2, totalTokens: 4 },
+                warnings: [],
+            }));
+            const agent = new Agent({
+                id: "test-agent",
+                name: "Test",
+                instructions: "Test",
+                model,
+            });
+            const kernl = new Kernl();
+            kernl.register(agent);
+            // Thread events should be receivable via both agent.on and kernl.on
+            agent.on("thread.start", (e) => agentStartEvents.push(e));
+            agent.on("thread.stop", (e) => agentStopEvents.push(e));
+            kernl.on("thread.start", (e) => kernlStartEvents.push(e));
+            kernl.on("thread.stop", (e) => kernlStopEvents.push(e));
+            await agent.run("Hello");
+            // Both agent and kernl should receive thread events
+            expect(agentStartEvents).toHaveLength(1);
+            expect(agentStopEvents).toHaveLength(1);
+            expect(kernlStartEvents).toHaveLength(1);
+            expect(kernlStopEvents).toHaveLength(1);
+            // Same event data
+            expect(agentStartEvents[0].threadId).toBe(kernlStartEvents[0].threadId);
+            expect(agentStopEvents[0].threadId).toBe(kernlStopEvents[0].threadId);
+            expect(agentStopEvents[0].result).toBeDefined();
+        });
     });
     describe("Model events", () => {
         it("emits model.call.start before generation", async () => {

package/dist/lifecycle.d.ts

@@ -54,15 +54,11 @@ export interface ThreadStopEvent<TContext = unknown, TOutput = unknown> {
      */
     state: ThreadState;
     /**
-     * The outcome of the execution.
-     */
-    outcome: "success" | "error" | "cancelled";
-    /**
-     * The result if outcome is "success".
+     * The result of execution (present on success).
      */
     result?: TOutput;
     /**
-     * Error message if outcome is "error".
+     * Error message (present on error).
      */
     error?: string;
 }

package/dist/lifecycle.d.ts.map

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

package/dist/thread/thread.d.ts

@@ -61,6 +61,7 @@ export declare class Thread<TContext = unknown, TOutput extends AgentOutputType
     private cpbuf;
     private persisted;
     private history;
+    private tickres?;
     private abort?;
     private storage?;
     constructor(options: ThreadOptions<TContext, TOutput>);
@@ -70,6 +71,11 @@ export declare class Thread<TContext = unknown, TOutput extends AgentOutputType
     execute(): Promise<ThreadExecuteResult<ResolvedAgentResponse<TOutput>>>;
     /**
      * Streaming execution - returns async iterator of events
+     *
+     * All runs (new or resumed) emit:
+     *   - Exactly one thread.start
+     *   - Zero or more model.call.* and tool.call.*
+     *   - Exactly one thread.stop (with result on success, error on failure)
      */
     stream(): AsyncIterable<ThreadStreamEvent>;
     /**
@@ -104,7 +110,7 @@ export declare class Thread<TContext = unknown, TOutput extends AgentOutputType
     /**
      * Cancel the running thread
      *
-     * TODO: Emit thread.stop with outcome: 'cancelled' when cancelled
+     * TODO: Emit thread.stop when cancelled (neither result nor error set)
      */
     cancel(): void;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/thread/thread.ts"],"names":[],"mappings":"AAIA,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,EAKd,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,eAAe,EAAE,MAAM,eAAe,CAAC;AAWrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,MAAM,CACjB,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,eAAe,GAAG,MAAM;IAExC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,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,OAAO,CAAC;IAgCrD;;OAEG;IACG,OAAO,IAAI,OAAO,CACtB,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CACpD;IAoBD;;OAEG;IACI,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAuBjD;;;;;OAKG;YACY,QAAQ;IAgEvB;;;;;OAKG;YACY,IAAI;IAoEnB;;;;;OAKG;YACW,UAAU;IAuCxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE;IAiBnD;;;;OAIG;IACH,MAAM;IAQN;;OAEG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,YAAY;IAkF1B;;OAEG;YACW,mBAAmB;CAsDlC"}
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/thread/thread.ts"],"names":[],"mappings":"AAIA,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,EAKd,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,eAAe,EAAE,MAAM,eAAe,CAAC;AAWrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,MAAM,CACjB,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,eAAe,GAAG,MAAM;IAExC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,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;IACvF,OAAO,CAAC,OAAO,CAAC,CAAiC;IAEjD,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAc;gBAElB,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC;IAgCrD;;OAEG;IACG,OAAO,IAAI,OAAO,CACtB,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CACpD;IAQD;;;;;;;OAOG;IACI,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAmDjD;;;;;OAKG;YACY,QAAQ;IAiEvB;;;;;OAKG;YACY,IAAI;IAoEnB;;;;;OAKG;YACW,UAAU;IAuCxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE;IAiBnD;;;;OAIG;IACH,MAAM;IAQN;;OAEG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,YAAY;IAkF1B;;OAEG;YACW,mBAAmB;CAsDlC"}

package/dist/thread/thread.js

@@ -63,6 +63,7 @@ export class Thread {
     cpbuf; /* checkpoint buffer - events pending persistence */
     persisted; /* indicates thread was hydrated from storage */
     history;
+    tickres; /* final result from terminal tick */
     abort;
     storage;
     constructor(options) {
@@ -100,20 +101,16 @@ export class Thread {
         for await (const _event of this.stream()) {
             // just consume the stream (already in history in _execute())
         }
-        // filter for language model items
-        const items = this.history
-            .filter((e) => e.kind !== "system")
-            .map((e) => {
-            const { tid, seq, timestamp, metadata, ...item } = e;
-            return item;
-        });
-        const text = getFinalResponse(items);
-        assert(text, "_execute continues until text !== null"); // (TODO): consider preventing infinite loops here
-        const parsed = parseFinalResponse(text, this.agent.output);
-        return { response: parsed, state: this.state };
+        assert(this.tickres, "_execute continues until tickres is set");
+        return { response: this.tickres, state: this.state };
     }
     /**
      * Streaming execution - returns async iterator of events
+     *
+     * All runs (new or resumed) emit:
+     *   - Exactly one thread.start
+     *   - Zero or more model.call.* and tool.call.*
+     *   - Exactly one thread.stop (with result on success, error on failure)
      */
     async *stream() {
         if (this.state === RUNNING && this.abort) {
@@ -121,12 +118,38 @@ export class Thread {
         }
         this.state = RUNNING;
         this.abort = new AbortController();
+        this.tickres = undefined; // reset for this run
         await this.checkpoint(); /* c1: persist RUNNING state + initial input */
+        this.agent.emit("thread.start", {
+            kind: "thread.start",
+            threadId: this.tid,
+            agentId: this.agent.id,
+            namespace: this.namespace,
+            context: this.context,
+        });
         yield { kind: "stream-start" }; // always yield start immediately
         try {
             yield* this._execute();
+            this.agent.emit("thread.stop", {
+                kind: "thread.stop",
+                threadId: this.tid,
+                agentId: this.agent.id,
+                namespace: this.namespace,
+                context: this.context,
+                state: STOPPED,
+                result: this.tickres,
+            });
         }
         catch (err) {
+            this.agent.emit("thread.stop", {
+                kind: "thread.stop",
+                threadId: this.tid,
+                agentId: this.agent.id,
+                namespace: this.namespace,
+                context: this.context,
+                state: STOPPED,
+                error: err instanceof Error ? err.message : String(err),
+            });
             throw err;
         }
         finally {
@@ -170,6 +193,7 @@ export class Thread {
                 const text = getFinalResponse(events);
                 if (!text)
                     continue; // run again, policy-dependent? (how to ensure no infinite loop here?)
+                this.tickres = parseFinalResponse(text, this.agent.output);
                 await this.checkpoint(); /* c2: terminal tick - no tool calls */
                 // await this.agent.runOutputGuardails(context, state);
                 // this.kernl.emit("thread.terminated", context, output);
@@ -327,7 +351,7 @@ export class Thread {
     /**
      * Cancel the running thread
      *
-     * TODO: Emit thread.stop with outcome: 'cancelled' when cancelled
+     * TODO: Emit thread.stop when cancelled (neither result nor error set)
      */
     cancel() {
         this.abort?.abort();

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,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,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;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,eAAe,EAChE,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,qBAAqB,CAAC,OAAO,CAAC,CAsBhC"}
+{"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,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,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,CAa1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,eAAe,EAChE,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,qBAAqB,CAAC,OAAO,CAAC,CAsBhC"}

package/dist/thread/utils.js

@@ -80,11 +80,10 @@ export function isPublicEvent(event) {
  * Returns null if no assistant message with text content is found.
  */
 export function getFinalResponse(items) {
-    // Scan backwards for the last assistant message
+    // scan backwards for the last assistant message
     for (let i = items.length - 1; i >= 0; i--) {
         const item = items[i];
         if (item.kind === "message" && item.role === "assistant") {
-            // Extract text from content parts
             for (const part of item.content) {
                 if (part.kind === "text") {
                     return part.text;
@@ -120,6 +119,6 @@ export function parseFinalResponse(text, output) {
             throw new ModelBehaviorError(`Failed to parse structured output: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    // Fallback - should not reach here
+    // fallback - should not reach here
     return text;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kernl",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "A modern AI agent framework",
   "keywords": [
     "kernl",
@@ -34,9 +34,9 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.2",
     "yaml": "^2.8.2",
-    "@kernl-sdk/protocol": "0.4.1",
     "@kernl-sdk/retrieval": "0.1.7",
-    "@kernl-sdk/shared": "^0.3.1"
+    "@kernl-sdk/shared": "^0.3.1",
+    "@kernl-sdk/protocol": "0.4.1"
   },
   "peerDependencies": {
     "zod": "^4.1.8"

package/src/kernl/kernl.ts

@@ -102,42 +102,8 @@ export class Kernl extends KernlHooks {
     thread: Thread<TContext, TOutput>,
   ): Promise<ThreadExecuteResult<ResolvedAgentResponse<TOutput>>> {
     this.athreads.set(thread.tid, thread);
-
-    this.emit("thread.start", {
-      kind: "thread.start",
-      threadId: thread.tid,
-      agentId: thread.agent.id,
-      namespace: thread.namespace,
-      context: thread.context,
-    });
-
     try {
-      const result = await thread.execute();
-
-      this.emit("thread.stop", {
-        kind: "thread.stop",
-        threadId: thread.tid,
-        agentId: thread.agent.id,
-        namespace: thread.namespace,
-        context: thread.context,
-        state: thread.state,
-        outcome: "success",
-        result: result.response,
-      });
-
-      return result;
-    } catch (err) {
-      this.emit("thread.stop", {
-        kind: "thread.stop",
-        threadId: thread.tid,
-        agentId: thread.agent.id,
-        namespace: thread.namespace,
-        context: thread.context,
-        state: thread.state,
-        outcome: "error",
-        error: err instanceof Error ? err.message : String(err),
-      });
-      throw err;
+      return await thread.execute();
     } finally {
       this.athreads.delete(thread.tid);
     }
@@ -168,39 +134,8 @@ export class Kernl extends KernlHooks {
     thread: Thread<TContext, TOutput>,
   ): AsyncIterable<ThreadStreamEvent> {
     this.athreads.set(thread.tid, thread);
-
-    this.emit("thread.start", {
-      kind: "thread.start",
-      threadId: thread.tid,
-      agentId: thread.agent.id,
-      namespace: thread.namespace,
-      context: thread.context,
-    });
-
     try {
       yield* thread.stream();
-
-      this.emit("thread.stop", {
-        kind: "thread.stop",
-        threadId: thread.tid,
-        agentId: thread.agent.id,
-        namespace: thread.namespace,
-        context: thread.context,
-        state: thread.state,
-        outcome: "success",
-      });
-    } catch (err) {
-      this.emit("thread.stop", {
-        kind: "thread.stop",
-        threadId: thread.tid,
-        agentId: thread.agent.id,
-        namespace: thread.namespace,
-        context: thread.context,
-        state: thread.state,
-        outcome: "error",
-        error: err instanceof Error ? err.message : String(err),
-      });
-      throw err;
     } finally {
       this.athreads.delete(thread.tid);
     }

package/src/lifecycle/__tests__/hooks.test.ts

@@ -54,7 +54,7 @@ describe("Lifecycle Hooks", () => {
       expect(events[0].context).toBeDefined();
     });
 
-    it("emits thread.stop with outcome=success on successful run", async () => {
+    it("emits thread.stop with result on successful run", async () => {
       const events: ThreadStopEvent[] = [];
 
       const model = createMockModel(async () => ({
@@ -83,13 +83,12 @@ describe("Lifecycle Hooks", () => {
         kind: "thread.stop",
         agentId: "test-agent",
         namespace: "kernl",
-        outcome: "success",
         state: "stopped",
         result: "Done",
       });
     });
 
-    it("emits thread.stop with outcome=error on failure", async () => {
+    it("emits thread.stop with error on failure", async () => {
       const events: ThreadStopEvent[] = [];
 
       const model = createMockModel(async () => {
@@ -114,7 +113,6 @@ describe("Lifecycle Hooks", () => {
       expect(events[0]).toMatchObject({
         kind: "thread.stop",
         agentId: "test-agent",
-        outcome: "error",
         error: "Model exploded",
       });
     });
@@ -151,6 +149,49 @@ describe("Lifecycle Hooks", () => {
       expect(kernlEvents).toHaveLength(1);
       expect(agentEvents[0].threadId).toBe(kernlEvents[0].threadId);
     });
+
+    it("agent.on receives thread events (emitted by Thread via agent.emit)", async () => {
+      const agentStartEvents: ThreadStartEvent[] = [];
+      const agentStopEvents: ThreadStopEvent[] = [];
+      const kernlStartEvents: ThreadStartEvent[] = [];
+      const kernlStopEvents: ThreadStopEvent[] = [];
+
+      const model = createMockModel(async () => ({
+        content: [message({ role: "assistant", text: "Done" })],
+        finishReason: "stop",
+        usage: { inputTokens: 2, outputTokens: 2, totalTokens: 4 },
+        warnings: [],
+      }));
+
+      const agent = new Agent({
+        id: "test-agent",
+        name: "Test",
+        instructions: "Test",
+        model,
+      });
+
+      const kernl = new Kernl();
+      kernl.register(agent);
+
+      // Thread events should be receivable via both agent.on and kernl.on
+      agent.on("thread.start", (e) => agentStartEvents.push(e));
+      agent.on("thread.stop", (e) => agentStopEvents.push(e));
+      kernl.on("thread.start", (e) => kernlStartEvents.push(e));
+      kernl.on("thread.stop", (e) => kernlStopEvents.push(e));
+
+      await agent.run("Hello");
+
+      // Both agent and kernl should receive thread events
+      expect(agentStartEvents).toHaveLength(1);
+      expect(agentStopEvents).toHaveLength(1);
+      expect(kernlStartEvents).toHaveLength(1);
+      expect(kernlStopEvents).toHaveLength(1);
+
+      // Same event data
+      expect(agentStartEvents[0].threadId).toBe(kernlStartEvents[0].threadId);
+      expect(agentStopEvents[0].threadId).toBe(kernlStopEvents[0].threadId);
+      expect(agentStopEvents[0].result).toBeDefined();
+    });
   });
 
   describe("Model events", () => {

package/src/lifecycle.ts

@@ -74,17 +74,12 @@ export interface ThreadStopEvent<TContext = unknown, TOutput = unknown> {
   state: ThreadState;
 
   /**
-   * The outcome of the execution.
-   */
-  outcome: "success" | "error" | "cancelled";
-
-  /**
-   * The result if outcome is "success".
+   * The result of execution (present on success).
    */
   result?: TOutput;
 
   /**
-   * Error message if outcome is "error".
+   * Error message (present on error).
    */
   error?: string;
 }

package/src/thread/thread.ts

@@ -107,6 +107,7 @@ export class Thread<
   private cpbuf: ThreadEvent[]; /* checkpoint buffer - events pending persistence */
   private persisted: boolean; /* indicates thread was hydrated from storage */
   private history: ThreadEvent[] /* history representing the event log for the thread */;
+  private tickres?: ResolvedAgentResponse<TOutput>; /* final result from terminal tick */
 
   private abort?: AbortController;
   private storage?: ThreadStore;
@@ -152,24 +153,17 @@ export class Thread<
     for await (const _event of this.stream()) {
       // just consume the stream (already in history in _execute())
     }
-
-    // filter for language model items
-    const items = this.history
-      .filter((e) => e.kind !== "system")
-      .map((e) => {
-        const { tid, seq, timestamp, metadata, ...item } = e;
-        return item as LanguageModelItem;
-      });
-
-    const text = getFinalResponse(items);
-    assert(text, "_execute continues until text !== null"); // (TODO): consider preventing infinite loops here
-    const parsed = parseFinalResponse(text, this.agent.output);
-
-    return { response: parsed, state: this.state };
+    assert(this.tickres, "_execute continues until tickres is set");
+    return { response: this.tickres, state: this.state };
   }
 
   /**
    * Streaming execution - returns async iterator of events
+   *
+   * All runs (new or resumed) emit:
+   *   - Exactly one thread.start
+   *   - Zero or more model.call.* and tool.call.*
+   *   - Exactly one thread.stop (with result on success, error on failure)
    */
   async *stream(): AsyncIterable<ThreadStreamEvent> {
     if (this.state === RUNNING && this.abort) {
@@ -178,14 +172,42 @@ export class Thread<
 
     this.state = RUNNING;
     this.abort = new AbortController();
+    this.tickres = undefined; // reset for this run
 
     await this.checkpoint(); /* c1: persist RUNNING state + initial input */
 
+    this.agent.emit("thread.start", {
+      kind: "thread.start",
+      threadId: this.tid,
+      agentId: this.agent.id,
+      namespace: this.namespace,
+      context: this.context,
+    });
+
     yield { kind: "stream-start" }; // always yield start immediately
 
     try {
       yield* this._execute();
+
+      this.agent.emit("thread.stop", {
+        kind: "thread.stop",
+        threadId: this.tid,
+        agentId: this.agent.id,
+        namespace: this.namespace,
+        context: this.context,
+        state: STOPPED,
+        result: this.tickres,
+      });
     } catch (err) {
+      this.agent.emit("thread.stop", {
+        kind: "thread.stop",
+        threadId: this.tid,
+        agentId: this.agent.id,
+        namespace: this.namespace,
+        context: this.context,
+        state: STOPPED,
+        error: err instanceof Error ? err.message : String(err),
+      });
       throw err;
     } finally {
       this.state = STOPPED;
@@ -233,6 +255,7 @@ export class Thread<
         const text = getFinalResponse(events);
         if (!text) continue; // run again, policy-dependent? (how to ensure no infinite loop here?)
 
+        this.tickres = parseFinalResponse(text, this.agent.output);
         await this.checkpoint(); /* c2: terminal tick - no tool calls */
 
         // await this.agent.runOutputGuardails(context, state);
@@ -410,7 +433,7 @@ export class Thread<
   /**
    * Cancel the running thread
    *
-   * TODO: Emit thread.stop with outcome: 'cancelled' when cancelled
+   * TODO: Emit thread.stop when cancelled (neither result nor error set)
    */
   cancel() {
     this.abort?.abort();

package/src/thread/utils.ts

@@ -113,11 +113,10 @@ export function isPublicEvent(event: ThreadEvent): event is PublicThreadEvent {
  * Returns null if no assistant message with text content is found.
  */
 export function getFinalResponse(items: LanguageModelItem[]): string | null {
-  // Scan backwards for the last assistant message
+  // scan backwards for the last assistant message
   for (let i = items.length - 1; i >= 0; i--) {
     const item = items[i];
     if (item.kind === "message" && item.role === "assistant") {
-      // Extract text from content parts
       for (const part of item.content) {
         if (part.kind === "text") {
           return part.text;
@@ -161,6 +160,6 @@ export function parseFinalResponse<TOutput extends AgentOutputType>(
     }
   }
 
-  // Fallback - should not reach here
+  // fallback - should not reach here
   return text as ResolvedAgentResponse<TOutput>;
 }