kernl 0.9.1 → 0.11.0

package/dist/lifecycle.d.ts

@@ -1,133 +1,235 @@
-import { EventEmitter } from "node:events";
-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 EventEmitterEvents = Record<string, any[]>;
+import { Emitter } from "@kernl-sdk/shared";
+import type { LanguageModelUsage, LanguageModelFinishReason, LanguageModelRequestSettings, ToolCallState } from "@kernl-sdk/protocol";
+import type { Context } from "./context.js";
+import type { ThreadState } from "./thread/types.js";
 /**
- * Generic typed event emitter that wraps Node's EventEmitter with type safety
+ * Emitted when a thread starts execution.
  */
-declare class TypedEventEmitter<EventTypes extends EventEmitterEvents = Record<string, any[]>> extends EventEmitter {
-    on<K extends keyof EventTypes>(event: K, listener: (...args: EventTypes[K]) => void): this;
-    on(event: string | symbol, listener: (...args: any[]) => void): this;
-    off<K extends keyof EventTypes>(event: K, listener: (...args: EventTypes[K]) => void): this;
-    off(event: string | symbol, listener: (...args: any[]) => void): this;
-    emit<K extends keyof EventTypes>(event: K, ...args: EventTypes[K]): boolean;
-    emit(event: string | symbol, ...args: any[]): boolean;
-    once<K extends keyof EventTypes>(event: K, listener: (...args: EventTypes[K]) => void): this;
-    once(event: string | symbol, listener: (...args: any[]) => void): this;
+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;
+}
+/**
+ * Emitted when a model call starts.
+ */
+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>;
+}
+/**
+ * Emitted when a model call ends.
+ */
+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>;
 }
-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;
-        }
-    ];
-};
 /**
- * Event emitter that every Agent instance inherits from and that emits events for the lifecycle
- * of the agent.
+ * Emitted when a tool call ends.
  */
-export declare class AgentHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends TypedEventEmitter<AgentHookEvents<TContext, TOutput>> {
+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>;
 /**
- * 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.
+ * Event map for agent-level lifecycle hooks (typed).
  */
-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 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 TypedEventEmitter<KernlHookEvents<TContext, TOutput>> {
+export declare class KernlHooks extends Emitter<KernlHookEvents> {
 }
-export {};
 //# 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,29 +1,11 @@
-import { EventEmitter } from "node:events";
+import { Emitter } from "@kernl-sdk/shared";
 /**
- * Generic typed event emitter that wraps Node's EventEmitter with type safety
+ * Event emitter for agent-level lifecycle events.
  */
-class TypedEventEmitter extends EventEmitter {
-    on(event, listener) {
-        return super.on(event, listener);
-    }
-    off(event, listener) {
-        return super.off(event, listener);
-    }
-    emit(event, ...args) {
-        return super.emit(event, ...args);
-    }
-    once(event, listener) {
-        return super.once(event, listener);
-    }
+export class AgentHooks extends Emitter {
 }
 /**
- * Event emitter that every Agent instance inherits from and that emits events for the lifecycle
- * of the agent.
+ * Event emitter for Kernl-level lifecycle events.
  */
-export class AgentHooks extends TypedEventEmitter {
-}
-/**
- * Event emitter that the kernl uses to emit events for the lifecycle of every agent run.
- */
-export class KernlHooks extends TypedEventEmitter {
+export class KernlHooks extends Emitter {
 }

package/dist/memory/memory.js

@@ -68,7 +68,7 @@ export class Memory {
         return this._search.query({
             query: [{ text: q.query, tvec: tvec ?? undefined }],
             filter: q.filter ? MEMORY_FILTER.encode(q.filter) : undefined,
-            topK: q.limit ?? 20,
+            limit: q.limit ?? 20,
         });
     }
     /**

package/dist/realtime/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./types.js";
-export * from "./channel.js";
 export * from "./agent.js";
 export * from "./session.js";
+export * from "./transport.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/realtime/index.js

@@ -1,4 +1,4 @@
 export * from "./types.js";
-export * from "./channel.js";
 export * from "./agent.js";
 export * from "./session.js";
+export * from "./transport.js";

package/dist/realtime/session.d.ts

@@ -1,16 +1,25 @@
-import { EventEmitter } from "node:events";
-import { RealtimeModel } from "@kernl-sdk/protocol";
+import { Emitter } from "@kernl-sdk/shared";
+import { RealtimeModel, RealtimeServerEvent, RealtimeChannel, TransportStatus } from "@kernl-sdk/protocol";
 import { Context, UnknownContext } from "../context.js";
 import { RealtimeAgent } from "./agent.js";
-import type { RealtimeChannel } from "./channel.js";
 import type { RealtimeSessionOptions } from "./types.js";
+/**
+ * Events emitted by a realtime session.
+ */
+export type RealtimeSessionEvents = {
+    audio: [event: RealtimeServerEvent];
+    transcript: [event: RealtimeServerEvent];
+    text: [event: RealtimeServerEvent];
+    error: [error: Error];
+    status: [status: TransportStatus];
+};
 /**
  * A realtime session manages the connection to a realtime model.
  *
  * Handles the bidirectional communication between an agent and a model,
  * including audio I/O (via channels), tool execution, and event routing.
  */
-export declare class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
+export declare class RealtimeSession<TContext = UnknownContext> extends Emitter<RealtimeSessionEvents> {
     /**
      * Session ID. Null until connected.
      */
@@ -48,24 +57,6 @@ export declare class RealtimeSession<TContext = UnknownContext> extends EventEmi
      * Initialize event listeners and send session configuration.
      */
     private init;
-    /**
-     * Build session configuration from agent.
-     */
-    private buildSessionConfig;
-    /**
-     * Handle incoming events from the connection.
-     *
-     * Maps protocol events to simplified user-facing events:
-     * - 'audio' - audio output from assistant
-     * - 'transcript' - speech transcriptions (user or assistant)
-     * - 'text' - text output from assistant
-     * - 'error' - errors
-     */
-    private onEvent;
-    /**
-     * Execute tool calls from the model.
-     */
-    private performActions;
     /**
      * Send audio to the model.
      */
@@ -94,5 +85,23 @@ export declare class RealtimeSession<TContext = UnknownContext> extends EventEmi
      * Close the session and release resources.
      */
     close(): void;
+    /**
+     * Build session configuration from agent.
+     */
+    private buildSessionConfig;
+    /**
+     * Handle incoming events from the connection.
+     *
+     * Maps protocol events to simplified user-facing events:
+     * - 'audio' - audio output from assistant
+     * - 'transcript' - speech transcriptions (user or assistant)
+     * - 'text' - text output from assistant
+     * - 'error' - errors
+     */
+    private onEvent;
+    /**
+     * Execute tool calls from the model.
+     */
+    private performActions;
 }
 //# sourceMappingURL=session.d.ts.map

package/dist/realtime/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/realtime/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACL,aAAa,EAMd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,eAAe,CAAC,QAAQ,GAAG,cAAc,CAAE,SAAQ,YAAY;IAC1E;;OAEG;IACH,EAAE,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAmC;IAErD;;OAEG;IACH,OAAO,CAAC,OAAO,CAAmC;gBAGhD,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC9B,OAAO,GAAE,sBAAsB,CAAC,QAAQ,CAAM;IAiBhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;OAEG;YACW,IAAI;IAalB;;OAEG;YACW,kBAAkB;IAUhC;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO;IAuCf;;OAEG;YACW,cAAc;IAyB5B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/realtime/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EACL,aAAa,EAEb,mBAAmB,EAEnB,eAAe,EAEf,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACpC,UAAU,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACzC,IAAI,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtB,MAAM,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,eAAe,CAC1B,QAAQ,GAAG,cAAc,CACzB,SAAQ,OAAO,CAAC,qBAAqB,CAAC;IACtC;;OAEG;IACH,EAAE,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAmC;IAErD;;OAEG;IACH,OAAO,CAAC,OAAO,CAAmC;gBAGhD,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC9B,OAAO,GAAE,sBAAsB,CAAC,QAAQ,CAAM;IAiBhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB9B;;OAEG;YACW,IAAI;IAalB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;YACW,kBAAkB;IAehC;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO;IAuCf;;OAEG;YACW,cAAc;CAwB7B"}