llmz 0.0.30 → 0.0.32

package/dist/compiler/plugins/jsx-undefined-vars.d.ts

@@ -0,0 +1,14 @@
+import { type PluginObj } from '@babel/core';
+/**
+ * This plugin transforms JSX expressions that reference undefined variables
+ * into safe fallbacks that display the variable name as a string.
+ *
+ * For example:
+ *   <div>{content}</div>
+ * becomes:
+ *   <div>{(() => { try { return content } catch { return 'content' } })()}</div>
+ *
+ * This prevents "variable is not defined" errors when the LLM generates JSX
+ * with variable references that don't exist in the actual execution scope.
+ */
+export declare function jsxUndefinedVarsPlugin(): PluginObj;

package/dist/context.d.ts

@@ -50,6 +50,7 @@ export declare namespace IterationStatuses {
         thinking_requested: {
             reason?: string;
             variables: Record<string, unknown>;
+            metadata?: Record<string, unknown>;
         };
     };
     type Callback = {
@@ -351,6 +352,7 @@ export declare class Iteration implements Serializable<Iteration.JSON> {
     get tools(): Tool<import("./types.js").ZuiType, import("./types.js").ZuiType>[];
     get objects(): ObjectInstance[];
     get model(): Models | Models[];
+    set model(value: Models | Models[]);
     get temperature(): number;
     get exits(): Exit<unknown>[];
     get instructions(): string | undefined;
@@ -363,6 +365,12 @@ export declare class Iteration implements Serializable<Iteration.JSON> {
         spend: number;
         output: string;
         model: string;
+        usage: {
+            inputCost: number;
+            outputCost: number;
+            inputTokens: number;
+            outputTokens: number;
+        };
     };
     hasExited(this: this): this is this & {
         status: IterationStatuses.ExitSuccess;
@@ -407,6 +415,12 @@ export declare class Iteration implements Serializable<Iteration.JSON> {
             spend: number;
             output: string;
             model: string;
+            usage: {
+                inputCost: number;
+                outputCost: number;
+                inputTokens: number;
+                outputTokens: number;
+            };
         } | undefined;
         transcript: Transcript.Message[];
         tools: {
@@ -517,6 +531,12 @@ export declare class Context implements Serializable<Context.JSON> {
                 spend: number;
                 output: string;
                 model: string;
+                usage: {
+                    inputCost: number;
+                    outputCost: number;
+                    inputTokens: number;
+                    outputTokens: number;
+                };
             } | undefined;
             transcript: Transcript.Message[];
             tools: {

package/dist/{dual-modes-DW3KRXT2.js → dual-modes-LEAHGCOF.js}

@@ -1,6 +1,6 @@
 import {
   DualModePrompt
-} from "./chunk-HCC76DDO.js";
+} from "./chunk-AAHUDKBY.js";
 import "./chunk-YEAWWJSJ.js";
 import "./chunk-GGWM6X2K.js";
 import "./chunk-ORQP26SZ.js";

package/dist/{dual-modes-F4UV5VAZ.cjs → dual-modes-UBHAMQW4.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkWP4F6KMWcjs = require('./chunk-WP4F6KMW.cjs');
+var _chunk5BEKU5MZcjs = require('./chunk-5BEKU5MZ.cjs');
 require('./chunk-KIN7Y247.cjs');
 require('./chunk-ZRCU35UV.cjs');
 require('./chunk-KMZDFWYZ.cjs');
@@ -9,4 +9,4 @@ require('./chunk-WHNOR4ZU.cjs');
 require('./chunk-UQOBUJIQ.cjs');
 
 
-exports.DualModePrompt = _chunkWP4F6KMWcjs.DualModePrompt;
+exports.DualModePrompt = _chunk5BEKU5MZcjs.DualModePrompt;

package/dist/errors.d.ts

@@ -40,7 +40,8 @@ export declare class VMLoopSignal extends VMSignal {
 export declare class ThinkSignal extends VMLoopSignal {
     reason: string;
     context?: any;
-    constructor(reason: string, context?: any);
+    metadata?: Record<string, unknown> | undefined;
+    constructor(reason: string, context?: any, metadata?: Record<string, unknown> | undefined);
     toString(): string;
 }
 export declare class CodeExecutionError extends Error {

package/dist/exit-parser.d.ts

@@ -0,0 +1,37 @@
+import { Exit } from './exit.js';
+/**
+ * Result of parsing an exit from return value
+ */
+export type ParsedExit = {
+    success: true;
+    exit: Exit;
+    value: unknown;
+} | {
+    success: false;
+    error: string;
+    returnValue: unknown;
+};
+/**
+ * Parses and validates a return value against a list of exits.
+ * Attempts to intelligently fit the data to the expected schema.
+ *
+ * @param returnValue - The raw return value from code execution
+ * @param exits - Available exits to match against
+ * @returns Parsed exit result with validated data or error
+ *
+ * @example
+ * ```typescript
+ * const exits = [
+ *   new Exit({ name: 'done', schema: z.object({ result: z.string() }) })
+ * ]
+ *
+ * // Returns primitive value - will be smart-wrapped
+ * const result = parseExit({ action: 'done', data: 'hello' }, exits)
+ * // result.success === true
+ * // result.value === { result: 'hello' }
+ * ```
+ */
+export declare function parseExit(returnValue: {
+    action: string;
+    [key: string]: unknown;
+} | null, exits: Exit[]): ParsedExit;

package/dist/index.cjs

@@ -8,21 +8,22 @@
 
 
 
-var _chunkVADA6DMRcjs = require('./chunk-VADA6DMR.cjs');
-require('./chunk-WP4F6KMW.cjs');
 
+var _chunk4XIOQWVZcjs = require('./chunk-4XIOQWVZ.cjs');
+require('./chunk-5BEKU5MZ.cjs');
 
-var _chunk273DEMEUcjs = require('./chunk-273DEMEU.cjs');
 
+var _chunkSOEKWFU2cjs = require('./chunk-SOEKWFU2.cjs');
 
 
-var _chunkRLOPQZTQcjs = require('./chunk-RLOPQZTQ.cjs');
 
+var _chunkINDOGCAQcjs = require('./chunk-INDOGCAQ.cjs');
 
 
 
 
-var _chunkT63Y6GTWcjs = require('./chunk-T63Y6GTW.cjs');
+
+var _chunkPK72FAKDcjs = require('./chunk-PK72FAKD.cjs');
 require('./chunk-KIN7Y247.cjs');
 
 
@@ -296,12 +297,12 @@ async function hoistTypings(code, formatOptions) {
     } catch (err) {
       console.error(err);
       if (formatOptions.throwOnError) {
-        throw new (0, _chunkT63Y6GTWcjs.CodeFormattingError)(err instanceof Error ? err.message : String(_nullishCoalesce(err, () => ( "Unknown Error"))), code);
+        throw new (0, _chunkPK72FAKDcjs.CodeFormattingError)(err instanceof Error ? err.message : String(_nullishCoalesce(err, () => ( "Unknown Error"))), code);
       }
       break;
     }
   }
-  return _chunkRLOPQZTQcjs.formatTypings.call(void 0, code, formatOptions);
+  return _chunkINDOGCAQcjs.formatTypings.call(void 0, code, formatOptions);
 }
 
 // src/objects.ts
@@ -427,7 +428,7 @@ var ObjectInstance = class {
     this.description = props.description;
     this.metadata = _nullishCoalesce(props.metadata, () => ( {}));
     this.properties = props.properties;
-    this.tools = _chunk273DEMEUcjs.Tool.withUniqueNames(_nullishCoalesce(props.tools, () => ( [])));
+    this.tools = _chunkSOEKWFU2cjs.Tool.withUniqueNames(_nullishCoalesce(props.tools, () => ( [])));
   }
   /**
    * Generates TypeScript namespace declarations for this object.
@@ -508,7 +509,7 @@ function getObjectTypings(obj) {
         }
         let type = "unknown";
         if (prop.type) {
-          type = await _chunkRLOPQZTQcjs.getTypings.call(void 0, prop.type, {});
+          type = await _chunkINDOGCAQcjs.getTypings.call(void 0, prop.type, {});
         } else if (prop.value !== void 0) {
           type = typeof prop.value;
         }
@@ -528,7 +529,7 @@ function getObjectTypings(obj) {
       typings.push("");
       for (const tool of obj.tools) {
         const fnType = _zui.z.function(tool.zInput, tool.zOutput).title(tool.name).describe(_nullishCoalesce(tool.description, () => ( "")));
-        let temp = await _chunkRLOPQZTQcjs.getTypings.call(void 0, fnType, {
+        let temp = await _chunkINDOGCAQcjs.getTypings.call(void 0, fnType, {
           declaration: true
         });
         temp = temp.replace("declare function ", "function ");
@@ -551,7 +552,7 @@ function getObjectTypings(obj) {
     if ((_a = obj.description) == null ? void 0 : _a.trim().length) {
       header = _chunkWHNOR4ZUcjs.getMultilineComment.call(void 0, obj.description);
     }
-    return _chunkRLOPQZTQcjs.formatTypings.call(void 0, 
+    return _chunkINDOGCAQcjs.formatTypings.call(void 0, 
       `${header}
       export namespace ${obj.name} {
       ${body}
@@ -1103,20 +1104,20 @@ var utils = {
   truncateWrappedContent: _chunkGZPN7RGHcjs.truncateWrappedContent
 };
 var execute = async (props) => {
-  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-DYB74G5C.cjs")));
+  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-HGUVAYIN.cjs")));
   return executeContext(props);
 };
 var init = async () => {
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-DYB74G5C.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-HGUVAYIN.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./component-R4WTW6DZ.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./tool-GMYMVXUK.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./tool-JVLOALQN.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./exit-XAYKJ6TR.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./jsx-AJAXBWFE.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./vm-NGQ6DRS3.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./vm-VFORKC54.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./utils-L5QAQXV2.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./truncator-W3NXBLYJ.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./typings-2RAAZ2YP.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./dual-modes-F4UV5VAZ.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./typings-OLI56LGT.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./dual-modes-UBHAMQW4.cjs")));
 };
 
 
@@ -1145,4 +1146,5 @@ var init = async () => {
 
 
 
-exports.Chat = Chat; exports.CitationsManager = CitationsManager; exports.Component = _chunkZRCU35UVcjs.Component; exports.DefaultComponents = DefaultComponents; exports.DefaultExit = _chunkVADA6DMRcjs.DefaultExit; exports.ErrorExecutionResult = _chunkVADA6DMRcjs.ErrorExecutionResult; exports.ExecutionResult = _chunkVADA6DMRcjs.ExecutionResult; exports.Exit = _chunk3G3BS5IAcjs.Exit; exports.ListenExit = _chunkVADA6DMRcjs.ListenExit; exports.LoopExceededError = _chunkT63Y6GTWcjs.LoopExceededError; exports.ObjectInstance = ObjectInstance; exports.PartialExecutionResult = _chunkVADA6DMRcjs.PartialExecutionResult; exports.Snapshot = _chunkVADA6DMRcjs.Snapshot; exports.SnapshotSignal = _chunkT63Y6GTWcjs.SnapshotSignal; exports.SuccessExecutionResult = _chunkVADA6DMRcjs.SuccessExecutionResult; exports.ThinkExit = _chunkVADA6DMRcjs.ThinkExit; exports.ThinkSignal = _chunkT63Y6GTWcjs.ThinkSignal; exports.Tool = _chunk273DEMEUcjs.Tool; exports.assertValidComponent = _chunkZRCU35UVcjs.assertValidComponent; exports.execute = execute; exports.getValue = _chunkVADA6DMRcjs.getValue; exports.init = init; exports.isAnyComponent = _chunkZRCU35UVcjs.isAnyComponent; exports.isComponent = _chunkZRCU35UVcjs.isComponent; exports.renderToTsx = _chunkZRCU35UVcjs.renderToTsx; exports.utils = utils;
+
+exports.Chat = Chat; exports.CitationsManager = CitationsManager; exports.Component = _chunkZRCU35UVcjs.Component; exports.DefaultComponents = DefaultComponents; exports.DefaultExit = _chunk4XIOQWVZcjs.DefaultExit; exports.ErrorExecutionResult = _chunk4XIOQWVZcjs.ErrorExecutionResult; exports.ExecutionResult = _chunk4XIOQWVZcjs.ExecutionResult; exports.Exit = _chunk3G3BS5IAcjs.Exit; exports.ListenExit = _chunk4XIOQWVZcjs.ListenExit; exports.LoopExceededError = _chunkPK72FAKDcjs.LoopExceededError; exports.ObjectInstance = ObjectInstance; exports.PartialExecutionResult = _chunk4XIOQWVZcjs.PartialExecutionResult; exports.Snapshot = _chunk4XIOQWVZcjs.Snapshot; exports.SnapshotSignal = _chunkPK72FAKDcjs.SnapshotSignal; exports.SuccessExecutionResult = _chunk4XIOQWVZcjs.SuccessExecutionResult; exports.ThinkExit = _chunk4XIOQWVZcjs.ThinkExit; exports.ThinkSignal = _chunkPK72FAKDcjs.ThinkSignal; exports.Tool = _chunkSOEKWFU2cjs.Tool; exports.assertValidComponent = _chunkZRCU35UVcjs.assertValidComponent; exports.execute = execute; exports.getValue = _chunk4XIOQWVZcjs.getValue; exports.init = init; exports.isAnyComponent = _chunkZRCU35UVcjs.isAnyComponent; exports.isComponent = _chunkZRCU35UVcjs.isComponent; exports.parseExit = _chunk4XIOQWVZcjs.parseExit; exports.renderToTsx = _chunkZRCU35UVcjs.renderToTsx; exports.utils = utils;

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { Tool } from './tool.js';
 export { Exit, ExitResult } from './exit.js';
 export { ObjectInstance } from './objects.js';
 export { SnapshotSignal, ThinkSignal, LoopExceededError } from './errors.js';
+export { parseExit, type ParsedExit } from './exit-parser.js';
 export { Component, RenderedComponent, LeafComponentDefinition, ContainerComponentDefinition, DefaultComponentDefinition, ComponentDefinition, assertValidComponent, isComponent, isAnyComponent, renderToTsx, } from './component.js';
 export { Citation, CitationsManager } from './citations.js';
 export { DefaultComponents } from './component.default.js';

package/dist/index.js

@@ -7,22 +7,23 @@ import {
   Snapshot,
   SuccessExecutionResult,
   ThinkExit,
-  getValue
-} from "./chunk-KQPGB6GB.js";
-import "./chunk-HCC76DDO.js";
+  getValue,
+  parseExit
+} from "./chunk-4JN4PPGP.js";
+import "./chunk-AAHUDKBY.js";
 import {
   Tool
-} from "./chunk-7POUFE5M.js";
+} from "./chunk-23SY6IDW.js";
 import {
   formatTypings,
   getTypings
-} from "./chunk-IUE5BW56.js";
+} from "./chunk-U4HWJLF2.js";
 import {
   CodeFormattingError,
   LoopExceededError,
   SnapshotSignal,
   ThinkSignal
-} from "./chunk-MYLTD5WT.js";
+} from "./chunk-WSVDMGMR.js";
 import "./chunk-YEAWWJSJ.js";
 import {
   Exit
@@ -1103,20 +1104,20 @@ var utils = {
   truncateWrappedContent
 };
 var execute = async (props) => {
-  const { executeContext } = await import("./llmz-N6KWKJ2Q.js");
+  const { executeContext } = await import("./llmz-3E2JM3HM.js");
   return executeContext(props);
 };
 var init = async () => {
-  await import("./llmz-N6KWKJ2Q.js");
+  await import("./llmz-3E2JM3HM.js");
   await import("./component-WFVDVSDK.js");
-  await import("./tool-GEBXW6AQ.js");
+  await import("./tool-7QXH6A24.js");
   await import("./exit-YLO7BY7Z.js");
   await import("./jsx-AEHVFB3L.js");
-  await import("./vm-J6UNJGIN.js");
+  await import("./vm-Y3WY2627.js");
   await import("./utils-RQHQ2KOG.js");
   await import("./truncator-BSP6PQPC.js");
-  await import("./typings-3VYUEACY.js");
-  await import("./dual-modes-DW3KRXT2.js");
+  await import("./typings-ALZEKGV6.js");
+  await import("./dual-modes-LEAHGCOF.js");
 };
 export {
   Chat,
@@ -1143,6 +1144,7 @@ export {
   init,
   isAnyComponent,
   isComponent,
+  parseExit,
   renderToTsx,
   utils
 };

package/dist/{llmz-N6KWKJ2Q.js → llmz-3E2JM3HM.js}

@@ -1,16 +1,17 @@
 import {
   runAsyncFunction
-} from "./chunk-DCYSCVQM.js";
+} from "./chunk-G3LSBWJT.js";
 import {
   Context,
   ErrorExecutionResult,
   PartialExecutionResult,
   Snapshot,
-  SuccessExecutionResult
-} from "./chunk-KQPGB6GB.js";
-import "./chunk-HCC76DDO.js";
-import "./chunk-7POUFE5M.js";
-import "./chunk-IUE5BW56.js";
+  SuccessExecutionResult,
+  parseExit
+} from "./chunk-4JN4PPGP.js";
+import "./chunk-AAHUDKBY.js";
+import "./chunk-23SY6IDW.js";
+import "./chunk-U4HWJLF2.js";
 import {
   AssignmentError,
   CodeExecutionError,
@@ -21,7 +22,7 @@ import {
   SnapshotSignal,
   ThinkSignal,
   VMSignal
-} from "./chunk-MYLTD5WT.js";
+} from "./chunk-WSVDMGMR.js";
 import {
   cleanStackTrace
 } from "./chunk-YEAWWJSJ.js";
@@ -103,7 +104,7 @@ var executeContext = async (props) => {
 var _executeContext = async (props) => {
   var _a, _b;
   const controller = createJoinedAbortController([props.signal]);
-  const { onIterationEnd, onTrace, onExit, onBeforeExecution, onAfterTool, onBeforeTool } = props;
+  const { onIterationStart, onIterationEnd, onTrace, onExit, onBeforeExecution, onAfterTool, onBeforeTool } = props;
   const cognitive = Cognitive.isCognitiveClient(props.client) ? props.client : new Cognitive({ client: props.client });
   const cleanups = [];
   const ctx = new Context({
@@ -124,6 +125,19 @@ var _executeContext = async (props) => {
         return new ErrorExecutionResult(ctx, new LoopExceededError());
       }
       const iteration = await ctx.nextIteration();
+      try {
+        await executeOnIterationStartHook({
+          iteration,
+          ctx,
+          onIterationStart,
+          controller,
+          onIterationEnd
+        });
+      } catch (err) {
+        if (err instanceof ThinkSignal) {
+          continue;
+        }
+      }
       if (controller.signal.aborted) {
         iteration.end({
           type: "aborted",
@@ -276,7 +290,8 @@ var executeIteration = async ({
     tokens: output.meta.tokens.input + output.meta.tokens.output,
     spend: output.meta.cost.input + output.meta.cost.output,
     output: assistantResponse.raw,
-    model: `${output.meta.model.integration}:${output.meta.model.model}`
+    model: `${output.meta.model.integration}:${output.meta.model.model}`,
+    usage: output.output.usage
   };
   traces.push({
     type: "llm_call_success",
@@ -422,7 +437,8 @@ var executeIteration = async ({
       type: "thinking_requested",
       thinking_requested: {
         variables: result.signal.context,
-        reason: result.signal.reason
+        reason: result.signal.reason,
+        metadata: result.signal.metadata
       }
     });
   }
@@ -434,10 +450,8 @@ var executeIteration = async ({
       }
     });
   }
-  const validActions = [...iteration.exits.map((x) => x.name.toLowerCase()), "think"];
   let returnValue = result.success && result.return_value ? result.return_value : null;
   const returnAction = returnValue == null ? void 0 : returnValue.action;
-  const returnExit = iteration.exits.find((x) => x.name.toLowerCase() === (returnAction == null ? void 0 : returnAction.toLowerCase())) ?? iteration.exits.find((x) => x.aliases.some((a) => a.toLowerCase() === (returnAction == null ? void 0 : returnAction.toLowerCase())));
   if (returnAction === "think") {
     const variables = omit_default(returnValue ?? {}, "action");
     if (isPlainObject_default(variables) && Object.keys(variables).length > 0) {
@@ -457,40 +471,19 @@ var executeIteration = async ({
       }
     });
   }
-  if (!returnAction) {
-    return iteration.end({
-      type: "exit_error",
-      exit_error: {
-        exit: "n/a",
-        message: `Code did not return an action. Valid actions are: ${validActions.join(", ")}`,
-        return_value: returnValue
-      }
-    });
-  }
-  if (!returnExit) {
+  const parsedExit = parseExit(returnValue, iteration.exits);
+  if (!parsedExit.success) {
     return iteration.end({
       type: "exit_error",
       exit_error: {
-        exit: returnAction,
-        message: `Exit "${returnAction}" not found. Valid actions are: ${validActions.join(", ")}`,
+        exit: (returnValue == null ? void 0 : returnValue.action) ?? "n/a",
+        message: parsedExit.error,
         return_value: returnValue
       }
     });
   }
-  if (returnExit.zSchema) {
-    const parsed = returnExit.zSchema.safeParse(returnValue == null ? void 0 : returnValue.value);
-    if (!parsed.success) {
-      return iteration.end({
-        type: "exit_error",
-        exit_error: {
-          exit: returnExit.name,
-          message: `Invalid return value for exit ${returnExit.name}: ${getErrorMessage(parsed.error)}`,
-          return_value: returnValue
-        }
-      });
-    }
-    returnValue = { action: returnExit.name, value: parsed.data };
-  }
+  const returnExit = parsedExit.exit;
+  returnValue = { action: returnExit.name, value: parsedExit.value };
   try {
     await (onExit == null ? void 0 : onExit({
       exit: returnExit,
@@ -567,7 +560,9 @@ function wrapTool({ tool, traces, object, iteration, beforeHook, afterHook, cont
           iteration,
           tool,
           input: input2,
-          controller
+          controller,
+          object,
+          toolCallId
         }));
         if (typeof (beforeRes == null ? void 0 : beforeRes.input) !== "undefined") {
           input2 = beforeRes.input;
@@ -580,7 +575,9 @@ function wrapTool({ tool, traces, object, iteration, beforeHook, afterHook, cont
           tool,
           input: input2,
           output: output2,
-          controller
+          controller,
+          object,
+          toolCallId
         }));
         if (typeof (afterRes == null ? void 0 : afterRes.output) !== "undefined") {
           output2 = afterRes.output;
@@ -593,10 +590,23 @@ function wrapTool({ tool, traces, object, iteration, beforeHook, afterHook, cont
           output = res;
           success = true;
           return res;
-        }).catch((err) => {
+        }).catch(async (err) => {
           if (!handleSignals(err)) {
             success = false;
             error = err;
+          } else {
+            const afterRes = await (afterHook == null ? void 0 : afterHook({
+              iteration,
+              tool,
+              input,
+              output,
+              controller,
+              object,
+              toolCallId
+            }));
+            if (typeof (afterRes == null ? void 0 : afterRes.output) !== "undefined") {
+              output = afterRes.output;
+            }
           }
           throw err;
         }).finally(() => {
@@ -645,6 +655,39 @@ function wrapTool({ tool, traces, object, iteration, beforeHook, afterHook, cont
     return output;
   };
 }
+var executeOnIterationStartHook = async (props) => {
+  const { iteration, ctx, onIterationStart, controller, onIterationEnd } = props;
+  try {
+    const hookRes = await (onIterationStart == null ? void 0 : onIterationStart(iteration, controller, ctx));
+    if (hookRes) {
+      Object.assign(iteration, hookRes);
+    }
+  } catch (err) {
+    if (err instanceof ThinkSignal) {
+      iteration.end({
+        type: "thinking_requested",
+        thinking_requested: {
+          variables: err.context,
+          reason: err.reason
+        }
+      });
+      try {
+        await (onIterationEnd == null ? void 0 : onIterationEnd(iteration, controller));
+      } catch (err2) {
+        console.error(err2);
+      }
+    } else {
+      iteration.end({
+        type: "execution_error",
+        execution_error: {
+          message: `Error in onIterationStart hook: ${getErrorMessage(err)}`,
+          stack: cleanStackTrace(err.stack ?? "No stack trace available")
+        }
+      });
+    }
+    throw err;
+  }
+};
 export {
   _executeContext,
   executeContext