kernl 0.10.0 → 0.11.0

package/dist/lifecycle.d.ts

@@ -1,118 +1,235 @@
 import { Emitter } from "@kernl-sdk/shared";
-import { Agent } from "./agent.js";
-import { Context, UnknownContext } from "./context.js";
-import { Tool } from "./tool/index.js";
-import type { ToolCall } from "@kernl-sdk/protocol";
-import { AgentOutputType } from "./agent/types.js";
-import { TextOutput } from "./thread/types.js";
-export type AgentHookEvents<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> = {
-    /**
-     * @param context - The context of the run
-     */
-    agent_start: [context: Context<TContext>, agent: Agent<TContext, TOutput>];
-    /**
-     * @param context - The context of the run
-     * @param output - The output of the agent
-     */
-    agent_end: [context: Context<TContext>, output: string];
-    /**
-     * @param context - The context of the run
-     * @param agent - The agent that is starting a tool
-     * @param tool - The tool that is starting
-     */
-    agent_tool_start: [
-        context: Context<TContext>,
-        tool: Tool<any>,
-        details: {
-            toolCall: ToolCall;
-        }
-    ];
-    /**
-     * @param context - The context of the run
-     * @param agent - The agent that is ending a tool
-     * @param tool - The tool that is ending
-     * @param result - The result of the tool
-     */
-    agent_tool_end: [
-        context: Context<TContext>,
-        tool: Tool<any>,
-        result: string,
-        details: {
-            toolCall: ToolCall;
-        }
-    ];
-};
+import type { LanguageModelUsage, LanguageModelFinishReason, LanguageModelRequestSettings, ToolCallState } from "@kernl-sdk/protocol";
+import type { Context } from "./context.js";
+import type { ThreadState } from "./thread/types.js";
+/**
+ * Emitted when a thread starts execution.
+ */
+export interface ThreadStartEvent<TContext = unknown> {
+    readonly kind: "thread.start";
+    /**
+     * The thread ID.
+     */
+    threadId: string;
+    /**
+     * The agent executing this thread.
+     */
+    agentId: string;
+    /**
+     * The namespace of the thread.
+     */
+    namespace: string;
+    /**
+     * The context for this execution.
+     *
+     * NOTE: Includes `context.agent` reference for tools - may be optimized in future.
+     */
+    context: Context<TContext>;
+}
+/**
+ * Emitted when a thread stops execution.
+ */
+export interface ThreadStopEvent<TContext = unknown, TOutput = unknown> {
+    readonly kind: "thread.stop";
+    /**
+     * The thread ID.
+     */
+    threadId: string;
+    /**
+     * The agent that executed this thread.
+     */
+    agentId: string;
+    /**
+     * The namespace of the thread.
+     */
+    namespace: string;
+    /**
+     * The context for this execution.
+     *
+     * NOTE: Includes `context.agent` reference for tools - may be optimized in future.
+     */
+    context: Context<TContext>;
+    /**
+     * Final state of the thread.
+     */
+    state: ThreadState;
+    /**
+     * The outcome of the execution.
+     */
+    outcome: "success" | "error" | "cancelled";
+    /**
+     * The result if outcome is "success".
+     */
+    result?: TOutput;
+    /**
+     * Error message if outcome is "error".
+     */
+    error?: string;
+}
 /**
- * Event emitter that every Agent instance inherits from and that emits events for the lifecycle
- * of the agent.
+ * Emitted when a model call starts.
  */
-export declare class AgentHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends Emitter<AgentHookEvents<TContext, TOutput>> {
+export interface ModelCallStartEvent<TContext = unknown> {
+    readonly kind: "model.call.start";
+    /**
+     * The model provider.
+     */
+    provider: string;
+    /**
+     * The model ID.
+     */
+    modelId: string;
+    /**
+     * Request settings passed to the model.
+     */
+    settings: LanguageModelRequestSettings;
+    /**
+     * Thread ID if called within a thread context.
+     */
+    threadId?: string;
+    /**
+     * Agent ID if called within an agent context.
+     */
+    agentId?: string;
+    /**
+     * Execution context if available.
+     *
+     * NOTE: Includes `context.agent` reference for tools - may be optimized in future.
+     */
+    context?: Context<TContext>;
 }
 /**
- * Events emitted by the kernl during execution.
- *
- * Unlike AgentHookEvents (which are emitted by individual agents with implicit context),
- * KernlHookEvents explicitly include the agent reference in all events since it needs to
- * coordinate multiple agents and listeners need to know which agent triggered each event.
+ * Emitted when a model call ends.
  */
-export type KernlHookEvents<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> = {
-    /**
-     * @param context - The context of the run
-     * @param agent - The agent that is starting
-     */
-    agent_start: [context: Context<TContext>, agent: Agent<TContext, TOutput>];
-    /**
-     * @param context - The context of the run
-     * @param agent - The agent that is ending
-     * @param output - The output of the agent
-     */
-    agent_end: [
-        context: Context<TContext>,
-        agent: Agent<TContext, TOutput>,
-        output: string
-    ];
-    /**
-     * @param context - The context of the run
-     * @param fromAgent - The agent that is handing off
-     * @param toAgent - The next agent to run
-     */
-    agent_handoff: [
-        context: Context<TContext>,
-        fromAgent: Agent<any, any>,
-        toAgent: Agent<any, any>
-    ];
-    /**
-     * @param context - The context of the run
-     * @param agent - The agent that is starting a tool
-     * @param tool - The tool that is starting
-     */
-    agent_tool_start: [
-        context: Context<TContext>,
-        agent: Agent<TContext, TOutput>,
-        tool: Tool,
-        details: {
-            toolCall: ToolCall;
-        }
-    ];
-    /**
-     * @param context - The context of the run
-     * @param agent - The agent that is ending a tool
-     * @param tool - The tool that is ending
-     * @param result - The result of the tool
-     */
-    agent_tool_end: [
-        context: Context<TContext>,
-        agent: Agent<TContext, TOutput>,
-        tool: Tool,
-        result: string,
-        details: {
-            toolCall: ToolCall;
-        }
-    ];
+export interface ModelCallEndEvent<TContext = unknown> {
+    readonly kind: "model.call.end";
+    /**
+     * The model provider.
+     */
+    provider: string;
+    /**
+     * The model ID.
+     */
+    modelId: string;
+    /**
+     * Reason the model stopped generating.
+     */
+    finishReason: LanguageModelFinishReason;
+    /**
+     * Token usage for this call.
+     */
+    usage?: LanguageModelUsage;
+    /**
+     * Thread ID if called within a thread context.
+     */
+    threadId?: string;
+    /**
+     * Agent ID if called within an agent context.
+     */
+    agentId?: string;
+    /**
+     * Execution context if available.
+     *
+     * NOTE: Includes `context.agent` reference for tools - may be optimized in future.
+     */
+    context?: Context<TContext>;
+}
+/**
+ * Emitted when a tool call starts.
+ */
+export interface ToolCallStartEvent<TContext = unknown> {
+    readonly kind: "tool.call.start";
+    /**
+     * The thread ID.
+     */
+    threadId: string;
+    /**
+     * The agent executing this tool.
+     */
+    agentId: string;
+    /**
+     * The context for this execution.
+     *
+     * NOTE: Includes `context.agent` reference for tools - may be optimized in future.
+     */
+    context: Context<TContext>;
+    /**
+     * The tool being called.
+     */
+    toolId: string;
+    /**
+     * Unique identifier for this call.
+     */
+    callId: string;
+    /**
+     * Arguments passed to the tool (parsed JSON).
+     */
+    args: Record<string, unknown>;
+}
+/**
+ * Emitted when a tool call ends.
+ */
+export interface ToolCallEndEvent<TContext = unknown> {
+    readonly kind: "tool.call.end";
+    /**
+     * The thread ID.
+     */
+    threadId: string;
+    /**
+     * The agent that executed this tool.
+     */
+    agentId: string;
+    /**
+     * The context for this execution.
+     *
+     * NOTE: Includes `context.agent` reference for tools - may be optimized in future.
+     */
+    context: Context<TContext>;
+    /**
+     * The tool that was called.
+     */
+    toolId: string;
+    /**
+     * Unique identifier for this call.
+     */
+    callId: string;
+    /**
+     * Final state of the tool call.
+     */
+    state: ToolCallState;
+    /**
+     * Result if state is "completed".
+     */
+    result?: string;
+    /**
+     * Error message if state is "failed", null if successful.
+     */
+    error: string | null;
+}
+export type LifecycleEvent<TContext = unknown, TOutput = unknown> = ThreadStartEvent<TContext> | ThreadStopEvent<TContext, TOutput> | ModelCallStartEvent<TContext> | ModelCallEndEvent<TContext> | ToolCallStartEvent<TContext> | ToolCallEndEvent<TContext>;
+/**
+ * Event map for agent-level lifecycle hooks (typed).
+ */
+export type AgentHookEvents<TContext = unknown, TOutput = unknown> = {
+    "thread.start": [event: ThreadStartEvent<TContext>];
+    "thread.stop": [event: ThreadStopEvent<TContext, TOutput>];
+    "model.call.start": [event: ModelCallStartEvent<TContext>];
+    "model.call.end": [event: ModelCallEndEvent<TContext>];
+    "tool.call.start": [event: ToolCallStartEvent<TContext>];
+    "tool.call.end": [event: ToolCallEndEvent<TContext>];
 };
 /**
- * Event emitter that the kernl uses to emit events for the lifecycle of every agent run.
+ * Event map for Kernl-level lifecycle hooks (untyped).
+ */
+export type KernlHookEvents = AgentHookEvents<unknown, unknown>;
+/**
+ * Event emitter for agent-level lifecycle events.
+ */
+export declare class AgentHooks<TContext = unknown, TOutput = unknown> extends Emitter<AgentHookEvents<TContext, TOutput>> {
+}
+/**
+ * Event emitter for Kernl-level lifecycle events.
  */
-export declare class KernlHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends Emitter<KernlHookEvents<TContext, TOutput>> {
+export declare class KernlHooks extends Emitter<KernlHookEvents> {
 }
 //# sourceMappingURL=lifecycle.d.ts.map

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/lifecycle.js

@@ -1,12 +1,11 @@
 import { Emitter } from "@kernl-sdk/shared";
 /**
- * Event emitter that every Agent instance inherits from and that emits events for the lifecycle
- * of the agent.
+ * Event emitter for agent-level lifecycle events.
  */
 export class AgentHooks extends Emitter {
 }
 /**
- * Event emitter that the kernl uses to emit events for the lifecycle of every agent run.
+ * Event emitter for Kernl-level lifecycle events.
  */
 export class KernlHooks extends Emitter {
 }

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

@@ -275,7 +275,7 @@ describe("Thread", () => {
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
-                                arguments: "first",
+                                arguments: JSON.stringify({ value: "first" }),
                             },
                         ],
                         finishReason: "stop",
@@ -301,7 +301,7 @@ describe("Thread", () => {
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_2",
-                                arguments: "second",
+                                arguments: JSON.stringify({ value: "second" }),
                             },
                         ],
                         finishReason: "stop",

package/dist/thread/thread.d.ts

@@ -49,8 +49,8 @@ export declare class Thread<TContext = unknown, TOutput extends AgentOutputType
     readonly tid: string;
     readonly namespace: string;
     readonly agent: Agent<TContext, TOutput>;
-    readonly context: Context<TContext>;
-    readonly model: LanguageModel;
+    context: Context<TContext>;
+    model: LanguageModel;
     readonly parent: Task<TContext> | null;
     readonly createdAt: Date;
     readonly updatedAt: Date;

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,EAGd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAEV,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,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,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAIlD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,OAAO,CAAwE;IAEvF,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAc;gBAElB,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,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;IA8BnB;;;;;OAKG;YACW,UAAU;IAuCxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE;IAiBnD;;OAEG;IACH,MAAM;IAQN;;OAEG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,YAAY;IA4C1B;;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;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;;OAEG;IACH,MAAM;IAQN;;OAEG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,YAAY;IAkF1B;;OAEG;YACW,mBAAmB;CAsDlC"}

package/dist/thread/thread.js

@@ -143,14 +143,14 @@ export class Thread {
      */
     async *_execute() {
         for (;;) {
-            let err = false;
+            let err = undefined;
             if (this.abort?.signal.aborted) {
                 return;
             }
             const events = [];
             for await (const e of this.tick()) {
                 if (e.kind === "error") {
-                    err = true;
+                    err = e.error;
                     logger.error(e.error); // (TODO): onError callback in options
                 }
                 // we don't want deltas in the history
@@ -160,9 +160,9 @@ export class Thread {
                 }
                 yield e;
             }
-            // if an error event occurred → terminate
+            // if an error event occurred → throw it
             if (err) {
-                return;
+                throw err;
             }
             // if model returns a message with no action intentions → terminal state
             const intentions = getIntentions(events);
@@ -205,23 +205,57 @@ export class Thread {
         // (TODO): check limits (if this._tick > this.limits.maxTicks)
         // (TODO): run input guardrails on first tick (if this._tick === 1)
         const req = await this.prepareModelRequest(this.history);
+        this.agent.emit("model.call.start", {
+            kind: "model.call.start",
+            provider: this.model.provider,
+            modelId: this.model.modelId,
+            settings: req.settings ?? {},
+            threadId: this.tid,
+            agentId: this.agent.id,
+            context: this.context,
+        });
+        let usage;
+        let finishReason = "unknown";
         try {
             if (this.model.stream) {
-                const stream = this.model.stream(req);
-                for await (const event of stream) {
-                    yield event; // [text-delta, tool-call, message, reasoning, ...]
+                for await (const event of this.model.stream(req)) {
+                    if (event.kind === "finish") {
+                        usage = event.usage;
+                        finishReason = event.finishReason;
+                    }
+                    yield event;
                 }
             }
             else {
                 // fallback: blocking generate, yield events as batch
                 const res = await this.model.generate(req);
+                usage = res.usage;
+                finishReason = res.finishReason;
                 for (const event of res.content) {
                     yield event;
                 }
-                // (TODO): this.stats.usage.add(res.usage)
             }
+            this.agent.emit("model.call.end", {
+                kind: "model.call.end",
+                provider: this.model.provider,
+                modelId: this.model.modelId,
+                finishReason,
+                usage,
+                threadId: this.tid,
+                agentId: this.agent.id,
+                context: this.context,
+            });
         }
         catch (error) {
+            this.agent.emit("model.call.end", {
+                kind: "model.call.end",
+                provider: this.model.provider,
+                modelId: this.model.modelId,
+                finishReason: "error",
+                threadId: this.tid,
+                agentId: this.agent.id,
+                context: this.context,
+            });
             yield {
                 kind: "error",
                 error: error instanceof Error ? error : new Error(String(error)),
@@ -343,6 +377,16 @@ export class Thread {
      */
     async executeTools(calls) {
         return await Promise.all(calls.map(async (call) => {
+            const parsedArgs = JSON.parse(call.arguments || "{}");
+            this.agent.emit("tool.call.start", {
+                kind: "tool.call.start",
+                threadId: this.tid,
+                agentId: this.agent.id,
+                context: this.context,
+                toolId: call.toolId,
+                callId: call.callId,
+                args: parsedArgs,
+            });
             try {
                 const tool = this.agent.tool(call.toolId);
                 if (!tool) {
@@ -356,6 +400,19 @@ export class Thread {
                 ctx.agent = this.agent;
                 ctx.approve(call.callId); // mark this call as approved
                 const res = await tool.invoke(ctx, call.arguments, call.callId);
+                this.agent.emit("tool.call.end", {
+                    kind: "tool.call.end",
+                    threadId: this.tid,
+                    agentId: this.agent.id,
+                    context: this.context,
+                    toolId: call.toolId,
+                    callId: call.callId,
+                    state: res.state,
+                    result: typeof res.result === "string"
+                        ? res.result
+                        : JSON.stringify(res.result),
+                    error: res.error,
+                });
                 return {
                     kind: "tool-result",
                     callId: call.callId,
@@ -366,6 +423,16 @@ export class Thread {
                 };
             }
             catch (error) {
+                this.agent.emit("tool.call.end", {
+                    kind: "tool.call.end",
+                    threadId: this.tid,
+                    agentId: this.agent.id,
+                    context: this.context,
+                    toolId: call.toolId,
+                    callId: call.callId,
+                    state: FAILED,
+                    error: error instanceof Error ? error.message : String(error),
+                });
                 return {
                     kind: "tool-result",
                     callId: call.callId,

package/dist/thread/types.d.ts

@@ -124,7 +124,7 @@ export interface ThreadOptions<TContext = unknown, TOutput extends AgentOutputTy
  * Options passed to agent.execute() and agent.stream().
  */
 export interface ThreadExecuteOptions<TContext> {
-    context?: Context<TContext>;
+    context?: TContext;
     model?: LanguageModel;
     task?: Task<TContext>;
     threadId?: string;

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kernl",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "A modern AI agent framework",
   "keywords": [
     "kernl",
@@ -34,8 +34,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.2",
     "yaml": "^2.8.2",
-    "@kernl-sdk/protocol": "0.4.0",
-    "@kernl-sdk/retrieval": "0.1.6",
+    "@kernl-sdk/protocol": "0.4.1",
+    "@kernl-sdk/retrieval": "0.1.7",
     "@kernl-sdk/shared": "^0.3.1"
   },
   "peerDependencies": {
@@ -48,7 +48,7 @@
     "typescript": "5.9.2",
     "vitest": "^4.0.8",
     "zod": "^4.1.8",
-    "@kernl-sdk/ai": "0.3.3"
+    "@kernl-sdk/ai": "0.3.4"
   },
   "scripts": {
     "clean": "rm -rf dist",

package/src/agent/base.ts

@@ -4,7 +4,7 @@ import type { Context, UnknownContext } from "@/context";
 import type { Tool, BaseToolkit } from "@/tool";
 import { memory } from "@/tool";
 import { MisconfiguredError } from "@/lib/error";
-import { AgentHooks } from "@/lifecycle";
+import { AgentHooks, type AgentHookEvents } from "@/lifecycle";
 import type { Kernl } from "@/kernl";
 import type {
   AgentMemoryCreate,
@@ -101,6 +101,18 @@ export abstract class BaseAgent<
     }
   }
 
+  /**
+   * Emit a lifecycle event to agent and kernl listeners.
+   */
+  emit<K extends keyof AgentHookEvents<TContext, TOutput>>(
+    event: K,
+    ...args: AgentHookEvents<TContext, TOutput>[K]
+  ): boolean {
+    const result = super.emit(event, ...args);
+    this.kernl?.emit(event, ...(args as any));
+    return result;
+  }
+
   /**
    * Get a specific tool by ID from systools and toolkits.
    */