llmz 0.0.15 → 0.0.17

package/dist/{chunk-TCRRSS44.cjs → chunk-2NU62OI4.cjs}

@@ -228,7 +228,7 @@ var TranscriptArray = class extends Array {
     items = Array.isArray(items) ? items : [];
     super(...items);
     items.forEach((item) => {
-      if (!["user", "assistant"].includes(item.role)) {
+      if (!["user", "assistant", "event", "summary"].includes(item.role)) {
         throw new Error(`Invalid role "${item.role}" in transcript message`);
       }
       if ("name" in item && item.name && typeof item.name !== "string") {

package/dist/{chunk-RBRTK37G.js → chunk-QIZBF7A5.js}

@@ -228,7 +228,7 @@ var TranscriptArray = class extends Array {
     items = Array.isArray(items) ? items : [];
     super(...items);
     items.forEach((item) => {
-      if (!["user", "assistant"].includes(item.role)) {
+      if (!["user", "assistant", "event", "summary"].includes(item.role)) {
         throw new Error(`Invalid role "${item.role}" in transcript message`);
       }
       if ("name" in item && item.name && typeof item.name !== "string") {

package/dist/index.cjs

@@ -8,7 +8,7 @@
 
 
 
-var _chunkTCRRSS44cjs = require('./chunk-TCRRSS44.cjs');
+var _chunk2NU62OI4cjs = require('./chunk-2NU62OI4.cjs');
 require('./chunk-PIDLNYIP.cjs');
 
 
@@ -37,6 +37,7 @@ var _chunkZRCU35UVcjs = require('./chunk-ZRCU35UV.cjs');
 require('./chunk-KMZDFWYZ.cjs');
 
 
+
 var _chunkGZPN7RGHcjs = require('./chunk-GZPN7RGH.cjs');
 
 
@@ -1098,14 +1099,15 @@ var Chat = class {
 var utils = {
   toValidObjectName: _chunkWHNOR4ZUcjs.toValidObjectName,
   toValidFunctionName: _chunkWHNOR4ZUcjs.toValidFunctionName,
-  wrapContent: _chunkGZPN7RGHcjs.wrapContent
+  wrapContent: _chunkGZPN7RGHcjs.wrapContent,
+  truncateWrappedContent: _chunkGZPN7RGHcjs.truncateWrappedContent
 };
 var execute = async (props) => {
-  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-WVNKAMCP.cjs")));
+  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-EUESEPB7.cjs")));
   return executeContext(props);
 };
 var init = async () => {
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-WVNKAMCP.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./llmz-EUESEPB7.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./component-R4WTW6DZ.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./tool-O4SFRIE4.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./exit-XAYKJ6TR.cjs")));
@@ -1143,4 +1145,4 @@ var init = async () => {
 
 
 
-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;
+exports.Chat = Chat; exports.CitationsManager = CitationsManager; exports.Component = _chunkZRCU35UVcjs.Component; exports.DefaultComponents = DefaultComponents; exports.DefaultExit = _chunk2NU62OI4cjs.DefaultExit; exports.ErrorExecutionResult = _chunk2NU62OI4cjs.ErrorExecutionResult; exports.ExecutionResult = _chunk2NU62OI4cjs.ExecutionResult; exports.Exit = _chunk3G3BS5IAcjs.Exit; exports.ListenExit = _chunk2NU62OI4cjs.ListenExit; exports.LoopExceededError = _chunkJDABP4SDcjs.LoopExceededError; exports.ObjectInstance = ObjectInstance; exports.PartialExecutionResult = _chunk2NU62OI4cjs.PartialExecutionResult; exports.Snapshot = _chunk2NU62OI4cjs.Snapshot; exports.SnapshotSignal = _chunkJDABP4SDcjs.SnapshotSignal; exports.SuccessExecutionResult = _chunk2NU62OI4cjs.SuccessExecutionResult; exports.ThinkExit = _chunk2NU62OI4cjs.ThinkExit; exports.ThinkSignal = _chunkJDABP4SDcjs.ThinkSignal; exports.Tool = _chunkXGJOEQMWcjs.Tool; exports.assertValidComponent = _chunkZRCU35UVcjs.assertValidComponent; exports.execute = execute; exports.getValue = _chunk2NU62OI4cjs.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,7 +9,7 @@ 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';
+import { truncateWrappedContent, wrapContent } from './truncator.js';
 export { Transcript } from './transcript.js';
 export { ErrorExecutionResult, ExecutionResult, PartialExecutionResult, SuccessExecutionResult } from './result.js';
 export { type Trace, type Traces } from './types.js';
@@ -21,6 +21,7 @@ export declare const utils: {
     toValidObjectName: (str: string) => string;
     toValidFunctionName: (str: string) => string;
     wrapContent: typeof wrapContent;
+    truncateWrappedContent: typeof truncateWrappedContent;
 };
 /**
  * Executes an LLMz agent in either Chat Mode or Worker Mode.

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   SuccessExecutionResult,
   ThinkExit,
   getValue
-} from "./chunk-RBRTK37G.js";
+} from "./chunk-QIZBF7A5.js";
 import "./chunk-2D2DE7CD.js";
 import {
   Tool
@@ -36,6 +36,7 @@ import {
 } from "./chunk-GGWM6X2K.js";
 import "./chunk-ORQP26SZ.js";
 import {
+  truncateWrappedContent,
   wrapContent
 } from "./chunk-3JYCCI4S.js";
 import {
@@ -1098,14 +1099,15 @@ var Chat = class {
 var utils = {
   toValidObjectName,
   toValidFunctionName,
-  wrapContent
+  wrapContent,
+  truncateWrappedContent
 };
 var execute = async (props) => {
-  const { executeContext } = await import("./llmz-67EZPJ4E.js");
+  const { executeContext } = await import("./llmz-T4DEP7OD.js");
   return executeContext(props);
 };
 var init = async () => {
-  await import("./llmz-67EZPJ4E.js");
+  await import("./llmz-T4DEP7OD.js");
   await import("./component-WFVDVSDK.js");
   await import("./tool-PCOYOCRH.js");
   await import("./exit-YLO7BY7Z.js");

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

@@ -7,7 +7,7 @@ var _chunkBEPRLBPKcjs = require('./chunk-BEPRLBPK.cjs');
 
 
 
-var _chunkTCRRSS44cjs = require('./chunk-TCRRSS44.cjs');
+var _chunk2NU62OI4cjs = require('./chunk-2NU62OI4.cjs');
 require('./chunk-PIDLNYIP.cjs');
 require('./chunk-XGJOEQMW.cjs');
 require('./chunk-FZJHYLM2.cjs');
@@ -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, _chunkTCRRSS44cjs.Context)({
+  const ctx = new (0, _chunk2NU62OI4cjs.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, _chunkTCRRSS44cjs.ErrorExecutionResult)(ctx, new (0, _chunkJDABP4SDcjs.LoopExceededError)());
+        return new (0, _chunk2NU62OI4cjs.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, _chunkTCRRSS44cjs.ErrorExecutionResult)(ctx, _nullishCoalesce(controller.signal.reason, () => ( "The operation was aborted")));
+        return new (0, _chunk2NU62OI4cjs.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, _chunkTCRRSS44cjs.SuccessExecutionResult)(ctx, {
+        return new (0, _chunk2NU62OI4cjs.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, _chunkTCRRSS44cjs.PartialExecutionResult)(
+        return new (0, _chunk2NU62OI4cjs.PartialExecutionResult)(
           ctx,
           iteration.status.callback_requested.signal,
-          _chunkTCRRSS44cjs.Snapshot.fromSignal(iteration.status.callback_requested.signal)
+          _chunk2NU62OI4cjs.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, _chunkTCRRSS44cjs.ErrorExecutionResult)(ctx, _nullishCoalesce(iteration.error, () => ( `Unknown error. Status: ${iteration.status.type}`)));
+      return new (0, _chunk2NU62OI4cjs.ErrorExecutionResult)(ctx, _nullishCoalesce(iteration.error, () => ( `Unknown error. Status: ${iteration.status.type}`)));
     }
   } catch (error) {
-    return new (0, _chunkTCRRSS44cjs.ErrorExecutionResult)(ctx, _nullishCoalesce(error, () => ( "Unknown error")));
+    return new (0, _chunk2NU62OI4cjs.ErrorExecutionResult)(ctx, _nullishCoalesce(error, () => ( "Unknown error")));
   } finally {
     for (const cleanup of cleanups) {
       try {

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

@@ -7,7 +7,7 @@ import {
   PartialExecutionResult,
   Snapshot,
   SuccessExecutionResult
-} from "./chunk-RBRTK37G.js";
+} from "./chunk-QIZBF7A5.js";
 import "./chunk-2D2DE7CD.js";
 import "./chunk-A7QHWVD7.js";
 import "./chunk-EE6NVDID.js";

package/dist/truncator.d.ts

@@ -15,6 +15,102 @@ type TruncateOptions = {
     /** If provided, the message will never truncate below that number */
     minTokens: number;
 };
+/**
+ * Wraps content with truncation tags to mark it as truncatable when using `truncateWrappedContent`.
+ *
+ * This function encases the provided content within special truncation tags that contain metadata
+ * about how the content should be truncated. The wrapped content becomes eligible for intelligent
+ * truncation while preserving non-wrapped content intact.
+ *
+ * @param content - The string content to wrap with truncation tags
+ * @param options - Optional truncation configuration
+ * @param options.preserve - Which part of the content to preserve when truncating:
+ *   - 'top': Keep the beginning, remove from the end (default)
+ *   - 'bottom': Keep the end, remove from the beginning
+ *   - 'both': Keep both ends, remove from the middle
+ * @param options.flex - Priority factor for truncation (default: 1). Higher values make this
+ *   content more likely to be truncated. A flex of 2 means this content can shrink twice as
+ *   much as content with flex of 1.
+ * @param options.minTokens - Minimum number of tokens to preserve (default: 0). Content will
+ *   never be truncated below this threshold.
+ *
+ * @returns The content wrapped with truncation tags and embedded metadata
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - content will be truncated from the end if needed
+ * const wrapped = wrapContent("This is some long content that might need truncation")
+ *
+ * // Preserve the end of the content
+ * const bottomPreserved = wrapContent("Error log: ... important error details", {
+ *   preserve: 'bottom'
+ * })
+ *
+ * // High priority for truncation with minimum preservation
+ * const flexible = wrapContent("Optional context information", {
+ *   flex: 3,
+ *   minTokens: 50
+ * })
+ * ```
+ */
 export declare function wrapContent(content: string, options?: Partial<TruncateOptions>): string;
+/**
+ * Intelligently truncates message content to fit within a token limit while preserving important parts.
+ *
+ * This function processes an array of messages and reduces their total token count to fit within the
+ * specified limit. It only truncates content that has been wrapped with `wrapContent()`, leaving
+ * unwrapped content completely intact. The truncation algorithm prioritizes content based on flex
+ * values and respects preservation preferences and minimum token requirements.
+ *
+ * ## How it works:
+ * 1. **Parsing**: Scans each message for wrapped content sections and unwrapped sections
+ * 2. **Token counting**: Calculates tokens for each section using the configured tokenizer
+ * 3. **Prioritization**: Identifies the largest truncatable sections based on flex values
+ * 4. **Intelligent truncation**: Removes content according to preservation preferences
+ * 5. **Reconstruction**: Rebuilds messages with truncated content and removes wrapper tags
+ *
+ * ## Truncation strategy:
+ * - **Priority**: Higher flex values = higher truncation priority
+ * - **Minimum tokens**: Content is never truncated below its `minTokens` threshold
+ * - **Preservation modes**:
+ *   - `'top'`: Removes from the end, keeps the beginning
+ *   - `'bottom'`: Removes from the beginning, keeps the end
+ *   - `'both'`: Removes from the middle, keeps both ends
+ *
+ * @template T - Type extending MessageLike (must have a content property)
+ * @param options - Configuration object
+ * @param options.messages - Array of messages to truncate
+ * @param options.tokenLimit - Maximum total tokens allowed across all messages
+ * @param options.throwOnFailure - Whether to throw an error if truncation fails (default: true).
+ *   If false, returns the best effort result even if over the token limit.
+ *
+ * @returns Array of messages with content truncated to fit the token limit
+ *
+ * @throws Error if unable to truncate enough content to meet the token limit (when throwOnFailure is true)
+ *
+ * @example
+ * ```typescript
+ * const messages = [
+ *   {
+ *     role: 'system',
+ *     content: 'You are a helpful assistant. ' + wrapContent('Here is some background info...', { flex: 2 })
+ *   },
+ *   {
+ *     role: 'user',
+ *     content: 'Please help me with: ' + wrapContent('detailed context and examples', { preserve: 'both' })
+ *   }
+ * ]
+ *
+ * // Truncate to fit within 1000 tokens
+ * const truncated = truncateWrappedContent({
+ *   messages,
+ *   tokenLimit: 1000,
+ *   throwOnFailure: false
+ * })
+ *
+ * // The system message background info will be truncated first (higher flex),
+ * // and user context will be truncated from the middle if needed (preserve: 'both')
+ * ```
+ */
 export declare function truncateWrappedContent<T extends MessageLike>({ messages, tokenLimit, throwOnFailure, }: Options<T>): T[];
 export {};

package/package.json

@@ -2,8 +2,10 @@
   "name": "llmz",
   "type": "module",
   "description": "LLMz – An LLM-native Typescript VM built on top of Zui",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -32,7 +34,7 @@
     "@babel/standalone": "^7.26.4",
     "@babel/traverse": "^7.26.4",
     "@babel/types": "^7.26.3",
-    "@botpress/client": "1.20.0",
+    "@botpress/client": "1.21.0",
     "bytes": "^3.1.2",
     "exponential-backoff": "^3.1.1",
     "handlebars": "^4.7.8",