@dexto/core 1.2.4 → 1.2.5

package/dist/context/utils.cjs

@@ -40,7 +40,6 @@ __export(utils_exports, {
   toTextForToolMessage: () => toTextForToolMessage
 });
 module.exports = __toCommonJS(utils_exports);
-var import_logger = require("../logger/index.cjs");
 var import_registry = require("../llm/registry.cjs");
 var import_errors = require("./errors.js");
 var import_safe_stringify = require("../utils/safe-stringify.cjs");
@@ -278,7 +277,7 @@ function buildToolBlobName(kind, mimeType, options, preferredName) {
   const unique = generateUniqueSuffix();
   return `${parts.join("-")}-${unique}.${ext}`;
 }
-async function resolveBlobReferenceToParts(resourceUri, resourceManager, allowedMediaTypes) {
+async function resolveBlobReferenceToParts(resourceUri, resourceManager, logger, allowedMediaTypes) {
   try {
     const result = await resourceManager.read(resourceUri);
     if (allowedMediaTypes) {
@@ -339,13 +338,13 @@ async function resolveBlobReferenceToParts(resourceUri, resourceManager, allowed
     }
     return parts;
   } catch (error) {
-    import_logger.logger.warn(`Failed to resolve blob reference ${resourceUri}: ${String(error)}`);
+    logger.warn(`Failed to resolve blob reference ${resourceUri}: ${String(error)}`);
     return [{ type: "text", text: `[Attachment unavailable: ${resourceUri}]` }];
   }
 }
-function countMessagesTokens(history, tokenizer, overheadPerMessage = DEFAULT_OVERHEAD_PER_MESSAGE) {
+function countMessagesTokens(history, tokenizer, overheadPerMessage = DEFAULT_OVERHEAD_PER_MESSAGE, logger) {
   let total = 0;
-  import_logger.logger.debug(`Counting tokens for ${history.length} messages`);
+  logger.debug(`Counting tokens for ${history.length} messages`);
   try {
     for (const message of history) {
       if (message.content) {
@@ -398,14 +397,14 @@ function countMessagesTokens(history, tokenizer, overheadPerMessage = DEFAULT_OV
       total += overheadPerMessage;
     }
   } catch (error) {
-    import_logger.logger.error(
+    logger.error(
       `countMessagesTokens failed: ${error instanceof Error ? error.message : String(error)}`
     );
     throw import_errors.ContextError.tokenCountFailed(error instanceof Error ? error.message : String(error));
   }
   return total;
 }
-function getImageData(imagePart) {
+function getImageData(imagePart, logger) {
   const { image } = imagePart;
   if (typeof image === "string") {
     return image;
@@ -418,10 +417,10 @@ function getImageData(imagePart) {
   } else if (image instanceof URL) {
     return image.toString();
   }
-  import_logger.logger.warn(`Unexpected image data type in getImageData: ${typeof image}`);
+  logger.warn(`Unexpected image data type in getImageData: ${typeof image}`);
   return "";
 }
-function getFileData(filePart) {
+function getFileData(filePart, logger) {
   const { data } = filePart;
   if (typeof data === "string") {
     return data;
@@ -434,10 +433,10 @@ function getFileData(filePart) {
   } else if (data instanceof URL) {
     return data.toString();
   }
-  import_logger.logger.warn(`Unexpected file data type in getFileData: ${typeof data}`);
+  logger.warn(`Unexpected file data type in getFileData: ${typeof data}`);
   return "";
 }
-async function getImageDataWithBlobSupport(imagePart, resourceManager) {
+async function getImageDataWithBlobSupport(imagePart, resourceManager, logger) {
   const { image } = imagePart;
   if (typeof image === "string" && image.startsWith("@blob:")) {
     try {
@@ -447,14 +446,14 @@ async function getImageDataWithBlobSupport(imagePart, resourceManager) {
       if (result.contents[0]?.blob && typeof result.contents[0].blob === "string") {
         return result.contents[0].blob;
       }
-      import_logger.logger.warn(`Blob reference ${image} did not contain blob data`);
+      logger.warn(`Blob reference ${image} did not contain blob data`);
     } catch (error) {
-      import_logger.logger.warn(`Failed to resolve blob reference ${image}: ${String(error)}`);
+      logger.warn(`Failed to resolve blob reference ${image}: ${String(error)}`);
     }
   }
-  return getImageData(imagePart);
+  return getImageData(imagePart, logger);
 }
-async function getFileDataWithBlobSupport(filePart, resourceManager) {
+async function getFileDataWithBlobSupport(filePart, resourceManager, logger) {
   const { data } = filePart;
   if (typeof data === "string" && data.startsWith("@blob:")) {
     try {
@@ -464,14 +463,14 @@ async function getFileDataWithBlobSupport(filePart, resourceManager) {
       if (result.contents[0]?.blob && typeof result.contents[0].blob === "string") {
         return result.contents[0].blob;
       }
-      import_logger.logger.warn(`Blob reference ${data} did not contain blob data`);
+      logger.warn(`Blob reference ${data} did not contain blob data`);
     } catch (error) {
-      import_logger.logger.warn(`Failed to resolve blob reference ${data}: ${String(error)}`);
+      logger.warn(`Failed to resolve blob reference ${data}: ${String(error)}`);
     }
   }
-  return getFileData(filePart);
+  return getFileData(filePart, logger);
 }
-async function expandBlobReferences(content, resourceManager, allowedMediaTypes) {
+async function expandBlobReferences(content, resourceManager, logger, allowedMediaTypes) {
   if (typeof content === "string") {
     const blobRefPattern = /@blob:[a-f0-9]+/g;
     const matches = [...content.matchAll(blobRefPattern)];
@@ -497,6 +496,7 @@ async function expandBlobReferences(content, resourceManager, allowedMediaTypes)
         resolvedParts = await resolveBlobReferenceToParts(
           resourceUri,
           resourceManager,
+          logger,
           allowedMediaTypes
         );
         resolvedCache.set(resourceUri, resolvedParts);
@@ -529,6 +529,7 @@ async function expandBlobReferences(content, resourceManager, allowedMediaTypes)
         const resolved = await resolveBlobReferenceToParts(
           resourceUri,
           resourceManager,
+          logger,
           allowedMediaTypes
         );
         if (resolved.length > 0) {
@@ -544,6 +545,7 @@ async function expandBlobReferences(content, resourceManager, allowedMediaTypes)
         const resolved = await resolveBlobReferenceToParts(
           resourceUri,
           resourceManager,
+          logger,
           allowedMediaTypes
         );
         if (resolved.length > 0) {
@@ -552,11 +554,12 @@ async function expandBlobReferences(content, resourceManager, allowedMediaTypes)
           try {
             const resolvedData = await getFileDataWithBlobSupport(
               part,
-              resourceManager
+              resourceManager,
+              logger
             );
             expandedParts.push({ ...part, data: resolvedData });
           } catch (error) {
-            import_logger.logger.warn(`Failed to resolve file blob reference: ${String(error)}`);
+            logger.warn(`Failed to resolve file blob reference: ${String(error)}`);
             expandedParts.push(part);
           }
         }
@@ -566,6 +569,7 @@ async function expandBlobReferences(content, resourceManager, allowedMediaTypes)
         const expanded = await expandBlobReferences(
           part.text,
           resourceManager,
+          logger,
           allowedMediaTypes
         );
         if (typeof expanded === "string") {
@@ -583,7 +587,7 @@ async function expandBlobReferences(content, resourceManager, allowedMediaTypes)
   }
   return content;
 }
-function filterMessagesByLLMCapabilities(messages, config) {
+function filterMessagesByLLMCapabilities(messages, config, logger) {
   try {
     return messages.map((message) => {
       if (message.role !== "user" || !Array.isArray(message.content)) {
@@ -615,7 +619,7 @@ function filterMessagesByLLMCapabilities(messages, config) {
       };
     });
   } catch (error) {
-    import_logger.logger.warn(`Failed to filter messages by LLM capabilities: ${String(error)}`);
+    logger.warn(`Failed to filter messages by LLM capabilities: ${String(error)}`);
     return messages;
   }
 }
@@ -657,7 +661,7 @@ function matchesMimePattern(mimeType, pattern) {
 function matchesAnyMimePattern(mimeType, patterns) {
   return patterns.some((pattern) => matchesMimePattern(mimeType, pattern));
 }
-function fileTypesToMimePatterns(fileTypes) {
+function fileTypesToMimePatterns(fileTypes, logger) {
   const patterns = [];
   for (const fileType of fileTypes) {
     switch (fileType) {
@@ -674,7 +678,7 @@ function fileTypesToMimePatterns(fileTypes) {
         patterns.push("video/*");
         break;
       default:
-        import_logger.logger.warn(`Unknown file type in registry: ${fileType}`);
+        logger.warn(`Unknown file type in registry: ${fileType}`);
     }
   }
   return patterns;
@@ -696,30 +700,35 @@ function generateMediaPlaceholder(metadata) {
   const name = metadata.originalName || "unknown";
   return `[${typeLabel}: ${name} (${size})]`;
 }
-function sanitizeDeepObject(obj) {
+function sanitizeDeepObject(obj, logger) {
   if (obj == null) return obj;
   if (typeof obj === "string") {
     if (isLikelyBase64String(obj)) {
       const approxBytes = Math.floor(obj.length * 3 / 4);
-      import_logger.logger.debug(
+      logger.debug(
         `sanitizeDeepObject: replaced large base64 string (~${approxBytes} bytes) with placeholder`
       );
       return `[binary data omitted ~${approxBytes} bytes]`;
     }
     return obj;
   }
-  if (Array.isArray(obj)) return obj.map((x) => sanitizeDeepObject(x));
+  if (Array.isArray(obj)) return obj.map((x) => sanitizeDeepObject(x, logger));
   if (typeof obj === "object") {
     const out = {};
     for (const [k, v] of Object.entries(obj)) {
-      out[k] = sanitizeDeepObject(v);
+      out[k] = sanitizeDeepObject(v, logger);
     }
     return out;
   }
   return obj;
 }
-async function normalizeToolResult(result) {
-  const content = await sanitizeToolResultToContentWithBlobs(result);
+async function normalizeToolResult(result, logger) {
+  const content = await sanitizeToolResultToContentWithBlobs(
+    result,
+    logger,
+    void 0,
+    void 0
+  );
   const parts = coerceContentToParts(content);
   const inlineMedia = [];
   parts.forEach((part, index) => {
@@ -740,7 +749,7 @@ function shouldPersistInlineMedia(hint) {
   }
   return hint.approxBytes >= MIN_TOOL_INLINE_MEDIA_BYTES;
 }
-async function persistToolMedia(normalized, options) {
+async function persistToolMedia(normalized, options, logger) {
   const parts = normalized.parts.map((part) => clonePart(part));
   const blobStore = options.blobStore;
   const namingOptions = options.toolName || options.toolCallId ? {
@@ -772,7 +781,7 @@ async function persistToolMedia(normalized, options) {
           parts[hint.index] = createBlobFilePart(resourceUri, resolvedMimeType, filename);
         }
       } catch (error) {
-        import_logger.logger.warn(
+        logger.warn(
           `Failed to persist tool media: ${error instanceof Error ? error.message : String(error)}`
         );
       }
@@ -784,20 +793,20 @@ async function persistToolMedia(normalized, options) {
     ...resources ? { resources } : {}
   };
 }
-async function sanitizeToolResultToContentWithBlobs(result, blobStore, namingOptions) {
+async function sanitizeToolResultToContentWithBlobs(result, logger, blobStore, namingOptions) {
   try {
     if (typeof result === "string") {
       const dataUri = parseDataUri(result);
       if (dataUri) {
         const mediaType = dataUri.mediaType;
-        import_logger.logger.debug(
+        logger.debug(
           `sanitizeToolResultToContentWithBlobs: detected data URI (${mediaType})`
         );
         const approxSize = Math.floor(dataUri.base64.length * 3 / 4);
         const shouldStoreAsBlob = blobStore && approxSize > 1024;
         if (shouldStoreAsBlob) {
           try {
-            import_logger.logger.debug(
+            logger.debug(
               `Storing data URI as blob (${approxSize} bytes, ${mediaType})`
             );
             const blobRef = await blobStore.store(result, {
@@ -805,13 +814,13 @@ async function sanitizeToolResultToContentWithBlobs(result, blobStore, namingOpt
               source: "tool",
               originalName: buildToolBlobName("output", mediaType, namingOptions)
             });
-            import_logger.logger.debug(`Stored blob: ${blobRef.uri} (${approxSize} bytes)`);
+            logger.debug(`Stored blob: ${blobRef.uri} (${approxSize} bytes)`);
             if (mediaType.startsWith("image/")) {
               return [createBlobImagePart(blobRef.uri, mediaType)];
             }
             return [createBlobFilePart(blobRef.uri, mediaType, void 0)];
           } catch (error) {
-            import_logger.logger.warn(
+            logger.warn(
               `Failed to store blob, falling back to inline: ${String(error)}`
             );
           }
@@ -828,7 +837,7 @@ async function sanitizeToolResultToContentWithBlobs(result, blobStore, namingOpt
         ];
       }
       if (isLikelyBase64String(result)) {
-        import_logger.logger.debug("sanitizeToolResultToContentWithBlobs: detected base64-like string");
+        logger.debug("sanitizeToolResultToContentWithBlobs: detected base64-like string");
         const approxSize = Math.floor(result.length * 3 / 4);
         const shouldStoreAsBlob = blobStore && approxSize > 1024;
         if (shouldStoreAsBlob) {
@@ -838,7 +847,7 @@ async function sanitizeToolResultToContentWithBlobs(result, blobStore, namingOpt
               source: "tool",
               originalName: buildToolBlobName("output", void 0, namingOptions)
             });
-            import_logger.logger.debug(
+            logger.debug(
               `Stored tool result as blob: ${blobRef.uri} (${approxSize} bytes)`
             );
             return [
@@ -849,7 +858,7 @@ async function sanitizeToolResultToContentWithBlobs(result, blobStore, namingOpt
               )
             ];
           } catch (error) {
-            import_logger.logger.warn(
+            logger.warn(
               `Failed to store blob, falling back to inline: ${String(error)}`
             );
           }
@@ -866,7 +875,7 @@ async function sanitizeToolResultToContentWithBlobs(result, blobStore, namingOpt
       if (result.length > MAX_TOOL_TEXT_CHARS) {
         const head = result.slice(0, 4e3);
         const tail = result.slice(-1e3);
-        import_logger.logger.debug(
+        logger.debug(
           `sanitizeToolResultToContentWithBlobs: truncating long text tool output (len=${result.length})`
         );
         return `${head}
@@ -881,6 +890,7 @@ ${tail}`;
         if (item == null) continue;
         const processedItem = await sanitizeToolResultToContentWithBlobs(
           item,
+          logger,
           blobStore,
           namingOptions
         );
@@ -895,7 +905,7 @@ ${tail}`;
     if (result && typeof result === "object") {
       const anyObj = result;
       if ("content" in anyObj && Array.isArray(anyObj.content)) {
-        import_logger.logger.debug(
+        logger.debug(
           `Processing MCP tool result with ${anyObj.content.length} content items`
         );
         const processedContent = [];
@@ -910,7 +920,7 @@ ${tail}`;
                 const shouldStoreAsBlob = blobStore && approxSize > 1024;
                 if (shouldStoreAsBlob) {
                   try {
-                    import_logger.logger.debug(
+                    logger.debug(
                       `Storing MCP resource as blob (${approxSize} bytes, ${mimeType})`
                     );
                     const blobRef = await blobStore.store(fileData, {
@@ -923,7 +933,7 @@ ${tail}`;
                         resource.title
                       )
                     });
-                    import_logger.logger.debug(
+                    logger.debug(
                       `Stored MCP resource blob: ${blobRef.uri} (${approxSize} bytes)`
                     );
                     if (mimeType.startsWith("image/")) {
@@ -941,7 +951,7 @@ ${tail}`;
                     }
                     continue;
                   } catch (error) {
-                    import_logger.logger.warn(
+                    logger.warn(
                       `Failed to store MCP resource blob, falling back to inline: ${String(error)}`
                     );
                   }
@@ -971,13 +981,13 @@ ${tail}`;
               }
             }
             if ("data" in item && item.mimeType) {
-              const fileData = getFileData({ data: item.data });
+              const fileData = getFileData({ data: item.data }, logger);
               const mimeType = item.mimeType;
               const approxSize = typeof fileData === "string" ? Math.floor(fileData.length * 3 / 4) : 0;
               const shouldStoreAsBlob = blobStore && approxSize > 1024;
               if (shouldStoreAsBlob) {
                 try {
-                  import_logger.logger.debug(
+                  logger.debug(
                     `Storing MCP content item as blob (${approxSize} bytes, ${mimeType})`
                   );
                   const blobRef = await blobStore.store(fileData, {
@@ -990,7 +1000,7 @@ ${tail}`;
                       item.filename
                     )
                   });
-                  import_logger.logger.debug(
+                  logger.debug(
                     `Stored MCP blob: ${blobRef.uri} (${approxSize} bytes)`
                   );
                   if (item.type === "image") {
@@ -1004,7 +1014,7 @@ ${tail}`;
                   }
                   continue;
                 } catch (error) {
-                  import_logger.logger.warn(
+                  logger.warn(
                     `Failed to store MCP blob, falling back to inline: ${String(error)}`
                   );
                 }
@@ -1031,7 +1041,7 @@ ${tail}`;
         return processedContent;
       }
       if ("image" in anyObj) {
-        const imageData = getImageData({ image: anyObj.image });
+        const imageData = getImageData({ image: anyObj.image }, logger);
         const mimeType = anyObj.mimeType || "image/jpeg";
         const approxSize = typeof imageData === "string" ? Math.floor(imageData.length * 3 / 4) : 0;
         const shouldStoreAsBlob = blobStore && approxSize > 1024;
@@ -1042,12 +1052,12 @@ ${tail}`;
               source: "tool",
               originalName: buildToolBlobName("image", mimeType, namingOptions)
             });
-            import_logger.logger.debug(
+            logger.debug(
               `Stored tool image as blob: ${blobRef.uri} (${approxSize} bytes)`
             );
             return [createBlobImagePart(blobRef.uri, mimeType)];
           } catch (error) {
-            import_logger.logger.warn(
+            logger.warn(
               `Failed to store image blob, falling back to inline: ${String(error)}`
             );
           }
@@ -1061,7 +1071,7 @@ ${tail}`;
         ];
       }
       if ("data" in anyObj && anyObj.mimeType) {
-        const fileData = getFileData({ data: anyObj.data });
+        const fileData = getFileData({ data: anyObj.data }, logger);
         const mimeType = anyObj.mimeType;
         const approxSize = typeof fileData === "string" ? Math.floor(fileData.length * 3 / 4) : 0;
         const shouldStoreAsBlob = blobStore && approxSize > 1024;
@@ -1077,12 +1087,12 @@ ${tail}`;
                 anyObj.filename
               )
             });
-            import_logger.logger.debug(
+            logger.debug(
               `Stored tool file as blob: ${blobRef.uri} (${approxSize} bytes)`
             );
             return [createBlobFilePart(blobRef.uri, mimeType, anyObj.filename)];
           } catch (error) {
-            import_logger.logger.warn(
+            logger.warn(
               `Failed to store file blob, falling back to inline: ${String(error)}`
             );
           }
@@ -1096,12 +1106,12 @@ ${tail}`;
           }
         ];
       }
-      const cleaned = sanitizeDeepObject(anyObj);
+      const cleaned = sanitizeDeepObject(anyObj, logger);
       return (0, import_safe_stringify.safeStringify)(cleaned);
     }
     return (0, import_safe_stringify.safeStringify)(result ?? "");
   } catch (err) {
-    import_logger.logger.warn(
+    logger.warn(
       `sanitizeToolResultToContentWithBlobs failed, falling back to string: ${String(err)}`
     );
     try {
@@ -1150,13 +1160,17 @@ function extractResourceDescriptors(parts) {
   }
   return resources.length > 0 ? resources : void 0;
 }
-async function sanitizeToolResult(result, options) {
-  const normalized = await normalizeToolResult(result);
-  const persisted = await persistToolMedia(normalized, {
-    ...options.blobStore ? { blobStore: options.blobStore } : {},
-    toolName: options.toolName,
-    toolCallId: options.toolCallId
-  });
+async function sanitizeToolResult(result, options, logger) {
+  const normalized = await normalizeToolResult(result, logger);
+  const persisted = await persistToolMedia(
+    normalized,
+    {
+      ...options.blobStore ? { blobStore: options.blobStore } : {},
+      toolName: options.toolName,
+      toolCallId: options.toolCallId
+    },
+    logger
+  );
   const fallbackContent = [{ type: "text", text: "" }];
   const content = persisted.parts.length > 0 ? persisted.parts : fallbackContent;
   return {

package/dist/context/utils.d.ts

@@ -1,5 +1,6 @@
 import { InternalMessage, TextPart, ImagePart, FilePart, SanitizedToolResult } from './types.js';
 import { ITokenizer } from '../llm/tokenizer/types.js';
+import type { IDextoLogger } from '../logger/v2/types.js';
 import { LLMContext } from '../llm/types.js';
 import { getFileMediaKind, getResourceKind } from './media-helpers.js';
 type ToolBlobNamingOptions = {
@@ -44,7 +45,7 @@ interface PersistToolMediaResult {
  * @returns The total token count.
  * @throws Error if token counting fails within the tokenizer.
  */
-export declare function countMessagesTokens(history: InternalMessage[], tokenizer: ITokenizer, overheadPerMessage?: number): number;
+export declare function countMessagesTokens(history: InternalMessage[], tokenizer: ITokenizer, overheadPerMessage: number | undefined, logger: IDextoLogger): number;
 /**
  * Extracts image data (base64 or URL) from an ImagePart or raw buffer.
  * @param imagePart The image part containing image data
@@ -52,25 +53,27 @@ export declare function countMessagesTokens(history: InternalMessage[], tokenize
  */
 export declare function getImageData(imagePart: {
     image: string | Uint8Array | Buffer | ArrayBuffer | URL;
-}): string;
+}, logger: IDextoLogger): string;
 /**
  * Extracts file data (base64 or URL) from a FilePart or raw buffer.
  * @param filePart The file part containing file data
+ * @param logger Optional logger instance
  * @returns Base64-encoded string or URL string
  */
 export declare function getFileData(filePart: {
     data: string | Uint8Array | Buffer | ArrayBuffer | URL;
-}): string;
+}, logger: IDextoLogger): string;
 /**
  * Extracts image data with blob resolution support.
  * If the image is a blob reference, resolves it from the resource manager.
  * @param imagePart The image part containing image data or blob reference
  * @param resourceManager Resource manager for resolving blob references
+ * @param logger Optional logger instance
  * @returns Promise<Base64-encoded string or URL string>
  */
 export declare function getImageDataWithBlobSupport(imagePart: {
     image: string | Uint8Array | Buffer | ArrayBuffer | URL;
-}, resourceManager: import('../resources/index.js').ResourceManager): Promise<string>;
+}, resourceManager: import('../resources/index.js').ResourceManager, logger: IDextoLogger): Promise<string>;
 /**
  * Extracts file data with blob resolution support.
  * If the data is a blob reference, resolves it from the resource manager.
@@ -80,7 +83,7 @@ export declare function getImageDataWithBlobSupport(imagePart: {
  */
 export declare function getFileDataWithBlobSupport(filePart: {
     data: string | Uint8Array | Buffer | ArrayBuffer | URL;
-}, resourceManager: import('../resources/index.js').ResourceManager): Promise<string>;
+}, resourceManager: import('../resources/index.js').ResourceManager, logger: IDextoLogger): Promise<string>;
 /**
  * Resolves blob references in message content to actual data.
  * Expands @blob:id references to their actual base64 content for LLM consumption.
@@ -93,7 +96,7 @@ export declare function getFileDataWithBlobSupport(filePart: {
  *                          If omitted, all blobs are expanded (legacy behavior).
  * @returns Promise<Resolved content with blob references expanded or replaced with placeholders>
  */
-export declare function expandBlobReferences(content: InternalMessage['content'], resourceManager: import('../resources/index.js').ResourceManager, allowedMediaTypes?: string[]): Promise<InternalMessage['content']>;
+export declare function expandBlobReferences(content: InternalMessage['content'], resourceManager: import('../resources/index.js').ResourceManager, logger: IDextoLogger, allowedMediaTypes?: string[]): Promise<InternalMessage['content']>;
 /**
  * Filters message content based on LLM capabilities.
  * Removes unsupported file attachments while preserving supported content.
@@ -102,7 +105,7 @@ export declare function expandBlobReferences(content: InternalMessage['content']
  * @param config The LLM configuration (provider and optional model)
  * @returns Filtered messages with unsupported content removed
  */
-export declare function filterMessagesByLLMCapabilities(messages: InternalMessage[], config: LLMContext): InternalMessage[];
+export declare function filterMessagesByLLMCapabilities(messages: InternalMessage[], config: LLMContext, logger: IDextoLogger): InternalMessage[];
 /**
  * Detect if a string is likely a Base64 blob (not a typical sentence/text).
  * Uses a length threshold and character set heuristic.
@@ -143,9 +146,9 @@ export declare function matchesAnyMimePattern(mimeType: string | undefined, patt
  * @param fileTypes Array of supported file types from LLM registry (e.g., ['image', 'pdf', 'audio'])
  * @returns Array of MIME type patterns (e.g., ['image/*', 'application/pdf', 'audio/*'])
  */
-export declare function fileTypesToMimePatterns(fileTypes: string[]): string[];
-export declare function normalizeToolResult(result: unknown): Promise<NormalizedToolResult>;
-export declare function persistToolMedia(normalized: NormalizedToolResult, options: PersistToolMediaOptions): Promise<PersistToolMediaResult>;
+export declare function fileTypesToMimePatterns(fileTypes: string[], logger: IDextoLogger): string[];
+export declare function normalizeToolResult(result: unknown, logger: IDextoLogger): Promise<NormalizedToolResult>;
+export declare function persistToolMedia(normalized: NormalizedToolResult, options: PersistToolMediaOptions, logger: IDextoLogger): Promise<PersistToolMediaResult>;
 /**
  * Convert an arbitrary tool result into safe InternalMessage content with optional blob storage.
  * - Automatically stores large media in blob store and returns resource references
@@ -153,13 +156,13 @@ export declare function persistToolMedia(normalized: NormalizedToolResult, optio
  * - Removes huge binary blobs inside objects
  * - Truncates extremely long raw text
  */
-export declare function sanitizeToolResultToContentWithBlobs(result: unknown, blobStore?: import('../storage/blob/types.js').BlobStore, namingOptions?: ToolBlobNamingOptions): Promise<InternalMessage['content']>;
+export declare function sanitizeToolResultToContentWithBlobs(result: unknown, logger: IDextoLogger, blobStore?: import('../storage/blob/types.js').BlobStore, namingOptions?: ToolBlobNamingOptions): Promise<InternalMessage['content']>;
 export declare function sanitizeToolResult(result: unknown, options: {
     blobStore?: import('../storage/blob/types.js').BlobStore;
     toolName: string;
     toolCallId: string;
     success?: boolean;
-}): Promise<SanitizedToolResult>;
+}, logger: IDextoLogger): Promise<SanitizedToolResult>;
 /**
  * Produce a short textual summary for tool content, to be used with providers
  * that only accept text for tool messages (e.g., OpenAI/Anthropic tool role).

package/dist/context/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/context/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/context/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAOvE,KAAK,qBAAqB,GAAG;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAIF,KAAK,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAExC,KAAK,eAAe,GAAG;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IAC9C,WAAW,EAAE,eAAe,EAAE,CAAC;CAClC;AAED,UAAU,uBAAuB;IAC7B,SAAS,CAAC,EAAE,OAAO,0BAA0B,EAAE,SAAS,CAAC;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,sBAAsB;IAC5B,KAAK,EAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;CAChD;AA4WD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,eAAe,EAAE,EAC1B,SAAS,EAAE,UAAU,EACrB,kBAAkB,EAAE,MAAM,YAA+B,EACzD,MAAM,EAAE,YAAY,GACrB,MAAM,CAuFR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CACxB,SAAS,EAAE;IACP,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,GAAG,CAAC;CAC3D,EACD,MAAM,EAAE,YAAY,GACrB,MAAM,CAeR;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACvB,QAAQ,EAAE;IACN,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,GAAG,CAAC;CAC1D,EACD,MAAM,EAAE,YAAY,GACrB,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC7C,SAAS,EAAE;IACP,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,GAAG,CAAC;CAC3D,EACD,eAAe,EAAE,OAAO,uBAAuB,EAAE,eAAe,EAChE,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC5C,QAAQ,EAAE;IACN,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,GAAG,CAAC;CAC1D,EACD,eAAe,EAAE,OAAO,uBAAuB,EAAE,eAAe,EAChE,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACtC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EACnC,eAAe,EAAE,OAAO,uBAAuB,EAAE,eAAe,EAChE,MAAM,EAAE,YAAY,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAC7B,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAiJrC;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC3C,QAAQ,EAAE,eAAe,EAAE,EAC3B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,GACrB,eAAe,EAAE,CA6CnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAoC,GAChD,OAAO,CAUT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxF;AAGD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBzF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAE/F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAsB3F;AAgED,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAqB/B;AAUD,wBAAsB,gBAAgB,CAClC,UAAU,EAAE,oBAAoB,EAChC,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,sBAAsB,CAAC,CAuDjC;AAED;;;;;;GAMG;AACH,wBAAsB,oCAAoC,CACtD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,EACpB,SAAS,CAAC,EAAE,OAAO,0BAA0B,EAAE,SAAS,EACxD,aAAa,CAAC,EAAE,qBAAqB,GACtC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAwYrC;AA2DD,wBAAsB,kBAAkB,CACpC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE;IACL,SAAS,CAAC,EAAE,OAAO,0BAA0B,EAAE,SAAS,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAwB9B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG,MAAM,CA2BvF;AAsCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG,MAAM,CAQhF"}