kraken-ai 0.0.5 → 0.0.7

package/README.md

@@ -65,7 +65,7 @@ if (result.status === "complete") {
 ## Requirements
 
 - Node.js 18+
-- TypeScript 5+
+- TypeScript 5+ (TypeScript 6 supported; requires tsup patch in monorepos — see [egoist/tsup#1388](https://github.com/egoist/tsup/issues/1388))
 - `zod` 4+ (peer dependency)
 - `@google/genai` 1+ (optional — required for the Google provider)
 

package/dist/{chunk-RBQ2PPDE.js → chunk-3WRAEJP3.js}

@@ -19,6 +19,7 @@ var ToolError = class extends KrakenError {
     this.toolName = toolName;
     this.name = "ToolError";
   }
+  toolName;
 };
 var ValidationError = class extends KrakenError {
   constructor(message) {

package/dist/{chunk-4X5NFWDA.js → chunk-6Q6G4WVJ.js}

@@ -1,6 +1,6 @@
 import {
   ProviderError
-} from "./chunk-RBQ2PPDE.js";
+} from "./chunk-3WRAEJP3.js";
 
 // src/providers/google.ts
 var DEFAULT_RETRY = {

package/dist/{chunk-5XNFMNJL.js → chunk-D2AU5FGJ.js}

@@ -1,6 +1,6 @@
 import {
   ProviderError
-} from "./chunk-RBQ2PPDE.js";
+} from "./chunk-3WRAEJP3.js";
 
 // src/providers/openai.ts
 var openai = (_modelId) => {

package/dist/google-W6HDKXTM.js

@@ -0,0 +1,7 @@
+import {
+  google
+} from "./chunk-6Q6G4WVJ.js";
+import "./chunk-3WRAEJP3.js";
+export {
+  google
+};

package/dist/index.cjs

@@ -55,6 +55,7 @@ var init_errors = __esm({
         this.toolName = toolName;
         this.name = "ToolError";
       }
+      toolName;
     };
     ValidationError = class extends KrakenError {
       constructor(message) {
@@ -458,6 +459,7 @@ var LifecycleManager = class {
   constructor(onTransition) {
     this.onTransition = onTransition;
   }
+  onTransition;
   _state = "idle";
   _transitions = [];
   get state() {
@@ -490,14 +492,14 @@ var composeOnLLMCall = (middleware, ctx, coreFn) => {
   }
   return fn;
 };
-var composeOnToolCall = (middleware, ctx, coreFn, toolName, args) => {
+var composeOnToolCall = (middleware, ctx, coreFn, toolName, toolCallId, args) => {
   let fn = coreFn;
   for (let i = middleware.length - 1; i >= 0; i--) {
     const mw = middleware[i];
     if (mw?.onToolCall) {
       const prev = fn;
       const hook = mw.onToolCall;
-      fn = () => hook(ctx, toolName, args, prev);
+      fn = () => hook(ctx, toolName, toolCallId, args, prev);
     }
   }
   return fn;
@@ -509,6 +511,41 @@ var applyTransformTools = (middleware, ctx, tools) => {
   }
   return result;
 };
+var composeOnEvent = (middleware, ctx, sink, warn) => {
+  const hooks = [];
+  for (const mw of middleware) {
+    if (mw.onEvent) hooks.push(mw.onEvent);
+  }
+  if (hooks.length === 0) return sink;
+  return (event) => {
+    const origSeq = event.seq;
+    const origRunId = event.runId;
+    const origAgentName = event.agentName;
+    let next = () => {
+      if (event.seq !== origSeq || event.runId !== origRunId || event.agentName !== origAgentName) {
+        warn?.("onEvent middleware mutated immutable fields (seq/runId/agentName) \u2014 restoring");
+        event.seq = origSeq;
+        event.runId = origRunId;
+        event.agentName = origAgentName;
+      }
+      sink?.(event);
+    };
+    for (let i = hooks.length - 1; i >= 0; i--) {
+      const hook = hooks[i];
+      if (!hook) continue;
+      const prev = next;
+      next = () => {
+        try {
+          hook(ctx, event, prev);
+        } catch (err) {
+          warn?.(`onEvent middleware threw: ${err instanceof Error ? err.message : String(err)}`);
+          prev();
+        }
+      };
+    }
+    next();
+  };
+};
 var createRunner = (config2) => {
   const { agent, model, tools } = config2;
   const toolMap = new Map(tools.map((t) => [t.name, t]));
@@ -530,7 +567,13 @@ var createRunner = (config2) => {
         runId,
         parentRunId: options?.parentRunId
       };
-      const emitter = createEventEmitter(agent.name, runId, options?.onEvent, options?.parentRunId);
+      const composedOnEvent = composeOnEvent(
+        middleware,
+        ctx,
+        options?.onEvent,
+        (msg) => logger.warn(msg)
+      );
+      const emitter = createEventEmitter(agent.name, runId, composedOnEvent, options?.parentRunId);
       const lifecycle = new LifecycleManager((from, to) => {
         emitter.emit({ type: "lifecycle", from, to });
         for (const mw of middleware) mw.onTransition?.(ctx, from, to);
@@ -547,6 +590,11 @@ var createRunner = (config2) => {
         ...config2.thinkingLevel ? { thinkingLevel: config2.thinkingLevel } : {},
         hasOutputSchema: Boolean(config2.responseSchema)
       });
+      emitter.emit({
+        type: "transcript_init",
+        systemPrompt: agent.instructions,
+        messages: inputMessages.map((m) => ({ role: m.role, content: m.content }))
+      });
       const usage = { inputTokens: 0, outputTokens: 0 };
       const conversationMessages = [...inputMessages];
       let currentRound = 0;
@@ -579,9 +627,24 @@ var createRunner = (config2) => {
             thinkingLevel: config2.thinkingLevel,
             responseSchema: config2.responseSchema
           };
-          const response = await wrappedGenerate(params);
+          let response;
+          try {
+            response = await wrappedGenerate(params);
+          } catch (err) {
+            emitter.emit({
+              type: "llm_call",
+              inputTokens: 0,
+              outputTokens: 0,
+              output: "",
+              error: err instanceof Error ? err.message : String(err)
+            });
+            throw err;
+          }
           usage.inputTokens += response.usage.inputTokens;
           usage.outputTokens += response.usage.outputTokens;
+          if (!model.generateStream && response.thoughts) {
+            emitter.emit({ type: "thought", text: response.thoughts, callIndex: round });
+          }
           emitter.emit({
             type: "llm_call",
             inputTokens: response.usage.inputTokens,
@@ -592,9 +655,6 @@ var createRunner = (config2) => {
               args: tc.args
             }))
           });
-          if (!model.generateStream && response.thoughts) {
-            emitter.emit({ type: "thought", text: response.thoughts, callIndex: round });
-          }
           if (!response.toolCalls?.length) {
             lifecycle.transition("completed");
             return {
@@ -669,6 +729,7 @@ var createRunner = (config2) => {
                 ctx,
                 executeFn,
                 tc.name,
+                tc.id,
                 tc.args
               );
               const startTime = Date.now();
@@ -1007,13 +1068,15 @@ var formatEvent = (e) => {
     case "interrupt":
       return `${tag} interrupt: ${e.toolName} awaiting approval`;
     case "kill":
-      return `${tag} killed${e.reason ? `: ${e.reason}` : ""}`;
+      return `${tag} killed: ${e.reason}`;
     case "error":
       return `${tag} error: ${e.message}`;
     case "notification":
       return `${tag} notification: ${e.title}`;
     case "structured_output_complete":
       return `${tag} structured output complete`;
+    case "transcript_init":
+      return `${tag} transcript: system prompt + ${e.messages.length} message(s)`;
   }
 };
 

package/dist/index.d.cts

@@ -36,7 +36,7 @@ interface Middleware {
     /** Augment tool definitions visible to the LLM. Called once at run start. */
     transformTools?: (ctx: MiddlewareContext, tools: ToolDefinition[]) => ToolDefinition[];
     /** Wrap tool execution. Called for EVERY tool call including delegation. */
-    onToolCall?: (ctx: MiddlewareContext, toolName: string, args: unknown, next: () => Promise<unknown>) => Promise<unknown>;
+    onToolCall?: (ctx: MiddlewareContext, toolName: string, toolCallId: string, args: unknown, next: () => Promise<unknown>) => Promise<unknown>;
     /** Wrap LLM generation. Pre-LLM and post-LLM gates via next(). */
     onLLMCall?: (ctx: MiddlewareContext, params: GenerateParams, next: () => Promise<GenerateResponse>) => Promise<GenerateResponse>;
     /** Called on every lifecycle transition. */
@@ -174,6 +174,14 @@ interface AgentConfigEvent extends AgentEventBase {
     thinkingLevel?: string;
     hasOutputSchema: boolean;
 }
+interface AgentTranscriptInitEvent extends AgentEventBase {
+    type: "transcript_init";
+    systemPrompt: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+}
 interface AgentLifecycleEvent extends AgentEventBase {
     type: "lifecycle";
     from: AgentState;
@@ -188,11 +196,21 @@ interface AgentLLMCallEvent extends AgentEventBase {
         name: string;
         args: Record<string, unknown>;
     }[];
+    /** Set when the LLM call failed. */
+    error?: string;
+    /** Middleware enrichment: correlation ID linking this LLM call to its tool calls. */
+    turnId?: string;
+    /** Middleware enrichment: wall-clock duration in milliseconds. */
+    durationMs?: number;
+    /** Middleware enrichment: number of tool calls in the response. */
+    toolCallCount?: number;
 }
 interface AgentThoughtEvent extends AgentEventBase {
     type: "thought";
     text: string;
     callIndex: number;
+    /** Middleware enrichment: correlation ID of the active LLM call turn. */
+    turnId?: string;
 }
 interface AgentToolCallEvent extends AgentEventBase {
     type: "tool_call";
@@ -203,6 +221,8 @@ interface AgentToolCallEvent extends AgentEventBase {
     result?: unknown;
     error?: string;
     durationMs: number;
+    /** Middleware enrichment: correlation ID linking this tool call to its parent LLM call. */
+    turnId?: string;
 }
 interface AgentDelegationEvent extends AgentEventBase {
     type: "delegation";
@@ -219,7 +239,7 @@ interface AgentInterruptEvent extends AgentEventBase {
 }
 interface AgentKillEvent extends AgentEventBase {
     type: "kill";
-    reason?: string;
+    reason: string;
 }
 interface AgentErrorEvent extends AgentEventBase {
     type: "error";
@@ -239,7 +259,7 @@ interface AgentStructuredOutputCompleteEvent extends AgentEventBase {
 /** All possible agent event type strings. */
 type AgentEventType = AgentEvent["type"];
 /** An event emitted during agent execution. Discriminated union on `type`. */
-type AgentEvent = AgentConfigEvent | AgentLifecycleEvent | AgentLLMCallEvent | AgentThoughtEvent | AgentToolCallEvent | AgentDelegationEvent | AgentInterruptEvent | AgentKillEvent | AgentErrorEvent | AgentNotificationEvent | AgentStructuredOutputCompleteEvent;
+type AgentEvent = AgentConfigEvent | AgentTranscriptInitEvent | AgentLifecycleEvent | AgentLLMCallEvent | AgentThoughtEvent | AgentToolCallEvent | AgentDelegationEvent | AgentInterruptEvent | AgentKillEvent | AgentErrorEvent | AgentNotificationEvent | AgentStructuredOutputCompleteEvent;
 /** Distributive Omit that preserves union variants — strips base fields from each event type. */
 type AgentEventPayload<T = AgentEvent> = T extends AgentEventBase ? Omit<T, keyof AgentEventBase> : never;
 /** Log verbosity level. */
@@ -367,6 +387,8 @@ interface RunOptions {
     thinkingLevel?: ThinkingLevel;
     maxOutputTokens?: number;
     responseSchema?: Record<string, unknown>;
+    /** When true, tool calls are logged but not executed. */
+    dryRun?: boolean;
     /** @internal Shared map for pre-generated child runIds during delegation. */
     _childRunIds?: Map<string, string[]>;
 }
@@ -674,4 +696,4 @@ interface ToolConfig<TParams extends z.ZodType, TReturn = unknown> {
  */
 declare const tool: <TParams extends z.ZodType, TReturn>(config: ToolConfig<TParams, TReturn>) => Tool;
 
-export { Agent, type AgentConfig, type AgentConfigEvent, type AgentDelegationEvent, type AgentErrorEvent, type AgentEvent, type AgentEventBase, type AgentEventPayload, type AgentEventType, type AgentInterruptEvent, type AgentKillEvent, type AgentLLMCallEvent, type AgentLifecycleEvent, type AgentLike, type AgentNotificationEvent, type AgentRef, type AgentState, type AgentStructuredOutputCompleteEvent, type AgentThoughtEvent, type AgentToolCallEvent, type ExecutionContext, type GenerateParams, type GenerateResponse, type GlobalConfig, type GoogleModelConfig, type GoogleModelId, type HumanDecision, type Interrupt, type Kernel, type KernelSignal, KrakenError, type LogLevel, type Message, type Middleware, type MiddlewareContext, type Model, type ModelParams, type ModelString, type OpenAIModelId, OutputValidationError, ProviderError, type RetryConfig, type RunOptions, type RunResult, type RunnerResponse, type SpawnSpec, type StreamChunk, type TeamAccessor, type ThinkingLevel, type Tool, type ToolCall, type ToolConfig, type ToolDefinition, ToolError, ToolInputValidationError, type ToolResult, type TransitionRecord, type Usage, ValidationError, configure, defineKernel, formatEvent, google, mock, openai, tool };
+export { Agent, type AgentConfig, type AgentConfigEvent, type AgentDelegationEvent, type AgentErrorEvent, type AgentEvent, type AgentEventBase, type AgentEventPayload, type AgentEventType, type AgentInterruptEvent, type AgentKillEvent, type AgentLLMCallEvent, type AgentLifecycleEvent, type AgentLike, type AgentNotificationEvent, type AgentRef, type AgentState, type AgentStructuredOutputCompleteEvent, type AgentThoughtEvent, type AgentToolCallEvent, type AgentTranscriptInitEvent, type ExecutionContext, type GenerateParams, type GenerateResponse, type GlobalConfig, type GoogleModelConfig, type GoogleModelId, type HumanDecision, type Interrupt, type Kernel, type KernelSignal, KrakenError, type LogLevel, type Message, type Middleware, type MiddlewareContext, type Model, type ModelParams, type ModelString, type OpenAIModelId, OutputValidationError, ProviderError, type RetryConfig, type RunOptions, type RunResult, type RunnerResponse, type SpawnSpec, type StreamChunk, type TeamAccessor, type ThinkingLevel, type Tool, type ToolCall, type ToolConfig, type ToolDefinition, ToolError, ToolInputValidationError, type ToolResult, type TransitionRecord, type Usage, ValidationError, configure, defineKernel, formatEvent, google, mock, openai, tool };

package/dist/index.d.ts

@@ -36,7 +36,7 @@ interface Middleware {
     /** Augment tool definitions visible to the LLM. Called once at run start. */
     transformTools?: (ctx: MiddlewareContext, tools: ToolDefinition[]) => ToolDefinition[];
     /** Wrap tool execution. Called for EVERY tool call including delegation. */
-    onToolCall?: (ctx: MiddlewareContext, toolName: string, args: unknown, next: () => Promise<unknown>) => Promise<unknown>;
+    onToolCall?: (ctx: MiddlewareContext, toolName: string, toolCallId: string, args: unknown, next: () => Promise<unknown>) => Promise<unknown>;
     /** Wrap LLM generation. Pre-LLM and post-LLM gates via next(). */
     onLLMCall?: (ctx: MiddlewareContext, params: GenerateParams, next: () => Promise<GenerateResponse>) => Promise<GenerateResponse>;
     /** Called on every lifecycle transition. */
@@ -174,6 +174,14 @@ interface AgentConfigEvent extends AgentEventBase {
     thinkingLevel?: string;
     hasOutputSchema: boolean;
 }
+interface AgentTranscriptInitEvent extends AgentEventBase {
+    type: "transcript_init";
+    systemPrompt: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+}
 interface AgentLifecycleEvent extends AgentEventBase {
     type: "lifecycle";
     from: AgentState;
@@ -188,11 +196,21 @@ interface AgentLLMCallEvent extends AgentEventBase {
         name: string;
         args: Record<string, unknown>;
     }[];
+    /** Set when the LLM call failed. */
+    error?: string;
+    /** Middleware enrichment: correlation ID linking this LLM call to its tool calls. */
+    turnId?: string;
+    /** Middleware enrichment: wall-clock duration in milliseconds. */
+    durationMs?: number;
+    /** Middleware enrichment: number of tool calls in the response. */
+    toolCallCount?: number;
 }
 interface AgentThoughtEvent extends AgentEventBase {
     type: "thought";
     text: string;
     callIndex: number;
+    /** Middleware enrichment: correlation ID of the active LLM call turn. */
+    turnId?: string;
 }
 interface AgentToolCallEvent extends AgentEventBase {
     type: "tool_call";
@@ -203,6 +221,8 @@ interface AgentToolCallEvent extends AgentEventBase {
     result?: unknown;
     error?: string;
     durationMs: number;
+    /** Middleware enrichment: correlation ID linking this tool call to its parent LLM call. */
+    turnId?: string;
 }
 interface AgentDelegationEvent extends AgentEventBase {
     type: "delegation";
@@ -219,7 +239,7 @@ interface AgentInterruptEvent extends AgentEventBase {
 }
 interface AgentKillEvent extends AgentEventBase {
     type: "kill";
-    reason?: string;
+    reason: string;
 }
 interface AgentErrorEvent extends AgentEventBase {
     type: "error";
@@ -239,7 +259,7 @@ interface AgentStructuredOutputCompleteEvent extends AgentEventBase {
 /** All possible agent event type strings. */
 type AgentEventType = AgentEvent["type"];
 /** An event emitted during agent execution. Discriminated union on `type`. */
-type AgentEvent = AgentConfigEvent | AgentLifecycleEvent | AgentLLMCallEvent | AgentThoughtEvent | AgentToolCallEvent | AgentDelegationEvent | AgentInterruptEvent | AgentKillEvent | AgentErrorEvent | AgentNotificationEvent | AgentStructuredOutputCompleteEvent;
+type AgentEvent = AgentConfigEvent | AgentTranscriptInitEvent | AgentLifecycleEvent | AgentLLMCallEvent | AgentThoughtEvent | AgentToolCallEvent | AgentDelegationEvent | AgentInterruptEvent | AgentKillEvent | AgentErrorEvent | AgentNotificationEvent | AgentStructuredOutputCompleteEvent;
 /** Distributive Omit that preserves union variants — strips base fields from each event type. */
 type AgentEventPayload<T = AgentEvent> = T extends AgentEventBase ? Omit<T, keyof AgentEventBase> : never;
 /** Log verbosity level. */
@@ -367,6 +387,8 @@ interface RunOptions {
     thinkingLevel?: ThinkingLevel;
     maxOutputTokens?: number;
     responseSchema?: Record<string, unknown>;
+    /** When true, tool calls are logged but not executed. */
+    dryRun?: boolean;
     /** @internal Shared map for pre-generated child runIds during delegation. */
     _childRunIds?: Map<string, string[]>;
 }
@@ -674,4 +696,4 @@ interface ToolConfig<TParams extends z.ZodType, TReturn = unknown> {
  */
 declare const tool: <TParams extends z.ZodType, TReturn>(config: ToolConfig<TParams, TReturn>) => Tool;
 
-export { Agent, type AgentConfig, type AgentConfigEvent, type AgentDelegationEvent, type AgentErrorEvent, type AgentEvent, type AgentEventBase, type AgentEventPayload, type AgentEventType, type AgentInterruptEvent, type AgentKillEvent, type AgentLLMCallEvent, type AgentLifecycleEvent, type AgentLike, type AgentNotificationEvent, type AgentRef, type AgentState, type AgentStructuredOutputCompleteEvent, type AgentThoughtEvent, type AgentToolCallEvent, type ExecutionContext, type GenerateParams, type GenerateResponse, type GlobalConfig, type GoogleModelConfig, type GoogleModelId, type HumanDecision, type Interrupt, type Kernel, type KernelSignal, KrakenError, type LogLevel, type Message, type Middleware, type MiddlewareContext, type Model, type ModelParams, type ModelString, type OpenAIModelId, OutputValidationError, ProviderError, type RetryConfig, type RunOptions, type RunResult, type RunnerResponse, type SpawnSpec, type StreamChunk, type TeamAccessor, type ThinkingLevel, type Tool, type ToolCall, type ToolConfig, type ToolDefinition, ToolError, ToolInputValidationError, type ToolResult, type TransitionRecord, type Usage, ValidationError, configure, defineKernel, formatEvent, google, mock, openai, tool };
+export { Agent, type AgentConfig, type AgentConfigEvent, type AgentDelegationEvent, type AgentErrorEvent, type AgentEvent, type AgentEventBase, type AgentEventPayload, type AgentEventType, type AgentInterruptEvent, type AgentKillEvent, type AgentLLMCallEvent, type AgentLifecycleEvent, type AgentLike, type AgentNotificationEvent, type AgentRef, type AgentState, type AgentStructuredOutputCompleteEvent, type AgentThoughtEvent, type AgentToolCallEvent, type AgentTranscriptInitEvent, type ExecutionContext, type GenerateParams, type GenerateResponse, type GlobalConfig, type GoogleModelConfig, type GoogleModelId, type HumanDecision, type Interrupt, type Kernel, type KernelSignal, KrakenError, type LogLevel, type Message, type Middleware, type MiddlewareContext, type Model, type ModelParams, type ModelString, type OpenAIModelId, OutputValidationError, ProviderError, type RetryConfig, type RunOptions, type RunResult, type RunnerResponse, type SpawnSpec, type StreamChunk, type TeamAccessor, type ThinkingLevel, type Tool, type ToolCall, type ToolConfig, type ToolDefinition, ToolError, ToolInputValidationError, type ToolResult, type TransitionRecord, type Usage, ValidationError, configure, defineKernel, formatEvent, google, mock, openai, tool };

package/dist/index.js

@@ -1,9 +1,9 @@
 import {
   google
-} from "./chunk-4X5NFWDA.js";
+} from "./chunk-6Q6G4WVJ.js";
 import {
   openai
-} from "./chunk-5XNFMNJL.js";
+} from "./chunk-D2AU5FGJ.js";
 import {
   KrakenError,
   OutputValidationError,
@@ -11,7 +11,7 @@ import {
   ToolError,
   ToolInputValidationError,
   ValidationError
-} from "./chunk-RBQ2PPDE.js";
+} from "./chunk-3WRAEJP3.js";
 
 // src/agent.ts
 import * as z2 from "zod";
@@ -40,10 +40,10 @@ var createLazyModel = (provider, modelId) => {
   const ensureResolved = async () => {
     if (resolvedModel) return resolvedModel;
     if (provider === "google") {
-      const { google: google2 } = await import("./google-GNB46G6S.js");
+      const { google: google2 } = await import("./google-W6HDKXTM.js");
       resolvedModel = google2(modelId);
     } else if (provider === "openai") {
-      const { openai: openai2 } = await import("./openai-HXIIBATW.js");
+      const { openai: openai2 } = await import("./openai-STUANOLN.js");
       resolvedModel = openai2(modelId);
     } else {
       throw new ValidationError(`Unknown provider "${provider}".`);
@@ -141,6 +141,7 @@ var LifecycleManager = class {
   constructor(onTransition) {
     this.onTransition = onTransition;
   }
+  onTransition;
   _state = "idle";
   _transitions = [];
   get state() {
@@ -173,14 +174,14 @@ var composeOnLLMCall = (middleware, ctx, coreFn) => {
   }
   return fn;
 };
-var composeOnToolCall = (middleware, ctx, coreFn, toolName, args) => {
+var composeOnToolCall = (middleware, ctx, coreFn, toolName, toolCallId, args) => {
   let fn = coreFn;
   for (let i = middleware.length - 1; i >= 0; i--) {
     const mw = middleware[i];
     if (mw?.onToolCall) {
       const prev = fn;
       const hook = mw.onToolCall;
-      fn = () => hook(ctx, toolName, args, prev);
+      fn = () => hook(ctx, toolName, toolCallId, args, prev);
     }
   }
   return fn;
@@ -192,6 +193,41 @@ var applyTransformTools = (middleware, ctx, tools) => {
   }
   return result;
 };
+var composeOnEvent = (middleware, ctx, sink, warn) => {
+  const hooks = [];
+  for (const mw of middleware) {
+    if (mw.onEvent) hooks.push(mw.onEvent);
+  }
+  if (hooks.length === 0) return sink;
+  return (event) => {
+    const origSeq = event.seq;
+    const origRunId = event.runId;
+    const origAgentName = event.agentName;
+    let next = () => {
+      if (event.seq !== origSeq || event.runId !== origRunId || event.agentName !== origAgentName) {
+        warn?.("onEvent middleware mutated immutable fields (seq/runId/agentName) \u2014 restoring");
+        event.seq = origSeq;
+        event.runId = origRunId;
+        event.agentName = origAgentName;
+      }
+      sink?.(event);
+    };
+    for (let i = hooks.length - 1; i >= 0; i--) {
+      const hook = hooks[i];
+      if (!hook) continue;
+      const prev = next;
+      next = () => {
+        try {
+          hook(ctx, event, prev);
+        } catch (err) {
+          warn?.(`onEvent middleware threw: ${err instanceof Error ? err.message : String(err)}`);
+          prev();
+        }
+      };
+    }
+    next();
+  };
+};
 var createRunner = (config2) => {
   const { agent, model, tools } = config2;
   const toolMap = new Map(tools.map((t) => [t.name, t]));
@@ -213,7 +249,13 @@ var createRunner = (config2) => {
         runId,
         parentRunId: options?.parentRunId
       };
-      const emitter = createEventEmitter(agent.name, runId, options?.onEvent, options?.parentRunId);
+      const composedOnEvent = composeOnEvent(
+        middleware,
+        ctx,
+        options?.onEvent,
+        (msg) => logger.warn(msg)
+      );
+      const emitter = createEventEmitter(agent.name, runId, composedOnEvent, options?.parentRunId);
       const lifecycle = new LifecycleManager((from, to) => {
         emitter.emit({ type: "lifecycle", from, to });
         for (const mw of middleware) mw.onTransition?.(ctx, from, to);
@@ -230,6 +272,11 @@ var createRunner = (config2) => {
         ...config2.thinkingLevel ? { thinkingLevel: config2.thinkingLevel } : {},
         hasOutputSchema: Boolean(config2.responseSchema)
       });
+      emitter.emit({
+        type: "transcript_init",
+        systemPrompt: agent.instructions,
+        messages: inputMessages.map((m) => ({ role: m.role, content: m.content }))
+      });
       const usage = { inputTokens: 0, outputTokens: 0 };
       const conversationMessages = [...inputMessages];
       let currentRound = 0;
@@ -262,9 +309,24 @@ var createRunner = (config2) => {
             thinkingLevel: config2.thinkingLevel,
             responseSchema: config2.responseSchema
           };
-          const response = await wrappedGenerate(params);
+          let response;
+          try {
+            response = await wrappedGenerate(params);
+          } catch (err) {
+            emitter.emit({
+              type: "llm_call",
+              inputTokens: 0,
+              outputTokens: 0,
+              output: "",
+              error: err instanceof Error ? err.message : String(err)
+            });
+            throw err;
+          }
           usage.inputTokens += response.usage.inputTokens;
           usage.outputTokens += response.usage.outputTokens;
+          if (!model.generateStream && response.thoughts) {
+            emitter.emit({ type: "thought", text: response.thoughts, callIndex: round });
+          }
           emitter.emit({
             type: "llm_call",
             inputTokens: response.usage.inputTokens,
@@ -275,9 +337,6 @@ var createRunner = (config2) => {
               args: tc.args
             }))
           });
-          if (!model.generateStream && response.thoughts) {
-            emitter.emit({ type: "thought", text: response.thoughts, callIndex: round });
-          }
           if (!response.toolCalls?.length) {
             lifecycle.transition("completed");
             return {
@@ -352,6 +411,7 @@ var createRunner = (config2) => {
                 ctx,
                 executeFn,
                 tc.name,
+                tc.id,
                 tc.args
               );
               const startTime = Date.now();
@@ -687,13 +747,15 @@ var formatEvent = (e) => {
     case "interrupt":
       return `${tag} interrupt: ${e.toolName} awaiting approval`;
     case "kill":
-      return `${tag} killed${e.reason ? `: ${e.reason}` : ""}`;
+      return `${tag} killed: ${e.reason}`;
     case "error":
       return `${tag} error: ${e.message}`;
     case "notification":
       return `${tag} notification: ${e.title}`;
     case "structured_output_complete":
       return `${tag} structured output complete`;
+    case "transcript_init":
+      return `${tag} transcript: system prompt + ${e.messages.length} message(s)`;
   }
 };
 

package/dist/openai-STUANOLN.js

@@ -0,0 +1,7 @@
+import {
+  openai
+} from "./chunk-D2AU5FGJ.js";
+import "./chunk-3WRAEJP3.js";
+export {
+  openai
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kraken-ai",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Kraken AI SDK: a very lightweight, fully-typed multi-model AI agent framework",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -14,12 +14,12 @@
     }
   },
   "devDependencies": {
-    "@google/genai": "^1.45.0",
-    "@types/node": "^25.5.0",
+    "@google/genai": "^1.48.0",
+    "@types/node": "^25.5.2",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.3",
     "zod": "^4.3.6"
   },
   "peerDependencies": {

package/dist/google-GNB46G6S.js

@@ -1,7 +0,0 @@
-import {
-  google
-} from "./chunk-4X5NFWDA.js";
-import "./chunk-RBQ2PPDE.js";
-export {
-  google
-};

package/dist/openai-HXIIBATW.js

@@ -1,7 +0,0 @@
-import {
-  openai
-} from "./chunk-5XNFMNJL.js";
-import "./chunk-RBQ2PPDE.js";
-export {
-  openai
-};