llmz 0.0.14 → 0.0.15

package/dist/exit-XAYKJ6TR.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk3G3BS5IAcjs = require('./chunk-3G3BS5IA.cjs');
+require('./chunk-WHNOR4ZU.cjs');
+require('./chunk-UQOBUJIQ.cjs');
+
+
+exports.Exit = _chunk3G3BS5IAcjs.Exit;

package/dist/{exit-7HDRH27N.js → exit-YLO7BY7Z.js}

@@ -1,7 +1,7 @@
 import {
   Exit
-} from "./chunk-XAN7HQP5.js";
-import "./chunk-4MNIJGK6.js";
+} from "./chunk-VPTFUOIK.js";
+import "./chunk-ZORRILUV.js";
 import "./chunk-7WRN4E42.js";
 export {
   Exit

package/dist/exit.d.ts

@@ -1,5 +1,5 @@
 import { JSONSchema7 } from 'json-schema';
-import { ZuiType } from './types.js';
+import { Serializable, ZuiType } from './types.js';
 /**
  * Represents the result of an agent execution that exited with a specific Exit.
  *
@@ -11,6 +11,15 @@ export type ExitResult<T = unknown> = {
     /** The result data returned by the exit (validated against the exit's schema) */
     result: T;
 };
+export declare namespace Exit {
+    type JSON = {
+        name: string;
+        aliases: string[];
+        description: string;
+        metadata: Record<string, unknown>;
+        schema?: JSONSchema7;
+    };
+}
 /**
  * Defines how LLMz agent execution can terminate.
  *
@@ -211,7 +220,7 @@ export type ExitResult<T = unknown> = {
  * @see {@link ListenExit} Built-in chat listening exit
  * @see {@link DefaultExit} Built-in completion exit
  */
-export declare class Exit<T = unknown> {
+export declare class Exit<T = unknown> implements Serializable<Exit.JSON> {
     /** The primary name of the exit (used in return statements) */
     name: string;
     /** Alternative names that can be used to reference this exit */
@@ -278,6 +287,31 @@ export declare class Exit<T = unknown> {
      * @returns True if the result was created by this exit
      */
     match(result: ExitResult): result is ExitResult<T>;
+    /**
+     * Serializes this exit to a JSON-compatible object.
+     *
+     * @returns JSON representation of the exit
+     *
+     * @example
+     * ```typescript
+     * const exit = new Exit({
+     *   name: 'complete',
+     *   description: 'Task completed successfully',
+     * })
+     *
+     * console.log(exit.toJSON())
+     * // { name: 'complete', aliases: [], description: 'Task completed successfully', metadata: {}, schema: undefined }
+     * ```
+     */
+    toJSON(): {
+        name: string;
+        aliases: string[];
+        description: string;
+        metadata: {
+            [x: string]: unknown;
+        };
+        schema: JSONSchema7 | undefined;
+    };
     /**
      * Creates a new Exit instance.
      *

package/dist/index.cjs

@@ -8,15 +8,15 @@
 
 
 
-var _chunkGOJY4GRLcjs = require('./chunk-GOJY4GRL.cjs');
-require('./chunk-SHJDRZF5.cjs');
+var _chunkTCRRSS44cjs = require('./chunk-TCRRSS44.cjs');
+require('./chunk-PIDLNYIP.cjs');
 
 
-var _chunkKG7DT7WDcjs = require('./chunk-KG7DT7WD.cjs');
+var _chunkXGJOEQMWcjs = require('./chunk-XGJOEQMW.cjs');
 
 
 
-var _chunk4L6D2A6Ocjs = require('./chunk-4L6D2A6O.cjs');
+var _chunkFZJHYLM2cjs = require('./chunk-FZJHYLM2.cjs');
 
 
 
@@ -26,7 +26,7 @@ var _chunkJDABP4SDcjs = require('./chunk-JDABP4SD.cjs');
 require('./chunk-IKSIOIIP.cjs');
 
 
-var _chunkWL7ZIMYDcjs = require('./chunk-WL7ZIMYD.cjs');
+var _chunk3G3BS5IAcjs = require('./chunk-3G3BS5IA.cjs');
 
 
 
@@ -35,12 +35,16 @@ var _chunkWL7ZIMYDcjs = require('./chunk-WL7ZIMYD.cjs');
 
 var _chunkZRCU35UVcjs = require('./chunk-ZRCU35UV.cjs');
 require('./chunk-KMZDFWYZ.cjs');
-require('./chunk-JGVAZO4X.cjs');
 
 
+var _chunkGZPN7RGHcjs = require('./chunk-GZPN7RGH.cjs');
 
 
-var _chunk276Q6EWPcjs = require('./chunk-276Q6EWP.cjs');
+
+
+
+
+var _chunkWHNOR4ZUcjs = require('./chunk-WHNOR4ZU.cjs');
 
 
 
@@ -296,7 +300,7 @@ async function hoistTypings(code, formatOptions) {
       break;
     }
   }
-  return _chunk4L6D2A6Ocjs.formatTypings.call(void 0, code, formatOptions);
+  return _chunkFZJHYLM2cjs.formatTypings.call(void 0, code, formatOptions);
 }
 
 // src/objects.ts
@@ -365,7 +369,7 @@ var ObjectInstance = class {
    */
   constructor(props) {
     var _a;
-    if (!_chunk276Q6EWPcjs.isValidIdentifier.call(void 0, props.name)) {
+    if (!_chunkWHNOR4ZUcjs.isValidIdentifier.call(void 0, props.name)) {
       throw new Error(
         `Invalid name for tool ${props.name}. A tool name must start with a letter and contain only letters, numbers, and underscores. It must be 1-50 characters long.`
       );
@@ -398,7 +402,7 @@ var ObjectInstance = class {
         if (props.properties.filter((p) => p.name === prop.name).length > 1) {
           throw new Error(`Duplicate property name "${prop.name}" in tool ${props.name}`);
         }
-        if (!_chunk276Q6EWPcjs.isValidIdentifier.call(void 0, prop.name)) {
+        if (!_chunkWHNOR4ZUcjs.isValidIdentifier.call(void 0, prop.name)) {
           throw new Error(
             `Invalid name for property ${prop.name}. A property name must start with a letter and contain only letters, numbers, and underscores. It must be 1-50 characters long.`
           );
@@ -422,7 +426,7 @@ var ObjectInstance = class {
     this.description = props.description;
     this.metadata = _nullishCoalesce(props.metadata, () => ( {}));
     this.properties = props.properties;
-    this.tools = _chunkKG7DT7WDcjs.Tool.withUniqueNames(_nullishCoalesce(props.tools, () => ( [])));
+    this.tools = _chunkXGJOEQMWcjs.Tool.withUniqueNames(_nullishCoalesce(props.tools, () => ( [])));
   }
   /**
    * Generates TypeScript namespace declarations for this object.
@@ -464,6 +468,24 @@ var ObjectInstance = class {
   async getTypings() {
     return getObjectTypings(this).withProperties().withTools().build();
   }
+  /**
+   * Converts this ObjectInstance to its JSON representation.
+   *
+   * This method serializes the object into a JSON format that includes its name,
+   * description, properties, tools, and metadata. It is used for serialization
+   * and transmission of the object state.
+   *
+   * @returns JSON representation of the ObjectInstance
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      description: this.description,
+      properties: this.properties,
+      tools: (_nullishCoalesce(this.tools, () => ( []))).map((tool) => tool.toJSON()),
+      metadata: this.metadata
+    };
+  }
 };
 function getObjectTypings(obj) {
   let includeProperties = false;
@@ -481,11 +503,11 @@ function getObjectTypings(obj) {
       for (const prop of _nullishCoalesce(obj.properties, () => ( []))) {
         const description = _nullishCoalesce(prop.description, () => ( ""));
         if (description == null ? void 0 : description.trim().length) {
-          typings.push(_chunk276Q6EWPcjs.getMultilineComment.call(void 0, description));
+          typings.push(_chunkWHNOR4ZUcjs.getMultilineComment.call(void 0, description));
         }
         let type = "unknown";
         if (prop.type) {
-          type = await _chunk4L6D2A6Ocjs.getTypings.call(void 0, prop.type, {});
+          type = await _chunkFZJHYLM2cjs.getTypings.call(void 0, prop.type, {});
         } else if (prop.value !== void 0) {
           type = typeof prop.value;
         }
@@ -505,7 +527,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 _chunk4L6D2A6Ocjs.getTypings.call(void 0, fnType, {
+        let temp = await _chunkFZJHYLM2cjs.getTypings.call(void 0, fnType, {
           declaration: true
         });
         temp = temp.replace("declare function ", "function ");
@@ -526,9 +548,9 @@ function getObjectTypings(obj) {
     typings.push("}" + closingBracket);
     let header = "";
     if ((_a = obj.description) == null ? void 0 : _a.trim().length) {
-      header = _chunk276Q6EWPcjs.getMultilineComment.call(void 0, obj.description);
+      header = _chunkWHNOR4ZUcjs.getMultilineComment.call(void 0, obj.description);
     }
-    return _chunk4L6D2A6Ocjs.formatTypings.call(void 0, 
+    return _chunkFZJHYLM2cjs.formatTypings.call(void 0, 
       `${header}
       export namespace ${obj.name} {
       ${body}
@@ -559,7 +581,7 @@ function getObjectTypings(obj) {
 }
 function embedPropertyValue(property) {
   if (typeof property.value === "string") {
-    return _chunk276Q6EWPcjs.escapeString.call(void 0, property.value);
+    return _chunkWHNOR4ZUcjs.escapeString.call(void 0, property.value);
   }
   if (Number.isNaN(property.value)) {
     return "NaN";
@@ -577,7 +599,7 @@ function embedPropertyValue(property) {
     return `new Date('${property.value.toISOString()}')`;
   }
   if (property.value instanceof RegExp) {
-    return `new RegExp(${_chunk276Q6EWPcjs.escapeString.call(void 0, property.value.source)}, ${_chunk276Q6EWPcjs.escapeString.call(void 0, property.value.flags)})`;
+    return `new RegExp(${_chunkWHNOR4ZUcjs.escapeString.call(void 0, property.value.source)}, ${_chunkWHNOR4ZUcjs.escapeString.call(void 0, property.value.flags)})`;
   }
   if (property.value === null) {
     return "null";
@@ -595,7 +617,7 @@ function embedPropertyValue(property) {
     return `${property.value}n`;
   }
   if (property.value instanceof Error) {
-    return `Error(${_chunk276Q6EWPcjs.escapeString.call(void 0, property.value.message)})`;
+    return `Error(${_chunkWHNOR4ZUcjs.escapeString.call(void 0, property.value.message)})`;
   }
   if (property.value instanceof Map) {
     return `new Map(${JSON.stringify(Array.from(property.value.entries()))})`;
@@ -1073,21 +1095,26 @@ var Chat = class {
 };
 
 // src/index.ts
+var utils = {
+  toValidObjectName: _chunkWHNOR4ZUcjs.toValidObjectName,
+  toValidFunctionName: _chunkWHNOR4ZUcjs.toValidFunctionName,
+  wrapContent: _chunkGZPN7RGHcjs.wrapContent
+};
 var execute = async (props) => {
-  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-TR4CQK4F.cjs")));
+  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-WVNKAMCP.cjs")));
   return executeContext(props);
 };
 var init = async () => {
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-TR4CQK4F.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-WVNKAMCP.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./component-R4WTW6DZ.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./tool-NS7EGK7Z.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./exit-O2WZUEFS.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./tool-O4SFRIE4.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-2DLG7V4G.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./utils-A7WNEFTA.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./truncator-DUMWEGQO.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./typings-2CPHOFDN.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./dual-modes-VLIGPIHX.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-Y45GMPZT.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./dual-modes-OFHV2C3X.cjs")));
 };
 
 
@@ -1115,4 +1142,5 @@ var init = async () => {
 
 
 
-exports.Chat = Chat; exports.CitationsManager = CitationsManager; exports.Component = _chunkZRCU35UVcjs.Component; exports.DefaultComponents = DefaultComponents; exports.DefaultExit = _chunkGOJY4GRLcjs.DefaultExit; exports.ErrorExecutionResult = _chunkGOJY4GRLcjs.ErrorExecutionResult; exports.ExecutionResult = _chunkGOJY4GRLcjs.ExecutionResult; exports.Exit = _chunkWL7ZIMYDcjs.Exit; exports.ListenExit = _chunkGOJY4GRLcjs.ListenExit; exports.LoopExceededError = _chunkJDABP4SDcjs.LoopExceededError; exports.ObjectInstance = ObjectInstance; exports.PartialExecutionResult = _chunkGOJY4GRLcjs.PartialExecutionResult; exports.Snapshot = _chunkGOJY4GRLcjs.Snapshot; exports.SnapshotSignal = _chunkJDABP4SDcjs.SnapshotSignal; exports.SuccessExecutionResult = _chunkGOJY4GRLcjs.SuccessExecutionResult; exports.ThinkExit = _chunkGOJY4GRLcjs.ThinkExit; exports.ThinkSignal = _chunkJDABP4SDcjs.ThinkSignal; exports.Tool = _chunkKG7DT7WDcjs.Tool; exports.assertValidComponent = _chunkZRCU35UVcjs.assertValidComponent; exports.execute = execute; exports.getValue = _chunkGOJY4GRLcjs.getValue; exports.init = init; exports.isAnyComponent = _chunkZRCU35UVcjs.isAnyComponent; exports.isComponent = _chunkZRCU35UVcjs.isComponent; exports.renderToTsx = _chunkZRCU35UVcjs.renderToTsx;
+
+exports.Chat = Chat; exports.CitationsManager = CitationsManager; exports.Component = _chunkZRCU35UVcjs.Component; exports.DefaultComponents = DefaultComponents; exports.DefaultExit = _chunkTCRRSS44cjs.DefaultExit; exports.ErrorExecutionResult = _chunkTCRRSS44cjs.ErrorExecutionResult; exports.ExecutionResult = _chunkTCRRSS44cjs.ExecutionResult; exports.Exit = _chunk3G3BS5IAcjs.Exit; exports.ListenExit = _chunkTCRRSS44cjs.ListenExit; exports.LoopExceededError = _chunkJDABP4SDcjs.LoopExceededError; exports.ObjectInstance = ObjectInstance; exports.PartialExecutionResult = _chunkTCRRSS44cjs.PartialExecutionResult; exports.Snapshot = _chunkTCRRSS44cjs.Snapshot; exports.SnapshotSignal = _chunkJDABP4SDcjs.SnapshotSignal; exports.SuccessExecutionResult = _chunkTCRRSS44cjs.SuccessExecutionResult; exports.ThinkExit = _chunkTCRRSS44cjs.ThinkExit; exports.ThinkSignal = _chunkJDABP4SDcjs.ThinkSignal; exports.Tool = _chunkXGJOEQMWcjs.Tool; exports.assertValidComponent = _chunkZRCU35UVcjs.assertValidComponent; exports.execute = execute; exports.getValue = _chunkTCRRSS44cjs.getValue; exports.init = init; exports.isAnyComponent = _chunkZRCU35UVcjs.isAnyComponent; exports.isComponent = _chunkZRCU35UVcjs.isComponent; exports.renderToTsx = _chunkZRCU35UVcjs.renderToTsx; exports.utils = utils;

package/dist/index.d.ts

@@ -9,11 +9,19 @@ export { Snapshot } from './snapshots.js';
 export { Chat, type MessageHandler } from './chat.js';
 import { type ExecutionProps } from './llmz.js';
 import { ExecutionResult } from './result.js';
+import { wrapContent } from './truncator.js';
 export { Transcript } from './transcript.js';
 export { ErrorExecutionResult, ExecutionResult, PartialExecutionResult, SuccessExecutionResult } from './result.js';
-export { Trace } from './types.js';
+export { type Trace, type Traces } from './types.js';
 export { type Iteration, ListenExit, ThinkExit, DefaultExit, IterationStatuses, IterationStatus } from './context.js';
+export { type Context } from './context.js';
+export type { LLMzPrompts } from './prompts/prompt.js';
 export { type ValueOrGetter, getValue } from './getter.js';
+export declare const utils: {
+    toValidObjectName: (str: string) => string;
+    toValidFunctionName: (str: string) => string;
+    wrapContent: typeof wrapContent;
+};
 /**
  * Executes an LLMz agent in either Chat Mode or Worker Mode.
  *

package/dist/index.js

@@ -8,15 +8,15 @@ import {
   SuccessExecutionResult,
   ThinkExit,
   getValue
-} from "./chunk-2Z5SFF6R.js";
-import "./chunk-KH6JQYQA.js";
+} from "./chunk-RBRTK37G.js";
+import "./chunk-2D2DE7CD.js";
 import {
   Tool
-} from "./chunk-OKTHMXRT.js";
+} from "./chunk-A7QHWVD7.js";
 import {
   formatTypings,
   getTypings
-} from "./chunk-IH2WQFO5.js";
+} from "./chunk-EE6NVDID.js";
 import {
   CodeFormattingError,
   LoopExceededError,
@@ -26,7 +26,7 @@ import {
 import "./chunk-JQBT7UWN.js";
 import {
   Exit
-} from "./chunk-XAN7HQP5.js";
+} from "./chunk-VPTFUOIK.js";
 import {
   Component,
   assertValidComponent,
@@ -35,12 +35,16 @@ import {
   renderToTsx
 } from "./chunk-GGWM6X2K.js";
 import "./chunk-ORQP26SZ.js";
-import "./chunk-SNDVQU5A.js";
+import {
+  wrapContent
+} from "./chunk-3JYCCI4S.js";
 import {
   escapeString,
   getMultilineComment,
-  isValidIdentifier
-} from "./chunk-4MNIJGK6.js";
+  isValidIdentifier,
+  toValidFunctionName,
+  toValidObjectName
+} from "./chunk-ZORRILUV.js";
 import {
   cloneDeep_default,
   upperFirst_default
@@ -464,6 +468,24 @@ var ObjectInstance = class {
   async getTypings() {
     return getObjectTypings(this).withProperties().withTools().build();
   }
+  /**
+   * Converts this ObjectInstance to its JSON representation.
+   *
+   * This method serializes the object into a JSON format that includes its name,
+   * description, properties, tools, and metadata. It is used for serialization
+   * and transmission of the object state.
+   *
+   * @returns JSON representation of the ObjectInstance
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      description: this.description,
+      properties: this.properties,
+      tools: (this.tools ?? []).map((tool) => tool.toJSON()),
+      metadata: this.metadata
+    };
+  }
 };
 function getObjectTypings(obj) {
   let includeProperties = false;
@@ -1073,21 +1095,26 @@ var Chat = class {
 };
 
 // src/index.ts
+var utils = {
+  toValidObjectName,
+  toValidFunctionName,
+  wrapContent
+};
 var execute = async (props) => {
-  const { executeContext } = await import("./llmz-MCHRHRTD.js");
+  const { executeContext } = await import("./llmz-67EZPJ4E.js");
   return executeContext(props);
 };
 var init = async () => {
-  await import("./llmz-MCHRHRTD.js");
+  await import("./llmz-67EZPJ4E.js");
   await import("./component-WFVDVSDK.js");
-  await import("./tool-4AJIJ3QB.js");
-  await import("./exit-7HDRH27N.js");
+  await import("./tool-PCOYOCRH.js");
+  await import("./exit-YLO7BY7Z.js");
   await import("./jsx-AEHVFB3L.js");
   await import("./vm-FLBMZUA2.js");
-  await import("./utils-N24IHDFA.js");
-  await import("./truncator-IY2MXOMC.js");
-  await import("./typings-GDMY6VY2.js");
-  await import("./dual-modes-T53P72CH.js");
+  await import("./utils-RQHQ2KOG.js");
+  await import("./truncator-BSP6PQPC.js");
+  await import("./typings-WYHEFCYB.js");
+  await import("./dual-modes-7FI4T35O.js");
 };
 export {
   Chat,
@@ -1114,5 +1141,6 @@ export {
   init,
   isAnyComponent,
   isComponent,
-  renderToTsx
+  renderToTsx,
+  utils
 };

package/dist/{llmz-MCHRHRTD.js → llmz-67EZPJ4E.js}

@@ -7,10 +7,10 @@ import {
   PartialExecutionResult,
   Snapshot,
   SuccessExecutionResult
-} from "./chunk-2Z5SFF6R.js";
-import "./chunk-KH6JQYQA.js";
-import "./chunk-OKTHMXRT.js";
-import "./chunk-IH2WQFO5.js";
+} from "./chunk-RBRTK37G.js";
+import "./chunk-2D2DE7CD.js";
+import "./chunk-A7QHWVD7.js";
+import "./chunk-EE6NVDID.js";
 import {
   AssignmentError,
   CodeExecutionError,
@@ -24,16 +24,16 @@ import {
 import {
   cleanStackTrace
 } from "./chunk-JQBT7UWN.js";
-import "./chunk-XAN7HQP5.js";
+import "./chunk-VPTFUOIK.js";
 import "./chunk-GGWM6X2K.js";
 import "./chunk-ORQP26SZ.js";
 import {
   truncateWrappedContent
-} from "./chunk-SNDVQU5A.js";
+} from "./chunk-3JYCCI4S.js";
 import {
   init,
   stripInvalidIdentifiers
-} from "./chunk-4MNIJGK6.js";
+} from "./chunk-ZORRILUV.js";
 import {
   clamp_default,
   isEqual_default,

package/dist/{llmz-TR4CQK4F.cjs → llmz-WVNKAMCP.cjs}

@@ -7,10 +7,10 @@ var _chunkBEPRLBPKcjs = require('./chunk-BEPRLBPK.cjs');
 
 
 
-var _chunkGOJY4GRLcjs = require('./chunk-GOJY4GRL.cjs');
-require('./chunk-SHJDRZF5.cjs');
-require('./chunk-KG7DT7WD.cjs');
-require('./chunk-4L6D2A6O.cjs');
+var _chunkTCRRSS44cjs = require('./chunk-TCRRSS44.cjs');
+require('./chunk-PIDLNYIP.cjs');
+require('./chunk-XGJOEQMW.cjs');
+require('./chunk-FZJHYLM2.cjs');
 
 
 
@@ -24,16 +24,16 @@ var _chunkJDABP4SDcjs = require('./chunk-JDABP4SD.cjs');
 
 
 var _chunkIKSIOIIPcjs = require('./chunk-IKSIOIIP.cjs');
-require('./chunk-WL7ZIMYD.cjs');
+require('./chunk-3G3BS5IA.cjs');
 require('./chunk-ZRCU35UV.cjs');
 require('./chunk-KMZDFWYZ.cjs');
 
 
-var _chunkJGVAZO4Xcjs = require('./chunk-JGVAZO4X.cjs');
+var _chunkGZPN7RGHcjs = require('./chunk-GZPN7RGH.cjs');
 
 
 
-var _chunk276Q6EWPcjs = require('./chunk-276Q6EWP.cjs');
+var _chunkWHNOR4ZUcjs = require('./chunk-WHNOR4ZU.cjs');
 
 
 
@@ -91,7 +91,7 @@ var getModelOutputLimit = (inputLength) => _chunkUQOBUJIQcjs.clamp_default.call(
 );
 var executeContext = async (props) => {
   var _a, _b;
-  await _chunk276Q6EWPcjs.init.call(void 0, );
+  await _chunkWHNOR4ZUcjs.init.call(void 0, );
   const result = await _executeContext(props);
   try {
     (_b = (_a = result.context.chat) == null ? void 0 : _a.onExecutionDone) == null ? void 0 : _b.call(_a, result);
@@ -105,7 +105,7 @@ var _executeContext = async (props) => {
   const { onIterationEnd, onTrace, onExit, onBeforeExecution, onAfterTool, onBeforeTool } = props;
   const cognitive = _cognitive.Cognitive.isCognitiveClient(props.client) ? props.client : new (0, _cognitive.Cognitive)({ client: props.client });
   const cleanups = [];
-  const ctx = new (0, _chunkGOJY4GRLcjs.Context)({
+  const ctx = new (0, _chunkTCRRSS44cjs.Context)({
     chat: props.chat,
     instructions: props.instructions,
     objects: props.objects,
@@ -120,7 +120,7 @@ var _executeContext = async (props) => {
   try {
     while (true) {
       if (ctx.iterations.length >= ctx.loop) {
-        return new (0, _chunkGOJY4GRLcjs.ErrorExecutionResult)(ctx, new (0, _chunkJDABP4SDcjs.LoopExceededError)());
+        return new (0, _chunkTCRRSS44cjs.ErrorExecutionResult)(ctx, new (0, _chunkJDABP4SDcjs.LoopExceededError)());
       }
       const iteration = await ctx.nextIteration();
       if (controller.signal.aborted) {
@@ -130,7 +130,7 @@ var _executeContext = async (props) => {
             reason: _nullishCoalesce(controller.signal.reason, () => ( "The operation was aborted"))
           }
         });
-        return new (0, _chunkGOJY4GRLcjs.ErrorExecutionResult)(ctx, _nullishCoalesce(controller.signal.reason, () => ( "The operation was aborted")));
+        return new (0, _chunkTCRRSS44cjs.ErrorExecutionResult)(ctx, _nullishCoalesce(controller.signal.reason, () => ( "The operation was aborted")));
       }
       cleanups.push(
         iteration.traces.onPush((traces) => {
@@ -166,25 +166,25 @@ var _executeContext = async (props) => {
       }
       if (iteration.status.type === "exit_success") {
         const exitName = iteration.status.exit_success.exit_name;
-        return new (0, _chunkGOJY4GRLcjs.SuccessExecutionResult)(ctx, {
+        return new (0, _chunkTCRRSS44cjs.SuccessExecutionResult)(ctx, {
           exit: iteration.exits.find((x) => x.name === exitName),
           result: iteration.status.exit_success.return_value
         });
       }
       if (iteration.status.type === "callback_requested") {
-        return new (0, _chunkGOJY4GRLcjs.PartialExecutionResult)(
+        return new (0, _chunkTCRRSS44cjs.PartialExecutionResult)(
           ctx,
           iteration.status.callback_requested.signal,
-          _chunkGOJY4GRLcjs.Snapshot.fromSignal(iteration.status.callback_requested.signal)
+          _chunkTCRRSS44cjs.Snapshot.fromSignal(iteration.status.callback_requested.signal)
         );
       }
       if (iteration.status.type === "thinking_requested" || iteration.status.type === "exit_error" || iteration.status.type === "execution_error" || iteration.status.type === "invalid_code_error") {
         continue;
       }
-      return new (0, _chunkGOJY4GRLcjs.ErrorExecutionResult)(ctx, _nullishCoalesce(iteration.error, () => ( `Unknown error. Status: ${iteration.status.type}`)));
+      return new (0, _chunkTCRRSS44cjs.ErrorExecutionResult)(ctx, _nullishCoalesce(iteration.error, () => ( `Unknown error. Status: ${iteration.status.type}`)));
     }
   } catch (error) {
-    return new (0, _chunkGOJY4GRLcjs.ErrorExecutionResult)(ctx, _nullishCoalesce(error, () => ( "Unknown error")));
+    return new (0, _chunkTCRRSS44cjs.ErrorExecutionResult)(ctx, _nullishCoalesce(error, () => ( "Unknown error")));
   } finally {
     for (const cleanup of cleanups) {
       try {
@@ -210,7 +210,7 @@ var executeIteration = async ({
   const model = await cognitive.getModelDetails(_nullishCoalesce(ctx.model, () => ( "best")));
   const modelLimit = model.input.maxTokens;
   const responseLengthBuffer = getModelOutputLimit(modelLimit);
-  const messages = _chunkJGVAZO4Xcjs.truncateWrappedContent.call(void 0, {
+  const messages = _chunkGZPN7RGHcjs.truncateWrappedContent.call(void 0, {
     messages: iteration.messages,
     tokenLimit: modelLimit - responseLengthBuffer,
     throwOnFailure: true
@@ -284,7 +284,7 @@ var executeIteration = async ({
     model: model.ref,
     code: iteration.code
   });
-  const vmContext = { ..._chunk276Q6EWPcjs.stripInvalidIdentifiers.call(void 0, iteration.variables) };
+  const vmContext = { ..._chunkWHNOR4ZUcjs.stripInvalidIdentifiers.call(void 0, iteration.variables) };
   for (const obj of iteration.objects) {
     const internalValues = {};
     const instance = {};

package/dist/objects.d.ts

@@ -1,5 +1,6 @@
 import { z } from '@bpinternal/zui';
 import { Tool } from './tool.js';
+import { Serializable } from './types.js';
 /**
  * Defines a property within an ObjectInstance.
  *
@@ -30,6 +31,15 @@ export type ObjectProperty = {
     /** Whether the LLM can modify this property (default: false) */
     writable?: boolean;
 };
+export declare namespace ObjectInstance {
+    type JSON = {
+        name: string;
+        description?: string;
+        properties?: ObjectProperty[];
+        tools?: Tool.JSON[];
+        metadata?: Record<string, unknown>;
+    };
+}
 /**
  * ObjectInstance creates stateful, namespace-scoped objects for LLMz agents.
  *
@@ -228,7 +238,7 @@ export type ObjectProperty = {
  *
  * @see {@link https://github.com/botpress/botpress/blob/master/packages/llmz/examples/09_chat_variables/index.ts} Example usage
  */
-export declare class ObjectInstance {
+export declare class ObjectInstance implements Serializable<ObjectInstance.JSON> {
     name: string;
     description?: string;
     properties?: ObjectProperty[];
@@ -335,4 +345,29 @@ export declare class ObjectInstance {
      * ```
      */
     getTypings(): Promise<string>;
+    /**
+     * Converts this ObjectInstance to its JSON representation.
+     *
+     * This method serializes the object into a JSON format that includes its name,
+     * description, properties, tools, and metadata. It is used for serialization
+     * and transmission of the object state.
+     *
+     * @returns JSON representation of the ObjectInstance
+     */
+    toJSON(): {
+        name: string;
+        description: string | undefined;
+        properties: ObjectProperty[] | undefined;
+        tools: {
+            name: string;
+            aliases: string[];
+            description: string | undefined;
+            metadata: Record<string, unknown>;
+            input: import("json-schema").JSONSchema7 | undefined;
+            output: import("json-schema").JSONSchema7 | undefined;
+            staticInputValues: unknown;
+            maxRetries: number;
+        }[];
+        metadata: Record<string, unknown> | undefined;
+    };
 }