llmz 0.1.1 → 0.1.2

package/dist/{execute-7MDJHUHO.cjs → execute-22PSGL7P.cjs}

@@ -88,7 +88,7 @@ var getModelOutputLimit = (inputLength) => _chunkHC2QZTVTcjs.clamp_default.call(
   RESPONSE_LENGTH_BUFFER.MIN_TOKENS,
   RESPONSE_LENGTH_BUFFER.MAX_TOKENS
 );
-var generateCode = async ({ iteration, ctx, cognitive, controller }) => {
+var generateCode = async ({ iteration, ctx, cognitive, controller, metadata }) => {
   var _a, _b, _c;
   const startedAt = Date.now();
   const traces = iteration.traces;
@@ -118,7 +118,8 @@ var generateCode = async ({ iteration, ctx, cognitive, controller }) => {
     responseFormat: "text",
     reasoningEffort: iteration.reasoningEffort,
     messages: messages.filter((x) => x.role !== "system"),
-    stopSequences: ctx.version.getStopTokens()
+    stopSequences: ctx.version.getStopTokens(),
+    meta: metadata ? { metadata } : void 0
   }).catch((thrown) => {
     throw new (0, _chunkPK72FAKDcjs.CognitiveError)(`LLM generation failed: ${_chunkFPLSJF4Scjs.getErrorMessage.call(void 0, thrown)}`);
   });
@@ -597,7 +598,8 @@ var executeContextInternal = async (props) => {
           onBeforeExecution,
           onAfterTool,
           onBeforeTool,
-          onIterationEnd
+          onIterationEnd,
+          metadata: props.metadata
         });
         if (iterationResult.type === "return") {
           return iterationResult.result;
@@ -664,7 +666,8 @@ var executeIterationWithErrorHandling = async ({
   onBeforeExecution,
   onAfterTool,
   onBeforeTool,
-  onIterationEnd
+  onIterationEnd,
+  metadata
 }) => {
   try {
     await executeIteration({
@@ -675,7 +678,8 @@ var executeIterationWithErrorHandling = async ({
       onExit,
       onBeforeExecution,
       onAfterTool,
-      onBeforeTool
+      onBeforeTool,
+      metadata
     });
     await finalizeIteration({ iteration, controller, onIterationEnd });
     return { type: "proceed" };
@@ -766,9 +770,10 @@ var executeIteration = async ({
   onExit,
   onBeforeExecution,
   onBeforeTool,
-  onAfterTool
+  onAfterTool,
+  metadata
 }) => {
-  await generateCode({ iteration, ctx, cognitive, controller });
+  await generateCode({ iteration, ctx, cognitive, controller, metadata });
   if (typeof onBeforeExecution === "function") {
     try {
       const hookRes = await onBeforeExecution(iteration, controller);

package/dist/{execute-TPUSOWBP.js → execute-ZENBZBWL.js}

@@ -88,7 +88,7 @@ var getModelOutputLimit = (inputLength) => clamp_default(
   RESPONSE_LENGTH_BUFFER.MIN_TOKENS,
   RESPONSE_LENGTH_BUFFER.MAX_TOKENS
 );
-var generateCode = async ({ iteration, ctx, cognitive, controller }) => {
+var generateCode = async ({ iteration, ctx, cognitive, controller, metadata }) => {
   var _a, _b, _c;
   const startedAt = Date.now();
   const traces = iteration.traces;
@@ -118,7 +118,8 @@ var generateCode = async ({ iteration, ctx, cognitive, controller }) => {
     responseFormat: "text",
     reasoningEffort: iteration.reasoningEffort,
     messages: messages.filter((x) => x.role !== "system"),
-    stopSequences: ctx.version.getStopTokens()
+    stopSequences: ctx.version.getStopTokens(),
+    meta: metadata ? { metadata } : void 0
   }).catch((thrown) => {
     throw new CognitiveError(`LLM generation failed: ${getErrorMessage(thrown)}`);
   });
@@ -597,7 +598,8 @@ var executeContextInternal = async (props) => {
           onBeforeExecution,
           onAfterTool,
           onBeforeTool,
-          onIterationEnd
+          onIterationEnd,
+          metadata: props.metadata
         });
         if (iterationResult.type === "return") {
           return iterationResult.result;
@@ -664,7 +666,8 @@ var executeIterationWithErrorHandling = async ({
   onBeforeExecution,
   onAfterTool,
   onBeforeTool,
-  onIterationEnd
+  onIterationEnd,
+  metadata
 }) => {
   try {
     await executeIteration({
@@ -675,7 +678,8 @@ var executeIterationWithErrorHandling = async ({
       onExit,
       onBeforeExecution,
       onAfterTool,
-      onBeforeTool
+      onBeforeTool,
+      metadata
     });
     await finalizeIteration({ iteration, controller, onIterationEnd });
     return { type: "proceed" };
@@ -766,9 +770,10 @@ var executeIteration = async ({
   onExit,
   onBeforeExecution,
   onBeforeTool,
-  onAfterTool
+  onAfterTool,
+  metadata
 }) => {
-  await generateCode({ iteration, ctx, cognitive, controller });
+  await generateCode({ iteration, ctx, cognitive, controller, metadata });
   if (typeof onBeforeExecution === "function") {
     try {
       const hookRes = await onBeforeExecution(iteration, controller);

package/dist/index.cjs

@@ -54,7 +54,7 @@ var _chunkFPLSJF4Scjs = require('./chunk-FPLSJF4S.cjs');
 var _chunkHC2QZTVTcjs = require('./chunk-HC2QZTVT.cjs');
 
 // package.json
-var version = "0.1.1";
+var version = "0.1.2";
 
 // src/objects.ts
 var _zui = require('@bpinternal/zui');
@@ -1116,11 +1116,11 @@ var utils = {
   truncateWrappedContent: _chunkZPHRTTQXcjs.truncateWrappedContent
 };
 var execute = async (props) => {
-  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./execute-7MDJHUHO.cjs")));
+  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./execute-22PSGL7P.cjs")));
   return executeContext(props);
 };
 var init = async () => {
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./execute-7MDJHUHO.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./execute-22PSGL7P.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./component-NNHBHD72.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./tool-GJ6ZXWS2.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./exit-LUJY7JIG.cjs")));

package/dist/index.d.ts

@@ -44,6 +44,7 @@ export declare const utils: {
  * @param props.signal - Optional AbortSignal to cancel execution
  * @param props.model - Optional model name (or array or models to use as fallback) (static or dynamic function)
  * @param props.temperature - Optional temperature value (static or dynamic function)
+ * @param props.metadata - Optional metadata attached to cognitive usage records for each LLM call
  * @param props.options - Optional execution options (loop limit, timeout)
  * @param props.onTrace - Optional non-blocking hook for monitoring traces during execution
  * @param props.onIterationEnd - Optional blocking hook called after each iteration

package/dist/index.js

@@ -54,7 +54,7 @@ import {
 } from "./chunk-34GJUS6U.js";
 
 // package.json
-var version = "0.1.1";
+var version = "0.1.2";
 
 // src/objects.ts
 import { z } from "@bpinternal/zui";
@@ -1116,11 +1116,11 @@ var utils = {
   truncateWrappedContent
 };
 var execute = async (props) => {
-  const { executeContext } = await import("./execute-TPUSOWBP.js");
+  const { executeContext } = await import("./execute-ZENBZBWL.js");
   return executeContext(props);
 };
 var init = async () => {
-  await import("./execute-TPUSOWBP.js");
+  await import("./execute-ZENBZBWL.js");
   await import("./component-2Z3KLWLX.js");
   await import("./tool-DNHVW3KC.js");
   await import("./exit-VJATJTQI.js");

package/dist/runtime/generate.d.ts

@@ -5,6 +5,7 @@ type GenerateCodeProps = {
     ctx: Context;
     cognitive: RuntimeCognitive;
     controller: AbortController;
+    metadata?: Record<string, string>;
 };
-export declare const generateCode: ({ iteration, ctx, cognitive, controller }: GenerateCodeProps) => Promise<void>;
+export declare const generateCode: ({ iteration, ctx, cognitive, controller, metadata }: GenerateCodeProps) => Promise<void>;
 export {};

package/dist/runtime/types.d.ts

@@ -206,6 +206,10 @@ export type ExecutionProps = {
      * If not provided, the model will not use reasoning for models with optional reasoning.
      */
     reasoningEffort?: ValueOrGetter<'low' | 'medium' | 'high' | 'dynamic' | 'none', Context>;
+    /**
+     * Arbitrary key-value metadata to attach to cognitive usage records for each LLM call.
+     */
+    metadata?: Record<string, string>;
 } & ExecutionHooks;
 export type RuntimeCognitive = Pick<Cognitive, 'getModelDetails' | 'generateContent'>;
 export {};

package/package.json

@@ -2,7 +2,7 @@
   "name": "llmz",
   "type": "module",
   "description": "LLMz - An LLM-native Typescript VM built on top of Zui",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -72,7 +72,7 @@
   },
   "peerDependencies": {
     "@botpress/client": "1.47.0",
-    "@botpress/cognitive": "0.6.1",
+    "@botpress/cognitive": "0.6.2",
     "@bpinternal/thicktoken": "^2.0.0",
     "@bpinternal/zui": "^2.3.0"
   },