kernl 0.1.3 → 0.2.0

package/.turbo/turbo-build.log

@@ -1,4 +1,5 @@
-
-> kernl@0.1.3 build /Users/andjones/Documents/projects/kernl/packages/kernl
-> tsc && tsc-alias
-
+
+
+> kernl@0.1.4 build /Users/andjones/Documents/projects/kernl/packages/kernl
+> tsc && tsc-alias
+

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @kernl/core
 
+## 0.2.0
+
+### Minor Changes
+
+- 91b1285: Add agent.run() and agent.stream() convenience methods for thread execution. Kernl now mediates all thread lifecycle with spawn/schedule methods.
+- fffa89e: Refactor thread execution to support streaming and fix tool schema serialization. Adds new `stream()` method for async iteration over thread events, fixes tool parameter schemas to use JSON Schema instead of raw Zod schemas.
+
+### Patch Changes
+
+- Updated dependencies [fffa89e]
+  - @kernl-sdk/protocol@0.2.0
+
+## 0.1.4
+
+### Patch Changes
+
+- Add description field to Toolkit base class and implementations
+
 ## 0.1.3
 
 ### Patch Changes

package/dist/agent.d.ts

@@ -2,17 +2,20 @@ import { LanguageModel, LanguageModelRequestSettings } from "@kernl-sdk/protocol
 import type { Context, UnknownContext } from "./context";
 import { InputGuardrail, OutputGuardrail } from "./guardrail";
 import { AgentHooks } from "./lifecycle";
-import { Toolkit } from "./tool/toolkit";
+import { BaseToolkit } from "./tool/toolkit";
 import { Tool } from "./tool";
 import type { AgentConfig, AgentResponseType } from "./types/agent";
-import { TextResponse } from "./types/thread";
+import type { TextResponse, ThreadOptions, ThreadExecuteResult, ThreadStreamEvent } from "./types/thread";
+import type { Kernl } from "./kernl";
+import type { ResolvedAgentResponse } from "./guardrail";
 export declare class Agent<TContext = UnknownContext, TResponse extends AgentResponseType = TextResponse> extends AgentHooks<TContext, TResponse> implements AgentConfig<TContext, TResponse> {
+    private kernl?;
     id: string;
     name: string;
     instructions: (context: Context<TContext>) => Promise<string> | string;
     model: LanguageModel;
     modelSettings: LanguageModelRequestSettings;
-    toolkits: Toolkit<TContext>[];
+    toolkits: BaseToolkit<TContext>[];
     guardrails: {
         input: InputGuardrail[];
         output: OutputGuardrail<AgentResponseType>[];
@@ -20,6 +23,20 @@ export declare class Agent<TContext = UnknownContext, TResponse extends AgentRes
     responseType: TResponse;
     resetToolChoice: boolean;
     constructor(config: AgentConfig<TContext, TResponse>);
+    /**
+     * Bind this agent to a kernl instance. Called by kernl.register().
+     */
+    bind(kernl: Kernl): void;
+    /**
+     * Blocking execution - spawns or resumes thread and waits for completion
+     */
+    run(instructions: string, options?: ThreadOptions<TContext>): Promise<ThreadExecuteResult<ResolvedAgentResponse<TResponse>>>;
+    /**
+     * Streaming execution - spawns or resumes thread and returns async iterator
+     *
+     * NOTE: streaming probably won't make sense in scheduling contexts so spawnStream etc. won't make sense
+     */
+    stream(instructions: string, options?: ThreadOptions<TContext>): AsyncIterable<ThreadStreamEvent>;
     /**
      * Get a specific tool by ID from all toolkits.
      *

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAK9B,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,KAAK,CACd,QAAQ,GAAG,cAAc,EACzB,SAAS,SAAS,iBAAiB,GAAG,YAAY,CAEpD,SAAQ,UAAU,CAAC,QAAQ,EAAE,SAAS,CACtC,YAAW,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAEvE,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IAa9B,UAAU,EAAE;QACV,KAAK,EAAE,cAAc,EAAE,CAAC;QACxB,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAAE,CAAC;KAC9C,CAAC;IACF,YAAY,EAAE,SAAS,CAAuB;IAC9C,eAAe,EAAE,OAAO,CAAC;gBAsBb,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC;IAsDpD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,SAAS;IAQ5C;;;;;;;;;;OAUG;IACG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;CAwDnE"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,4BAA4B,EAE7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAK9B,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,KAAK,CACd,QAAQ,GAAG,cAAc,EACzB,SAAS,SAAS,iBAAiB,GAAG,YAAY,CAEpD,SAAQ,UAAU,CAAC,QAAQ,EAAE,SAAS,CACtC,YAAW,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE3C,OAAO,CAAC,KAAK,CAAC,CAAQ;IAEtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAEvE,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IAClC,UAAU,EAAE;QACV,KAAK,EAAE,cAAc,EAAE,CAAC;QACxB,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAAE,CAAC;KAC9C,CAAC;IACF,YAAY,EAAE,SAAS,CAAuB;IAC9C,eAAe,EAAE,OAAO,CAAC;gBAgBb,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC;IA0CpD;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIxB;;OAEG;IACG,GAAG,CACP,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;IAqBjE;;;;OAIG;IACI,MAAM,CACX,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IAsBnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,SAAS;IAQ5C;;;;;;;;;;OAUG;IACG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;CAoBnE"}

package/dist/agent.js

@@ -1,13 +1,19 @@
+import { message, } from "@kernl-sdk/protocol";
 import { AgentHooks } from "./lifecycle";
-// import { DEFAULT_LANGUAGE_MODEL } from "./providers/default";
+import { Thread } from "./thread";
 import { MisconfiguredError } from "./lib/error";
 export class Agent extends AgentHooks {
+    kernl;
     id;
     name;
     instructions;
     model;
     modelSettings;
     toolkits;
+    guardrails;
+    responseType = "text";
+    resetToolChoice;
+    // toolUseBehavior: ToolUseBehavior; (TODO)
     // --- (TODO) ---
     // handoffDescription: string; // ??
     // handoffs: (Agent<any, TResponse> | Handoff<any, TResponse>)[];
@@ -15,30 +21,10 @@ export class Agent extends AgentHooks {
     // /* Process/thread-group–wide signal state shared by all threads in the group: shared pending signals, job control
     // (stops/cont, group exit), rlimits, etc. */
     // signal: *struct signal_struct;
-    //  /* Table of signal handlers (sa_handler, sa_mask, flags) shared by threads (CLONE_SIGHAND). RCU-protected so readers can access it locklessly. */
+    //
+    //  /* Table of signal handlers (sa_handler, sa_mask, flags) shared by threads
+    // (CLONE_SIGHAND). RCU-protected so readers can access it locklessly. */
     // sighand: *struct sighand_struct __rcu;
-    guardrails;
-    responseType = "text";
-    resetToolChoice;
-    // toolUseBehavior: ToolUseBehavior; (TODO)
-    // /**
-    //  * Create an Agent with handoffs and automatically infer the union type for TResponse from the handoff agents' response types.
-    //  */
-    // static create<
-    //   TResponse extends AgentResponseType = TextResponse,
-    //   Handoffs extends readonly (Agent<any, any> | Handoff<any, any>)[] = [],
-    // >(
-    //   config: AgentConfigWithHandoffs<TResponse, Handoffs>,
-    // ): Agent<UnknownContext, TResponse | HandoffsOutputUnion<Handoffs>> {
-    //   return new Agent<UnknownContext, TResponse | HandoffsOutputUnion<Handoffs>>(
-    //     {
-    //       ...config,
-    //       handoffs: config.handoffs as any,
-    //       responseType: config.responseType,
-    //       handoffresponseTypeWarningEnabled: false,
-    //     },
-    //   );
-    // }
     constructor(config) {
         super();
         if (config.id.trim() === "") {
@@ -50,7 +36,7 @@ export class Agent extends AgentHooks {
             typeof config.instructions === "function"
                 ? config.instructions
                 : () => config.instructions;
-        this.model = config.model; // TODO: Add default model
+        this.model = config.model; // (TODO): include optional default setting for convenience like env.DEFAULT_LLM = "gpt-5"
         this.modelSettings = config.modelSettings ?? {};
         this.toolkits = config.toolkits ?? [];
         for (const toolkit of this.toolkits) {
@@ -65,29 +51,62 @@ export class Agent extends AgentHooks {
         // this.handoffDescription = config.handoffDescription ?? "";
         // this.handoffs = config.handoffs ?? [];
         // --- Runtime warning for handoff response type compatibility ---
-        // if (
-        //   config.handoffresponseTypeWarningEnabled === undefined ||
-        //   config.handoffresponseTypeWarningEnabled
-        // ) {
-        //   if (this.handoffs && this.responseType) {
-        //     const responseTypes = new Set<string>([
-        //       JSON.stringify(this.responseType),
-        //     ]);
-        //     for (const h of this.handoffs) {
-        //       if ("responseType" in h && h.responseType) {
-        //         responseTypes.add(JSON.stringify(h.responseType));
-        //       } else if ("agent" in h && h.agent.responseType) {
-        //         responseTypes.add(JSON.stringify(h.agent.responseType));
-        //       }
-        //     }
+        // if (config.handoffresponseTypeWarningEnabled) {
+        //     ...
         //     if (responseTypes.size > 1) {
         //       logger.warn(
-        //         `[Agent] Warning: Handoff agents have different response types: ${Array.from(responseTypes).join(", ")}. You can make it type-safe by using Agent.create({ ... }) method instead.`,
+        //         `[Agent] Warning: Handoff agents have different response types: ${Array.from(responseTypes).join(", ")}.
+        //          You can make it type-safe by using Agent.create({ ... }) method instead.`,
         //       );
         //     }
         //   }
         // }
     }
+    /**
+     * Bind this agent to a kernl instance. Called by kernl.register().
+     */
+    bind(kernl) {
+        this.kernl = kernl;
+    }
+    /**
+     * Blocking execution - spawns or resumes thread and waits for completion
+     */
+    async run(instructions, options) {
+        if (!this.kernl) {
+            throw new MisconfiguredError(`Agent ${this.id} not bound to kernl. Call kernl.register(agent) first.`);
+        }
+        const m = message({ role: "user", text: instructions });
+        const tid = options?.threadId;
+        // NOTE: may end up moving this to the kernl
+        let thread = tid ? this.kernl.threads.get(tid) : null;
+        if (!thread) {
+            thread = new Thread(this.kernl, this, [m], options);
+            return this.kernl.spawn(thread);
+        }
+        thread.append(m);
+        return this.kernl.schedule(thread);
+    }
+    /**
+     * Streaming execution - spawns or resumes thread and returns async iterator
+     *
+     * NOTE: streaming probably won't make sense in scheduling contexts so spawnStream etc. won't make sense
+     */
+    async *stream(instructions, options) {
+        if (!this.kernl) {
+            throw new MisconfiguredError(`Agent ${this.id} not bound to kernl. Call kernl.register(agent) first.`);
+        }
+        const m = message({ role: "user", text: instructions });
+        const tid = options?.threadId;
+        // NOTE: may end up moving this to the kernl
+        let thread = tid ? this.kernl.threads.get(tid) : null;
+        if (!thread) {
+            thread = new Thread(this.kernl, this, [m], options);
+            yield* this.kernl.spawnStream(thread);
+            return;
+        }
+        thread.append(m);
+        yield* this.kernl.scheduleStream(thread);
+    }
     /**
      * Get a specific tool by ID from all toolkits.
      *

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Kernl } from "./kernl";
 export { Agent } from "./agent";
 export type { Context } from "./context";
-export { tool, FunctionToolkit, MCPToolkit } from "./tool";
+export { tool, Toolkit, FunctionToolkit, MCPToolkit } from "./tool";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
 export { Kernl } from "./kernl";
 export { Agent } from "./agent";
-export { tool, FunctionToolkit, MCPToolkit } from "./tool";
+export { tool, Toolkit, FunctionToolkit, MCPToolkit } from "./tool";

package/dist/kernl.d.ts

@@ -1,18 +1,44 @@
 import { Agent } from "./agent";
 import { UnknownContext } from "./context";
 import { KernlHooks } from "./lifecycle";
+import type { Thread } from "./thread";
 import type { AgentResponseType } from "./types/agent";
+import type { ThreadExecuteResult, ThreadStreamEvent } from "./types/thread";
+import type { ResolvedAgentResponse } from "./guardrail";
 /**
- * Central coordinator for the entire application.
+ * The kernl - manages agent processes, scheduling, and task lifecycle
  *
  * Orchestrates agent execution, including guardrails, tool calls, session persistence, and
  * tracing.
  */
 export declare class Kernl extends KernlHooks<UnknownContext, AgentResponseType> {
     private agents;
+    threads: Map<string, Thread<any, any>>;
     /**
      * Registers a new agent with the kernl instance.
      */
     register(agent: Agent): void;
+    /**
+     * Spawn a new thread - blocking execution
+     */
+    spawn<TContext, TResponse extends AgentResponseType>(thread: Thread<TContext, TResponse>): Promise<ThreadExecuteResult<ResolvedAgentResponse<TResponse>>>;
+    /**
+     * Schedule an existing thread - blocking execution
+     *
+     * NOTE: just blocks for now
+     */
+    schedule<TContext, TResponse extends AgentResponseType>(thread: Thread<TContext, TResponse>): Promise<ThreadExecuteResult<ResolvedAgentResponse<TResponse>>>;
+    /**
+     * (TMP) - probably won't make sense with assync scheduling contexts
+     *
+     * Spawn a new thread - streaming execution
+     */
+    spawnStream<TContext, TResponse extends AgentResponseType>(thread: Thread<TContext, TResponse>): AsyncIterable<ThreadStreamEvent>;
+    /**
+     * (TMP) - probably won't make sense with assync scheduling contexts
+     *
+     * Schedule an existing thread - streaming execution
+     */
+    scheduleStream<TContext, TResponse extends AgentResponseType>(thread: Thread<TContext, TResponse>): AsyncIterable<ThreadStreamEvent>;
 }
 //# sourceMappingURL=kernl.d.ts.map

package/dist/kernl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../src/kernl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC;IACtE,OAAO,CAAC,MAAM,CAAiC;IAE/C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAG7B"}
+{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../src/kernl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC;IACtE,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAa;IAEnD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK5B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EACvD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;IAKjE;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;IAIjE;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EAC9D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,aAAa,CAAC,iBAAiB,CAAC;IAKnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,SAAS,SAAS,iBAAiB,EACjE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAClC,aAAa,CAAC,iBAAiB,CAAC;CAGpC"}

package/dist/kernl.js

@@ -1,16 +1,50 @@
 import { KernlHooks } from "./lifecycle";
 /**
- * Central coordinator for the entire application.
+ * The kernl - manages agent processes, scheduling, and task lifecycle
  *
  * Orchestrates agent execution, including guardrails, tool calls, session persistence, and
  * tracing.
  */
 export class Kernl extends KernlHooks {
     agents = new Map();
+    threads = new Map();
     /**
      * Registers a new agent with the kernl instance.
      */
     register(agent) {
-        // TODO: Implement agent registration
+        this.agents.set(agent.id, agent);
+        agent.bind(this);
+    }
+    /**
+     * Spawn a new thread - blocking execution
+     */
+    async spawn(thread) {
+        this.threads.set(thread.id, thread);
+        return await thread.execute();
+    }
+    /**
+     * Schedule an existing thread - blocking execution
+     *
+     * NOTE: just blocks for now
+     */
+    async schedule(thread) {
+        return await thread.execute();
+    }
+    /**
+     * (TMP) - probably won't make sense with assync scheduling contexts
+     *
+     * Spawn a new thread - streaming execution
+     */
+    async *spawnStream(thread) {
+        this.threads.set(thread.id, thread);
+        yield* thread.stream();
+    }
+    /**
+     * (TMP) - probably won't make sense with assync scheduling contexts
+     *
+     * Schedule an existing thread - streaming execution
+     */
+    async *scheduleStream(thread) {
+        yield* thread.stream();
     }
 }

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

@@ -8,7 +8,15 @@ import { Context } from "../../context";
 import { tool } from "../../tool";
 import { z } from "zod";
 import { createMCPToolStaticFilter } from "../utils";
+import { createMockModel } from "../../thread/__tests__/fixtures/mock-model";
 const TEST_SERVER = path.join(__dirname, "fixtures", "server.ts");
+// Mock model for tests that only need toolkit functionality
+const mockModel = createMockModel(async () => ({
+    content: [],
+    finishReason: "stop",
+    usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
+    warnings: [],
+}));
 describe("MCP Integration Tests", () => {
     describe("MCPToolkit Integration", () => {
         let server;
@@ -128,6 +136,7 @@ describe("MCP Integration Tests", () => {
                 id: "test-agent",
                 name: "Test Agent",
                 instructions: "Test",
+                model: mockModel,
                 toolkits: [toolkit],
             });
             const context = new Context({});
@@ -158,6 +167,7 @@ describe("MCP Integration Tests", () => {
                 id: "test-agent",
                 name: "Test Agent",
                 instructions: "Test",
+                model: mockModel,
                 toolkits: [toolkit],
             });
             const context = new Context({});
@@ -189,6 +199,7 @@ describe("MCP Integration Tests", () => {
                 id: "test-agent",
                 name: "Test Agent",
                 instructions: "Test",
+                model: mockModel,
                 toolkits: [toolkit],
             });
             const context = new Context({ userId: "test-user" });
@@ -216,6 +227,7 @@ describe("MCP Integration Tests", () => {
                 id: "test-agent",
                 name: "Test Agent",
                 instructions: "Test",
+                model: mockModel,
                 toolkits: [mcpToolkit],
             });
             const context = new Context({});
@@ -239,6 +251,7 @@ describe("MCP Integration Tests", () => {
                 id: "test-agent",
                 name: "Test Agent",
                 instructions: "Test",
+                model: mockModel,
                 toolkits: [mcpToolkit],
             });
             // Populate toolkit cache
@@ -264,6 +277,7 @@ describe("MCP Integration Tests", () => {
                 id: "test-agent",
                 name: "Test Agent",
                 instructions: "Test",
+                model: mockModel,
                 toolkits: [mcpToolkit],
             });
             const context = new Context({});
@@ -308,6 +322,7 @@ describe("MCP Integration Tests", () => {
                 id: "test-agent",
                 name: "Test Agent",
                 instructions: "Test",
+                model: mockModel,
                 toolkits: [mcpToolkit, functionToolkit],
             });
             const context = new Context({});
@@ -349,6 +364,7 @@ describe("MCP Integration Tests", () => {
                 id: "test-agent",
                 name: "Test Agent",
                 instructions: "Test",
+                model: mockModel,
                 toolkits: [mcpToolkit, functionToolkit],
             });
             const context = new Context({});

package/dist/thread/__tests__/fixtures/mock-model.d.ts

@@ -0,0 +1,7 @@
+import type { LanguageModel, LanguageModelRequest, LanguageModelResponse } from "@kernl-sdk/protocol";
+/**
+ * Creates a mock LanguageModel that automatically implements streaming
+ * based on the generate() implementation.
+ */
+export declare function createMockModel(generateFn: (req: LanguageModelRequest) => Promise<LanguageModelResponse>): LanguageModel;
+//# sourceMappingURL=mock-model.d.ts.map

package/dist/thread/__tests__/fixtures/mock-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-model.d.ts","sourceRoot":"","sources":["../../../../src/thread/__tests__/fixtures/mock-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EAGtB,MAAM,qBAAqB,CAAC;AA+C7B;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,qBAAqB,CAAC,GACxE,aAAa,CAWf"}

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

@@ -0,0 +1,59 @@
+/**
+ * Helper to convert LanguageModelResponse content to stream events.
+ * Yields both delta events (for streaming UX) and complete items (for history).
+ */
+async function* streamFromResponse(response) {
+    for (const item of response.content) {
+        if (item.kind === "message") {
+            // Stream message with text deltas
+            for (const contentItem of item.content) {
+                if (contentItem.kind === "text") {
+                    // Yield text-start
+                    yield {
+                        kind: "text-start",
+                        id: item.id,
+                    };
+                    // Yield text-delta
+                    yield {
+                        kind: "text-delta",
+                        id: item.id,
+                        text: contentItem.text,
+                    };
+                    // Yield text-end
+                    yield {
+                        kind: "text-end",
+                        id: item.id,
+                    };
+                }
+            }
+            // Yield complete message
+            yield item;
+        }
+        else {
+            // For tool-call, reasoning, tool-result - just yield as-is
+            yield item;
+        }
+    }
+    // Yield finish event
+    yield {
+        kind: "finish",
+        finishReason: response.finishReason,
+        usage: response.usage,
+    };
+}
+/**
+ * Creates a mock LanguageModel that automatically implements streaming
+ * based on the generate() implementation.
+ */
+export function createMockModel(generateFn) {
+    return {
+        spec: "1.0",
+        provider: "test",
+        modelId: "test-model",
+        generate: generateFn,
+        stream: async function* (req) {
+            const response = await generateFn(req);
+            yield* streamFromResponse(response);
+        },
+    };
+}

package/dist/thread/__tests__/integration.test.d.ts

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

package/dist/thread/__tests__/integration.test.d.ts.map

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