@wabot-dev/framework 0.9.24 → 0.9.26

package/dist/src/addon/chat-bot/anthropic/AnthropicChatAdapter.js

@@ -7,7 +7,6 @@ import '../../../feature/chat-bot/ChatBot.js';
 import '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
 import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { isRetryableError } from '../../../feature/chat-bot/isRetryableError.js';
 import { chatAdapter } from '../../../feature/chat-bot/metadata/@chatAdapter.js';
@@ -15,7 +14,6 @@ import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
 import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import { safeJsonParse } from '../../../feature/chat-bot/safeJsonParse.js';
-import { unconsumedMediaStartIndex } from '../../../feature/chat-bot/unconsumedMediaStartIndex.js';
 import { Anthropic } from '@anthropic-ai/sdk';
 
 const ANTHROPIC_SUPPORTED_IMAGE_MIME_TYPES = [
@@ -62,11 +60,10 @@ let AnthropicChatAdapter = class AnthropicChatAdapter {
     }
     mapChatItems(chatItems) {
         const messages = [];
-        const mediaStart = unconsumedMediaStartIndex(chatItems);
-        chatItems.forEach((chatItem, index) => {
+        chatItems.forEach((chatItem) => {
             switch (chatItem.type) {
                 case 'humanMessage':
-                    messages.push(this.mapHumanMessage(chatItem.humanMessage, index >= mediaStart));
+                    messages.push(this.mapHumanMessage(chatItem.humanMessage));
                     break;
                 case 'botMessage':
                     messages.push(this.mapBotMessage(chatItem.botMessage));
@@ -78,7 +75,7 @@ let AnthropicChatAdapter = class AnthropicChatAdapter {
         });
         return messages;
     }
-    mapHumanMessage(item, includeMedia) {
+    mapHumanMessage(item) {
         if (isChatMessageEmpty(item)) {
             throw new Error('User message content is empty');
         }
@@ -90,14 +87,14 @@ let AnthropicChatAdapter = class AnthropicChatAdapter {
                 supportedDocumentMimeTypes: ANTHROPIC_SUPPORTED_DOCUMENT_MIME_TYPES,
             }),
         });
-        if (includeMedia && item.images) {
+        if (item.images) {
             for (const image of item.images) {
                 if (!ANTHROPIC_SUPPORTED_IMAGE_MIME_TYPES.includes(image.mimeType))
                     continue;
                 blocks.push({ type: 'image', source: this.toAnthropicImageSource(image) });
             }
         }
-        if (includeMedia && item.documents) {
+        if (item.documents) {
             for (const doc of item.documents) {
                 if (!ANTHROPIC_SUPPORTED_DOCUMENT_MIME_TYPES.includes(doc.mimeType))
                     continue;

package/dist/src/addon/chat-bot/deepseek/DeepSeekChatAdapter.js

@@ -6,7 +6,6 @@ import '../../../feature/chat-bot/ChatBot.js';
 import '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
 import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { isRetryableError } from '../../../feature/chat-bot/isRetryableError.js';
 import { chatAdapter } from '../../../feature/chat-bot/metadata/@chatAdapter.js';

package/dist/src/addon/chat-bot/google/GoogleChatAdapter.js

@@ -8,7 +8,6 @@ import '../../../feature/chat-bot/ChatBot.js';
 import '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
 import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { isRetryableError } from '../../../feature/chat-bot/isRetryableError.js';
 import { chatAdapter } from '../../../feature/chat-bot/metadata/@chatAdapter.js';
@@ -16,7 +15,6 @@ import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
 import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import { safeJsonParse } from '../../../feature/chat-bot/safeJsonParse.js';
-import { unconsumedMediaStartIndex } from '../../../feature/chat-bot/unconsumedMediaStartIndex.js';
 import { GoogleGenAI } from '@google/genai';
 
 const GOOGLE_SUPPORTED_IMAGE_MIME_TYPES = [
@@ -84,11 +82,10 @@ let GoogleChatAdapter = class GoogleChatAdapter {
     }
     async mapChatItems(chatItems) {
         const contents = [];
-        const mediaStart = unconsumedMediaStartIndex(chatItems);
-        for (const [index, chatItem] of chatItems.entries()) {
+        for (const chatItem of chatItems) {
             switch (chatItem.type) {
                 case 'humanMessage':
-                    contents.push(await this.mapHumanMessage(chatItem.humanMessage, index >= mediaStart));
+                    contents.push(await this.mapHumanMessage(chatItem.humanMessage));
                     break;
                 case 'botMessage':
                     contents.push(this.mapBotMessage(chatItem.botMessage));
@@ -100,7 +97,7 @@ let GoogleChatAdapter = class GoogleChatAdapter {
         }
         return contents;
     }
-    async mapHumanMessage(item, includeMedia) {
+    async mapHumanMessage(item) {
         if (isChatMessageEmpty(item)) {
             throw new Error('User message content is empty');
         }
@@ -112,14 +109,14 @@ let GoogleChatAdapter = class GoogleChatAdapter {
             }),
         });
         const filesToSend = [];
-        if (includeMedia && item.images) {
+        if (item.images) {
             for (const image of item.images) {
                 if (!GOOGLE_SUPPORTED_IMAGE_MIME_TYPES.includes(image.mimeType))
                     continue;
                 filesToSend.push(image);
             }
         }
-        if (includeMedia && item.documents) {
+        if (item.documents) {
             for (const doc of item.documents) {
                 if (!GOOGLE_SUPPORTED_DOCUMENT_MIME_TYPES.includes(doc.mimeType))
                     continue;

package/dist/src/addon/chat-bot/in-memory/InMemoryChatMemory.js

@@ -6,7 +6,6 @@ import '../../../feature/chat-bot/ChatBot.js';
 import { ChatItem } from '../../../feature/chat-bot/ChatItem.js';
 import '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import '../../../core/injection/index.js';
 import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import 'uuid';

package/dist/src/addon/chat-bot/in-memory/InMemoryChatRepository.js

@@ -10,7 +10,6 @@ import '../../../feature/chat-bot/ChatAdapterRegistry.js';
 import '../../../feature/chat-bot/ChatBot.js';
 import { ChatOperator } from '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';

package/dist/src/addon/chat-bot/openia/OpenaiChatAdapter.js

@@ -4,7 +4,6 @@ import '../../../feature/chat-bot/ChatBot.js';
 import '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
 import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { isRetryableError } from '../../../feature/chat-bot/isRetryableError.js';
 import { chatAdapter } from '../../../feature/chat-bot/metadata/@chatAdapter.js';
@@ -13,7 +12,6 @@ import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
 import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';
-import { unconsumedMediaStartIndex } from '../../../feature/chat-bot/unconsumedMediaStartIndex.js';
 import { Logger } from '../../../core/logger/Logger.js';
 import { OpenAI } from 'openai';
 
@@ -53,11 +51,10 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
     }
     mapChatItems(chatItems) {
         const openIaInput = [];
-        const mediaStart = unconsumedMediaStartIndex(chatItems);
-        chatItems.forEach((chatItem, index) => {
+        chatItems.forEach((chatItem) => {
             switch (chatItem.type) {
                 case 'humanMessage':
-                    openIaInput.push(this.mapConectionMessage(chatItem.humanMessage, index >= mediaStart));
+                    openIaInput.push(this.mapConectionMessage(chatItem.humanMessage));
                     break;
                 case 'botMessage':
                     openIaInput.push(this.mapBotMessage(chatItem.botMessage));
@@ -69,7 +66,7 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
         });
         return openIaInput;
     }
-    mapConectionMessage(item, includeMedia) {
+    mapConectionMessage(item) {
         if (isChatMessageEmpty(item)) {
             throw new Error('User message content is empty');
         }
@@ -81,7 +78,7 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
                 supportedDocumentMimeTypes: OPENAI_SUPPORTED_DOCUMENT_MIME_TYPES,
             }),
         });
-        if (includeMedia && item.images) {
+        if (item.images) {
             for (const image of item.images) {
                 if (!OPENAI_SUPPORTED_IMAGE_MIME_TYPES.includes(image.mimeType))
                     continue;
@@ -92,7 +89,7 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
                 });
             }
         }
-        if (includeMedia && item.documents) {
+        if (item.documents) {
             for (const doc of item.documents) {
                 if (!OPENAI_SUPPORTED_DOCUMENT_MIME_TYPES.includes(doc.mimeType))
                     continue;
@@ -122,7 +119,7 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
                 type: 'function_call',
                 call_id: item.id,
                 name: item.name,
-                arguments: JSON.stringify(item.arguments),
+                arguments: item.arguments || '{}',
             },
             {
                 type: 'function_call_output',

package/dist/src/addon/chat-bot/openrouter/OpenRouterChatAdapter.js

@@ -7,7 +7,6 @@ import '../../../feature/chat-bot/ChatBot.js';
 import '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
 import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { isRetryableError } from '../../../feature/chat-bot/isRetryableError.js';
 import { chatAdapter } from '../../../feature/chat-bot/metadata/@chatAdapter.js';
@@ -15,7 +14,6 @@ import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
 import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';
-import { unconsumedMediaStartIndex } from '../../../feature/chat-bot/unconsumedMediaStartIndex.js';
 import { OpenRouter } from '@openrouter/sdk';
 
 const OPENROUTER_SUPPORTED_IMAGE_MIME_TYPES = [
@@ -68,11 +66,10 @@ let OpenRouterChatAdapter = class OpenRouterChatAdapter {
     }
     mapChatItems(chatItems) {
         const messages = [];
-        const mediaStart = unconsumedMediaStartIndex(chatItems);
-        chatItems.forEach((chatItem, index) => {
+        chatItems.forEach((chatItem) => {
             switch (chatItem.type) {
                 case 'humanMessage':
-                    messages.push(this.mapHumanMessage(chatItem.humanMessage, index >= mediaStart));
+                    messages.push(this.mapHumanMessage(chatItem.humanMessage));
                     break;
                 case 'botMessage':
                     messages.push(this.mapBotMessage(chatItem.botMessage));
@@ -84,34 +81,38 @@ let OpenRouterChatAdapter = class OpenRouterChatAdapter {
         });
         return messages;
     }
-    mapHumanMessage(item, includeMedia) {
+    mapHumanMessage(item) {
         if (isChatMessageEmpty(item)) {
             throw new Error('User message content is empty');
         }
         const contentParts = [];
-        contentParts.push(extractChatMessageText(item, {
-            supportedImageMimeTypes: OPENROUTER_SUPPORTED_IMAGE_MIME_TYPES,
-            supportedDocumentMimeTypes: OPENROUTER_SUPPORTED_DOCUMENT_MIME_TYPES,
-        }));
-        if (includeMedia && item.images) {
+        contentParts.push({
+            type: 'text',
+            text: extractChatMessageText(item, {
+                supportedImageMimeTypes: OPENROUTER_SUPPORTED_IMAGE_MIME_TYPES,
+                supportedDocumentMimeTypes: OPENROUTER_SUPPORTED_DOCUMENT_MIME_TYPES,
+            }),
+        });
+        if (item.images) {
             for (const image of item.images) {
                 if (!OPENROUTER_SUPPORTED_IMAGE_MIME_TYPES.includes(image.mimeType))
                     continue;
                 const imageUrl = image.publicUrl ?? image.base64Url;
                 if (imageUrl)
-                    contentParts.push(imageUrl);
+                    contentParts.push({ type: 'image_url', imageUrl: { url: imageUrl } });
             }
         }
-        if (includeMedia && item.documents) {
+        if (item.documents) {
             for (const doc of item.documents) {
                 if (!OPENROUTER_SUPPORTED_DOCUMENT_MIME_TYPES.includes(doc.mimeType))
                     continue;
                 const docUrl = doc.publicUrl ?? doc.base64Url;
-                if (docUrl)
-                    contentParts.push(docUrl);
+                if (docUrl) {
+                    contentParts.push({ type: 'file', file: { fileData: docUrl, filename: doc.name } });
+                }
             }
         }
-        return { role: 'user', content: contentParts.join('\n') };
+        return { role: 'user', content: contentParts };
     }
     mapBotMessage(item) {
         if (!item.text) {

package/dist/src/addon/chat-bot/pg/PgChatMemory.js

@@ -13,7 +13,6 @@ import '../../../feature/chat-bot/ChatBot.js';
 import { ChatItem } from '../../../feature/chat-bot/ChatItem.js';
 import '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';

package/dist/src/addon/chat-bot/pg/PgChatRepository.js

@@ -16,7 +16,6 @@ import '../../../feature/chat-bot/ChatAdapterRegistry.js';
 import '../../../feature/chat-bot/ChatBot.js';
 import { ChatOperator } from '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';

package/dist/src/addon/chat-bot/wabot/WabotChatAdapter.js

@@ -8,7 +8,6 @@ import '../../../feature/chat-bot/ChatAdapterRegistry.js';
 import '../../../feature/chat-bot/ChatBot.js';
 import '../../../feature/chat-bot/ChatOperator.js';
 import '../../../feature/chat-bot/UnionChatAdapter.js';
-import '../../../feature/chat-bot/ImageDescriber.js';
 import { chatAdapter } from '../../../feature/chat-bot/metadata/@chatAdapter.js';
 import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';

package/dist/src/addon/chat-controller/cmd/CmdChannelServer.js

@@ -39,7 +39,8 @@ let CmdChannelServer = class CmdChannelServer {
         this.server = net.createServer((socket) => this.handleConnection(socket));
         this.server.on('error', (err) => logger.error('cmd channel server error', err));
         this.server.listen(socketPath, () => {
-            logger.info(`cmd channel server listening at ${socketPath}`);
+            const displayPath = path.relative(process.cwd(), socketPath) || socketPath;
+            logger.info(`cmd channel server listening at ${displayPath}`);
         });
         process.once('exit', () => this.shutdown());
         process.once('SIGINT', () => {

package/dist/src/feature/chat-bot/ChatBot.js

@@ -5,8 +5,7 @@ import { MindsetOperator } from '../mindset/MindsetOperator.js';
 import { ChatAdapter } from './ChatAdapter.js';
 import { ChatItem } from './ChatItem.js';
 import { ChatMemory } from './ChatMemory.js';
-import { ImageDescriber } from './ImageDescriber.js';
-import { pendingMediaStartIndex } from './pendingMediaStartIndex.js';
+import { stripAnsweredMedia } from './stripAnsweredMedia.js';
 import { Logger } from '../../core/logger/Logger.js';
 
 const MAX_CONSECUTIVE_INVALID_ARGS = 2;
@@ -20,16 +19,13 @@ let ChatBot = class ChatBot {
     memory;
     adapter;
     mindset;
-    imageDescriber;
     logger = new Logger('wabot:chat-bot');
-    constructor(memory, adapter, mindset, imageDescriber) {
+    constructor(memory, adapter, mindset) {
         this.memory = memory;
         this.adapter = adapter;
         this.mindset = mindset;
-        this.imageDescriber = imageDescriber;
     }
     async sendMessage(message, callback) {
-        await this.describeImages(message);
         const newChatItem = new ChatItem({
             type: 'humanMessage',
             humanMessage: message,
@@ -37,20 +33,6 @@ let ChatBot = class ChatBot {
         await this.memory.create(newChatItem);
         await this.processLoop(callback, 0);
     }
-    // Caption incoming images once, before persisting, so later turns can recall
-    // them from the stored description instead of re-sending the binary. The
-    // mindset's context/skills/limits focus the description on what matters here.
-    async describeImages(message) {
-        if (!message.images?.some((image) => !image.description))
-            return;
-        const [models, context, skills, limits] = await Promise.all([
-            this.mindset.resolveModels('visionLlm'),
-            this.mindset.context(),
-            this.mindset.skills(),
-            this.mindset.limits(),
-        ]);
-        await this.imageDescriber.describeMessageImages(message, models, { context, skills, limits });
-    }
     async processLoop(callback, invalidArgsCount) {
         const prevItems = await this.memory.findLastItems(16);
         if (prevItems.length === 0) {
@@ -64,12 +46,12 @@ let ChatBot = class ChatBot {
         const tools = this.mindset.tools();
         const identity = await this.mindset.identity();
         const prevItemsData = prevItems.map((x) => x.getData());
-        // Only media from the pending exchange is actually sent to the model; images
-        // in already-answered messages are not, so they must not force a vision model.
-        const mediaStart = pendingMediaStartIndex(prevItemsData);
-        const needsVision = prevItemsData.some((data, index) => index >= mediaStart &&
-            data.type === 'humanMessage' &&
-            (data.humanMessage.images?.length ?? 0) > 0);
+        // The bot — not the provider adapters — decides which media reaches the
+        // model: keep binaries only for the pending exchange and drop already-
+        // answered ones. The leftover media also determines whether this call needs
+        // a vision model.
+        const sentItems = stripAnsweredMedia(prevItemsData);
+        const needsVision = sentItems.some((data) => data.type === 'humanMessage' && (data.humanMessage.images?.length ?? 0) > 0);
         const kind = needsVision ? 'visionLlm' : 'llm';
         const candidates = await this.mindset.resolveModels(kind);
         if (candidates.length === 0) {
@@ -79,7 +61,7 @@ let ChatBot = class ChatBot {
             models: candidates,
             systemPrompt,
             tools,
-            prevItems: prevItemsData,
+            prevItems: sentItems,
         });
         for (const newItemData of newItemsData) {
             if (newItemData.type === 'functionCall') {
@@ -114,8 +96,7 @@ ChatBot = __decorate([
     injectable(),
     __metadata("design:paramtypes", [ChatMemory,
         ChatAdapter,
-        MindsetOperator,
-        ImageDescriber])
+        MindsetOperator])
 ], ChatBot);
 
 export { ChatBot };

package/dist/src/feature/chat-bot/extractChatMessageText.js

@@ -9,7 +9,6 @@ function extractChatMessageText(message, options = {}) {
             id: x.id,
             name: x.name,
             mimeType: x.mimeType,
-            description: x.description,
             notAnalyzed: isAnalyzed(x.mimeType, options.supportedImageMimeTypes) ? undefined : true,
         })),
         documents: message.documents?.map((x) => ({

package/dist/src/feature/chat-bot/pendingMediaStartIndex.js

@@ -8,6 +8,14 @@
  * re-sending the binary would make the model analyze the same files again on
  * every turn (and re-upload them, wasting tokens).
  *
+ * The boundary is the last bot message, not the last model output, so media
+ * stays attached for every call of a tool loop within the pending exchange. The
+ * provider APIs are stateless — each call resends the whole history — so the
+ * bytes must travel on every call up to the bot's reply for the model to keep
+ * seeing the file while it works through tool calls (prompt caching keeps the
+ * re-send cheap). Do not stop at function calls, or the model goes blind to the
+ * image right when it composes its post-tool answer.
+ *
  * Returns 0 when the bot has not replied yet, so the whole pending exchange
  * keeps its media.
  */

package/dist/src/feature/chat-bot/stripAnsweredMedia.js

@@ -0,0 +1,17 @@
+import { pendingMediaStartIndex } from './pendingMediaStartIndex.js';
+
+function stripAnsweredMedia(items) {
+    const start = pendingMediaStartIndex(items);
+    return items.map((item, index) => {
+        if (index >= start || item.type !== 'humanMessage')
+            return item;
+        if (!item.humanMessage.images && !item.humanMessage.documents)
+            return item;
+        const humanMessage = { ...item.humanMessage };
+        delete humanMessage.images;
+        delete humanMessage.documents;
+        return { type: 'humanMessage', humanMessage };
+    });
+}
+
+export { stripAnsweredMedia };

package/dist/src/feature/chat-controller/ChatResolver.js

@@ -5,7 +5,6 @@ import '../chat-bot/ChatBot.js';
 import '../chat-bot/ChatOperator.js';
 import { ChatRepository } from '../chat-bot/ChatRepository.js';
 import '../chat-bot/UnionChatAdapter.js';
-import '../chat-bot/ImageDescriber.js';
 import { injectable } from '../../core/injection/index.js';
 import '../chat-bot/metadata/ChatAdapterMetadataStore.js';
 import 'uuid';

package/dist/src/feature/chat-controller/runChatControllers.js

@@ -8,7 +8,6 @@ import { ChatMemory } from '../chat-bot/ChatMemory.js';
 import '../chat-bot/ChatOperator.js';
 import { ChatRepository } from '../chat-bot/ChatRepository.js';
 import '../chat-bot/UnionChatAdapter.js';
-import '../chat-bot/ImageDescriber.js';
 import '../chat-bot/metadata/ChatAdapterMetadataStore.js';
 import 'uuid';
 import { ChatBotMetadataStore } from '../chat-bot/metadata/ChatBotMetadataStore.js';

package/dist/src/feature/project-runner/ProjectRunner.js

@@ -7,7 +7,6 @@ import '../chat-bot/ChatBot.js';
 import '../chat-bot/ChatOperator.js';
 import { ChatRepository } from '../chat-bot/ChatRepository.js';
 import '../chat-bot/UnionChatAdapter.js';
-import '../chat-bot/ImageDescriber.js';
 import '../chat-bot/metadata/ChatAdapterMetadataStore.js';
 import 'uuid';
 import '../chat-bot/metadata/ChatBotMetadataStore.js';

package/dist/src/index.d.ts

@@ -953,8 +953,6 @@ interface IChatMessagesPublicFile {
     base64Url?: undefined;
     mimeType: string;
     id: string;
-    /** Text description of the file content, used to recall it without re-analyzing the binary. */
-    description?: string;
 }
 interface IChatMessagesPrivateFile {
     name?: string;
@@ -962,8 +960,6 @@ interface IChatMessagesPrivateFile {
     base64Url: string;
     mimeType: string;
     id: string;
-    /** Text description of the file content, used to recall it without re-analyzing the binary. */
-    description?: string;
 }
 type IChatMessageFile = IChatMessagesPrivateFile | IChatMessagesPublicFile;
 
@@ -1071,43 +1067,13 @@ interface IChatBot {
     sendMessage(message: IChatMessage, callback: (message: IChatMessage) => Promise<void>): void | Promise<void>;
 }
 
-/** Slice of the mindset used to focus the description on what the assistant cares about. */
-interface IImageDescribeContext {
-    context?: string;
-    skills?: string;
-    limits?: string;
-}
-/**
- * Generates a text description for images so the conversation can recall their
- * content on later turns without re-sending (and re-analyzing) the binary.
- *
- * The description is produced once, on arrival, with a single vision-model call
- * and stored on the image itself; from then on it travels with the message text
- * via {@link extractChatMessageText}.
- */
-declare class ImageDescriber {
-    private adapter;
-    private logger;
-    constructor(adapter: ChatAdapter);
-    /**
-     * Fills `description` for every image on the message that does not have one
-     * yet, mutating the images in place. Safe to call with no images or no models:
-     * it simply does nothing. Failures are logged and leave the image undescribed
-     * rather than aborting the message.
-     */
-    describeMessageImages(message: IChatMessage, models: IMindsetModelRef[], describeContext?: IImageDescribeContext): Promise<void>;
-    describe(image: IChatMessageImage, models: IMindsetModelRef[], describeContext?: IImageDescribeContext): Promise<string | undefined>;
-}
-
 declare class ChatBot implements IChatBot {
     private memory;
     private adapter;
     private mindset;
-    private imageDescriber;
     private logger;
-    constructor(memory: ChatMemory, adapter: ChatAdapter, mindset: MindsetOperator, imageDescriber: ImageDescriber);
+    constructor(memory: ChatMemory, adapter: ChatAdapter, mindset: MindsetOperator);
     sendMessage(message: IChatMessage, callback: (message: IChatMessage) => Promise<void>): Promise<void>;
-    private describeImages;
     protected processLoop(callback: (message: IChatMessage) => Promise<void>, invalidArgsCount: number): Promise<void>;
 }
 
@@ -1207,6 +1173,14 @@ declare class ChatBotMetadataStore {
  * re-sending the binary would make the model analyze the same files again on
  * every turn (and re-upload them, wasting tokens).
  *
+ * The boundary is the last bot message, not the last model output, so media
+ * stays attached for every call of a tool loop within the pending exchange. The
+ * provider APIs are stateless — each call resends the whole history — so the
+ * bytes must travel on every call up to the bot's reply for the model to keep
+ * seeing the file while it works through tool calls (prompt caching keeps the
+ * re-send cheap). Do not stop at function calls, or the model goes blind to the
+ * image right when it composes its post-tool answer.
+ *
  * Returns 0 when the bot has not replied yet, so the whole pending exchange
  * keeps its media.
  */
@@ -1216,24 +1190,7 @@ declare function runChatAdapters(adapters: IConstructor<IChatAdapter>[]): void;
 
 declare function safeJsonParse<T = unknown>(json: string | undefined | null, context?: string): T;
 
-/**
- * Index of the first item whose media (images/documents) the model has not been
- * shown yet — i.e. right after the last model output, be it a bot message or a
- * function call.
- *
- * A file's binary should only be sent on the model's first exposure to it. Once
- * the model has produced anything in response to a human message (a function
- * call during a tool loop, or a reply), it has already analyzed that message's
- * files; re-sending the bytes on the next call would analyze the same file
- * again. This is the within-turn counterpart of {@link pendingMediaStartIndex}:
- * that one keeps a turn's media "active" for vision-model selection across the
- * whole tool loop, while this one stops re-uploading the bytes after the first
- * call.
- *
- * Returns 0 when the model has not produced any output yet, so a brand-new
- * message keeps its media.
- */
-declare function unconsumedMediaStartIndex(items: IChatItem[]): number;
+declare function stripAnsweredMedia(items: IChatItem[]): IChatItem[];
 
 interface IProjectRunnerConfig {
     directories?: string[];
@@ -2765,4 +2722,4 @@ declare function HtmlModule(options: IHtmlModuleOptions): {
     new (): {};
 };
 
-export { AnthropicChatAdapter, ApiKey, ApiKeyGuardMiddleware, ApiKeyHandshakeGuardMiddleware, ApiKeyRepository, Async, AsyncMetadataStore, Auth, Chat, ChatAdapter, ChatAdapterMetadataStore, ChatAdapterRegistry, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatOperator, ChatRepository, ChatResolver, type ClientMap, CmdChannel, CmdChannelConfig, CmdChannelServer, type CmdClientMessage, type CmdServerMessage, type ConfigReference, type ConfigReferenceType, ConfigResolver, Container, ControllerMetadataStore, CronJob, CronJobRepository, CrudRepository, CustomError, DeepSeekChatAdapter, DescriptionMetadataStore, EXPRESS_REQ, EXPRESS_RES, Entity, Env, type ErrorSeverity, ExpressProvider, GoogleChatAdapter, type GoogleChatAdapterV2Options, HtmlModule, HttpServerProvider, type IApiKeyData, type IApiKeyRepository, type IArrayValidationError, type IArrayValidationResult, type IBotMessageItem, type IBuiltQuery, type IChannelMessage, type IChannelMetadata, type IChatAdapter, type IChatAdapterDecoratorConfig, type IChatAdapterMetadata, type IChatAdapterNextItemsReq, type IChatAdapterNextItemsRes, type IChatAssociation, type IChatBot, type IChatBotMetadata, type IChatChannel, type IChatConnection, type IChatControllerMetadata, type IChatData, type IChatItem, type IChatItemData, type IChatItemType, type IChatMemory, type IChatMessage, type IChatMessageDocument, type IChatMessageFile, type IChatMessageImage, type IChatMessagesPrivateFile, type IChatMessagesPublicFile, type IChatRepository, type IChatType, type ICmdChannelEntry, type ICmdChannelHandlers, type ICmdChannelMessage, type ICmdImage, type ICmdIncomingMessage, type ICmdReceivedMessage, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICronConfig, type ICronHandler, type ICronJobData, type ICronJobRepository, type ICrudRepository, type ICustomErrorData, type IDedupConfig, type IDescriptionMetadata, type IEndPointConfig, type IEndPointMetadata, type IEntityData, type IEnvType, type IErrorHandlersConfig, type IErrorMonitor, type IErrorMonitorContext, type IExtractChatMessageTextOptions, type IFunctionCall, type IFunctionCallItem, type IGenerateApiKeyReq, type IGenerateApiKeyRes, type IHandshakeMiddleware, type IHandshakeMiddlewareMetadata, type IHtmlModuleOptions, type IHumanMessageItem, type IImageDescribeContext, type IJobData, type IJobOptions, type IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, type IKapsoChannelConfig, type IKapsoChannelMessage, type IKapsoChannelMessageListener, type IKapsoChatMessage, type IKapsoConversation, type IKapsoEvent, type IKapsoIncomingMessage, type IKapsoMessageReceivedEvent, type IKapsoReceivedMessage, type IKapsoUnknownEvent, type ILanguageModelUsage, type ILockKey, type ILocker, type ILockerKey, type IMemoryRepositoryAdapterOptions, type IMessageContext, type IMiddleware, type IMiddlewareMetadata, type IMindset, type IMindsetConfig, type IMindsetIdentity, type IMindsetLlm, type IMindsetMetadata, type IMindsetModelKind, type IMindsetModelRef, type IMindsetModels, type IMindsetModuleConfig, type IMindsetModuleMetadata, type IMindsetParameterSchema, type IMindsetTool, type IMindsetToolParameter, type IModelValidationError, type IModelValidationResult, type IModelValidatorsInfo, type IMoneyData, type IPersistentData, type IPgRepositoryConfig, type IProjectRunnerConfig, type IPropertyValidatorInfo, type IQueryAst, type IQueryCondition, type IQueryMethodMetadata, type IQueryOrderBy, type IReceivedMessage, type IRemoteApiKeyFetcher, type IRepositoryAdapter, type IRepositoryConfig, type IRepositoryRuntime, type IRestControllerConfig, type IRestControllerMetadata, type IScanProjectFilesOptions, type IScheduleAt, type IScheduleDelay, type ISendWhatsAppMessageReq, type ISendWhatsAppTemplateReq, type ISocketChannelConfig, type ISocketChannelMessage, type ISocketChannelReceivedMessage, type ISocketControllerConfig, type ISocketControllerMetadata, type ISocketEventConfig, type ISocketEventMetadata, type ISocketReceivedMessage, type IStorableData, type ITelegramChannelConfig, type ITelegramChannelMessage, type ITelegramReceivedMessage, type ITransactionAdapter, type IValidateArrayOptions, type IValidateArrayOptionsWithItemsValidators, type IValidateInputShape, type IValidateIsInOptions, type IValidateIsRecordOptions, type IValidateMaxOptions, type IValidateMinOptions, type IValidationError, type IValidationResult, type IValidator, type IValidatorMetadata, type IWasenderChannelConfig, type IWasenderChannelMessageListener, type IWasenderDeviceListMetadata, type IWasenderEvent, type IWasenderMessageContent, type IWasenderMessageContextInfo, type IWasenderMessageKey, type IWasenderMessageReceivedData, type IWasenderMessageReceivedEvent, type IWasenderQrUpdatedEvent, type IWasenderReceivedMessage, type IWhatsAppCloudContact, type IWhatsAppCloudMessage, type IWhatsAppCloudMessageMetadata, type IWhatsAppCloudTemplate, type IWhatsAppCloudTemplateComponent, type IWhatsAppCloudTemplateResponse, type IWhatsAppCloudWebhookPayload, type IWhatsAppSender, type IWhatsAppTemplateData, type IWhatsAppTemplateParameter, type IchatControllerConfig, ImageDescriber, InMemoryChatMemory, InMemoryChatRepository, InMemoryCronJobRepository, InMemoryJobRepository, InMemoryLockKey, InMemoryLocker, Job, JobRepository, JobRunner, Jwt, JwtAccessAndRefreshTokenDto, JwtConfig, JwtGuardMiddleware, JwtHandshakeGuardMiddleware, JwtRefreshToken, JwtRefreshTokenRepository, JwtSigner, JwtTokenDto, KapsoChannel, KapsoChannelConfig, KapsoReceiver, KapsoSender, KapsoWebhookController, Lifecycle, Locker, Logger, MEMORY_ADAPTER_ID, Mapper, MemoryRepositoryAdapter, MemoryRepositoryExtension, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenRouterChatAdapter, OpenaiChatAdapter, PG_ADAPTER_ID, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCronJobRepository, PgCrudRepository, PgJobRepository, PgJsonRepositoryAdapter, PgJwtRefreshTokenRepository, PgLockKey, PgLocker, PgRepositoryBase, PgRepositoryBase as PgRepositoryExtension, PgTransactionAdapter, ProjectRunner, type QueryConnector, type QueryOperator, type QueryPrefix, Random, RemoteApiKeyRepository, RepositoryAdapterRegistry, RepositoryMetadataStore, type ResolvedConfig, RestControllerMetadataStore, RestRequest, SocketChannel, SocketChannelConfig, SocketChannelMessageFile, SocketChannelReceivedMessage, SocketControllerMetadataStore, SocketServerConfig, SocketServerProvider, Storable, TelegramChannel, TelegramChannelConfig, TransactionMetadataStore, UnionChatAdapter, ValidationMetadataStore, WabotChatAdapter, WasenderChannel, WasenderChannelConfig, WasenderReceiver, WasenderSender, WasenderWebhookController, WhatsAppApiSender, WhatsAppReceiverByCloudApi, WhatsAppSender, apiKeyGuard, apiKeyHandshakeGuard, bool, boolArr, buildQuerySql, chatAdapter, chatBot, chatController, chatItemTypeOptions, cmd, cmdChannelName, cmdChannelSocketPath, command, commandHandler, computeDedupKey, container, cronHandler, description, errorToPlainObject, evaluateQueryAst, extractChatMessageText, extractNumberFromWasenderMessageKey, getClientMap, getPgClient, handshakeMiddlewares, inject, injectable, isArray, isBoolean, isChatMessageEmpty, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isRecord, isRetryableError, isString, jwtGuard, jwtHandshakeGuard, kapso, kapsoChannelName, markdownToTelegramHtml, max, memExtension, middleware, min, mindset, mindsetModule, modelInfo, num, numArr, obj, onDelete, onGet, onPost, onPut, onSocketEvent, parseQueryMethodName, pendingMediaStartIndex, pgExtension, pgStorage, query, queryExtension, readJsonFromFile, repository, resolveConfigReferences, restController, run, runChatAdapters, runChatControllers, runCmdClient, runCommandHandlers, runCronHandlers, runRestControllers, runSocketControllers, safeJsonParse, scanProjectFiles, scoped, setupErrorHandlers, singleton, socket, socketChannelName, socketController, stopCommandHandlers, stopCronHandlers, str, strArr, telegram, telegramChannelName, transaction, unconsumedMediaStartIndex, validateAndTransform, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsRecord, validateIsString, validateMax, validateMin, validateModel, wasender, wasenderChannelName, withPgClient, withPgTransaction, writeJsonToFile };
+export { AnthropicChatAdapter, ApiKey, ApiKeyGuardMiddleware, ApiKeyHandshakeGuardMiddleware, ApiKeyRepository, Async, AsyncMetadataStore, Auth, Chat, ChatAdapter, ChatAdapterMetadataStore, ChatAdapterRegistry, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatOperator, ChatRepository, ChatResolver, type ClientMap, CmdChannel, CmdChannelConfig, CmdChannelServer, type CmdClientMessage, type CmdServerMessage, type ConfigReference, type ConfigReferenceType, ConfigResolver, Container, ControllerMetadataStore, CronJob, CronJobRepository, CrudRepository, CustomError, DeepSeekChatAdapter, DescriptionMetadataStore, EXPRESS_REQ, EXPRESS_RES, Entity, Env, type ErrorSeverity, ExpressProvider, GoogleChatAdapter, type GoogleChatAdapterV2Options, HtmlModule, HttpServerProvider, type IApiKeyData, type IApiKeyRepository, type IArrayValidationError, type IArrayValidationResult, type IBotMessageItem, type IBuiltQuery, type IChannelMessage, type IChannelMetadata, type IChatAdapter, type IChatAdapterDecoratorConfig, type IChatAdapterMetadata, type IChatAdapterNextItemsReq, type IChatAdapterNextItemsRes, type IChatAssociation, type IChatBot, type IChatBotMetadata, type IChatChannel, type IChatConnection, type IChatControllerMetadata, type IChatData, type IChatItem, type IChatItemData, type IChatItemType, type IChatMemory, type IChatMessage, type IChatMessageDocument, type IChatMessageFile, type IChatMessageImage, type IChatMessagesPrivateFile, type IChatMessagesPublicFile, type IChatRepository, type IChatType, type ICmdChannelEntry, type ICmdChannelHandlers, type ICmdChannelMessage, type ICmdImage, type ICmdIncomingMessage, type ICmdReceivedMessage, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICronConfig, type ICronHandler, type ICronJobData, type ICronJobRepository, type ICrudRepository, type ICustomErrorData, type IDedupConfig, type IDescriptionMetadata, type IEndPointConfig, type IEndPointMetadata, type IEntityData, type IEnvType, type IErrorHandlersConfig, type IErrorMonitor, type IErrorMonitorContext, type IExtractChatMessageTextOptions, type IFunctionCall, type IFunctionCallItem, type IGenerateApiKeyReq, type IGenerateApiKeyRes, type IHandshakeMiddleware, type IHandshakeMiddlewareMetadata, type IHtmlModuleOptions, type IHumanMessageItem, type IJobData, type IJobOptions, type IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, type IKapsoChannelConfig, type IKapsoChannelMessage, type IKapsoChannelMessageListener, type IKapsoChatMessage, type IKapsoConversation, type IKapsoEvent, type IKapsoIncomingMessage, type IKapsoMessageReceivedEvent, type IKapsoReceivedMessage, type IKapsoUnknownEvent, type ILanguageModelUsage, type ILockKey, type ILocker, type ILockerKey, type IMemoryRepositoryAdapterOptions, type IMessageContext, type IMiddleware, type IMiddlewareMetadata, type IMindset, type IMindsetConfig, type IMindsetIdentity, type IMindsetLlm, type IMindsetMetadata, type IMindsetModelKind, type IMindsetModelRef, type IMindsetModels, type IMindsetModuleConfig, type IMindsetModuleMetadata, type IMindsetParameterSchema, type IMindsetTool, type IMindsetToolParameter, type IModelValidationError, type IModelValidationResult, type IModelValidatorsInfo, type IMoneyData, type IPersistentData, type IPgRepositoryConfig, type IProjectRunnerConfig, type IPropertyValidatorInfo, type IQueryAst, type IQueryCondition, type IQueryMethodMetadata, type IQueryOrderBy, type IReceivedMessage, type IRemoteApiKeyFetcher, type IRepositoryAdapter, type IRepositoryConfig, type IRepositoryRuntime, type IRestControllerConfig, type IRestControllerMetadata, type IScanProjectFilesOptions, type IScheduleAt, type IScheduleDelay, type ISendWhatsAppMessageReq, type ISendWhatsAppTemplateReq, type ISocketChannelConfig, type ISocketChannelMessage, type ISocketChannelReceivedMessage, type ISocketControllerConfig, type ISocketControllerMetadata, type ISocketEventConfig, type ISocketEventMetadata, type ISocketReceivedMessage, type IStorableData, type ITelegramChannelConfig, type ITelegramChannelMessage, type ITelegramReceivedMessage, type ITransactionAdapter, type IValidateArrayOptions, type IValidateArrayOptionsWithItemsValidators, type IValidateInputShape, type IValidateIsInOptions, type IValidateIsRecordOptions, type IValidateMaxOptions, type IValidateMinOptions, type IValidationError, type IValidationResult, type IValidator, type IValidatorMetadata, type IWasenderChannelConfig, type IWasenderChannelMessageListener, type IWasenderDeviceListMetadata, type IWasenderEvent, type IWasenderMessageContent, type IWasenderMessageContextInfo, type IWasenderMessageKey, type IWasenderMessageReceivedData, type IWasenderMessageReceivedEvent, type IWasenderQrUpdatedEvent, type IWasenderReceivedMessage, type IWhatsAppCloudContact, type IWhatsAppCloudMessage, type IWhatsAppCloudMessageMetadata, type IWhatsAppCloudTemplate, type IWhatsAppCloudTemplateComponent, type IWhatsAppCloudTemplateResponse, type IWhatsAppCloudWebhookPayload, type IWhatsAppSender, type IWhatsAppTemplateData, type IWhatsAppTemplateParameter, type IchatControllerConfig, InMemoryChatMemory, InMemoryChatRepository, InMemoryCronJobRepository, InMemoryJobRepository, InMemoryLockKey, InMemoryLocker, Job, JobRepository, JobRunner, Jwt, JwtAccessAndRefreshTokenDto, JwtConfig, JwtGuardMiddleware, JwtHandshakeGuardMiddleware, JwtRefreshToken, JwtRefreshTokenRepository, JwtSigner, JwtTokenDto, KapsoChannel, KapsoChannelConfig, KapsoReceiver, KapsoSender, KapsoWebhookController, Lifecycle, Locker, Logger, MEMORY_ADAPTER_ID, Mapper, MemoryRepositoryAdapter, MemoryRepositoryExtension, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenRouterChatAdapter, OpenaiChatAdapter, PG_ADAPTER_ID, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCronJobRepository, PgCrudRepository, PgJobRepository, PgJsonRepositoryAdapter, PgJwtRefreshTokenRepository, PgLockKey, PgLocker, PgRepositoryBase, PgRepositoryBase as PgRepositoryExtension, PgTransactionAdapter, ProjectRunner, type QueryConnector, type QueryOperator, type QueryPrefix, Random, RemoteApiKeyRepository, RepositoryAdapterRegistry, RepositoryMetadataStore, type ResolvedConfig, RestControllerMetadataStore, RestRequest, SocketChannel, SocketChannelConfig, SocketChannelMessageFile, SocketChannelReceivedMessage, SocketControllerMetadataStore, SocketServerConfig, SocketServerProvider, Storable, TelegramChannel, TelegramChannelConfig, TransactionMetadataStore, UnionChatAdapter, ValidationMetadataStore, WabotChatAdapter, WasenderChannel, WasenderChannelConfig, WasenderReceiver, WasenderSender, WasenderWebhookController, WhatsAppApiSender, WhatsAppReceiverByCloudApi, WhatsAppSender, apiKeyGuard, apiKeyHandshakeGuard, bool, boolArr, buildQuerySql, chatAdapter, chatBot, chatController, chatItemTypeOptions, cmd, cmdChannelName, cmdChannelSocketPath, command, commandHandler, computeDedupKey, container, cronHandler, description, errorToPlainObject, evaluateQueryAst, extractChatMessageText, extractNumberFromWasenderMessageKey, getClientMap, getPgClient, handshakeMiddlewares, inject, injectable, isArray, isBoolean, isChatMessageEmpty, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isRecord, isRetryableError, isString, jwtGuard, jwtHandshakeGuard, kapso, kapsoChannelName, markdownToTelegramHtml, max, memExtension, middleware, min, mindset, mindsetModule, modelInfo, num, numArr, obj, onDelete, onGet, onPost, onPut, onSocketEvent, parseQueryMethodName, pendingMediaStartIndex, pgExtension, pgStorage, query, queryExtension, readJsonFromFile, repository, resolveConfigReferences, restController, run, runChatAdapters, runChatControllers, runCmdClient, runCommandHandlers, runCronHandlers, runRestControllers, runSocketControllers, safeJsonParse, scanProjectFiles, scoped, setupErrorHandlers, singleton, socket, socketChannelName, socketController, stopCommandHandlers, stopCronHandlers, str, strArr, stripAnsweredMedia, telegram, telegramChannelName, transaction, validateAndTransform, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsRecord, validateIsString, validateMax, validateMin, validateModel, wasender, wasenderChannelName, withPgClient, withPgTransaction, writeJsonToFile };

package/dist/src/index.js

@@ -71,7 +71,6 @@ export { ChatRepository } from './feature/chat-bot/ChatRepository.js';
 export { chatItemTypeOptions } from './feature/chat-bot/IChatItem.js';
 export { UnionChatAdapter } from './feature/chat-bot/UnionChatAdapter.js';
 export { extractChatMessageText } from './feature/chat-bot/extractChatMessageText.js';
-export { ImageDescriber } from './feature/chat-bot/ImageDescriber.js';
 export { isChatMessageEmpty } from './feature/chat-bot/isChatMessageEmpty.js';
 export { isRetryableError } from './feature/chat-bot/isRetryableError.js';
 export { chatAdapter } from './feature/chat-bot/metadata/@chatAdapter.js';
@@ -81,7 +80,7 @@ export { ChatBotMetadataStore } from './feature/chat-bot/metadata/ChatBotMetadat
 export { pendingMediaStartIndex } from './feature/chat-bot/pendingMediaStartIndex.js';
 export { runChatAdapters } from './feature/chat-bot/runChatAdapters.js';
 export { safeJsonParse } from './feature/chat-bot/safeJsonParse.js';
-export { unconsumedMediaStartIndex } from './feature/chat-bot/unconsumedMediaStartIndex.js';
+export { stripAnsweredMedia } from './feature/chat-bot/stripAnsweredMedia.js';
 export { chatController } from './feature/chat-controller/metadata/controller/@chatController.js';
 export { ControllerMetadataStore } from './feature/chat-controller/metadata/ControllerMetadataStore.js';
 export { ChatResolver } from './feature/chat-controller/ChatResolver.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wabot-dev/framework",
-  "version": "0.9.24",
+  "version": "0.9.26",
   "description": "Framework for IA Chat Bots",
   "type": "module",
   "main": "dist/src/index.js",

package/dist/src/feature/chat-bot/ImageDescriber.js

@@ -1,95 +0,0 @@
-import { __decorate, __metadata } from 'tslib';
-import { injectable } from '../../core/injection/index.js';
-import { Logger } from '../../core/logger/Logger.js';
-import { ChatAdapter } from './ChatAdapter.js';
-
-const DESCRIBE_INSTRUCTIONS = `
-You describe images so an assistant can reference them later in a conversation
-without seeing the image again.
-
-Write a single, factual, self-contained paragraph covering the visible content:
-objects, people, scene, layout, colors, and any readable text. Be thorough but
-concise. Do not add opinions, greetings, or markdown — output only the
-description.
-`.trim();
-function buildSystemPrompt(describeContext) {
-    const sections = [DESCRIBE_INSTRUCTIONS];
-    const mindsetSections = [
-        ['Assistant context', describeContext.context],
-        ['Assistant skills', describeContext.skills],
-        ['Assistant limits', describeContext.limits],
-    ].filter(([, value]) => value && value.trim());
-    if (mindsetSections.length > 0) {
-        sections.push('The assistant you describe images for is outlined below. Use it only to ' +
-            'decide which details deserve emphasis; still describe anything else that ' +
-            'is clearly visible.');
-        for (const [title, value] of mindsetSections) {
-            sections.push(`## ${title}\n${value.trim()}`);
-        }
-    }
-    return sections.join('\n\n');
-}
-/**
- * Generates a text description for images so the conversation can recall their
- * content on later turns without re-sending (and re-analyzing) the binary.
- *
- * The description is produced once, on arrival, with a single vision-model call
- * and stored on the image itself; from then on it travels with the message text
- * via {@link extractChatMessageText}.
- */
-let ImageDescriber = class ImageDescriber {
-    adapter;
-    logger = new Logger('wabot:image-describer');
-    constructor(adapter) {
-        this.adapter = adapter;
-    }
-    /**
-     * Fills `description` for every image on the message that does not have one
-     * yet, mutating the images in place. Safe to call with no images or no models:
-     * it simply does nothing. Failures are logged and leave the image undescribed
-     * rather than aborting the message.
-     */
-    async describeMessageImages(message, models, describeContext = {}) {
-        const pending = message.images?.filter((image) => !image.description);
-        if (!pending || pending.length === 0 || models.length === 0)
-            return;
-        await Promise.all(pending.map(async (image) => {
-            const description = await this.describe(image, models, describeContext);
-            if (description)
-                image.description = description;
-        }));
-    }
-    async describe(image, models, describeContext = {}) {
-        if (models.length === 0)
-            return undefined;
-        try {
-            const { nextItems } = await this.adapter.nextItems({
-                models,
-                systemPrompt: buildSystemPrompt(describeContext),
-                tools: [],
-                prevItems: [
-                    {
-                        type: 'humanMessage',
-                        humanMessage: { text: 'Describe this image.', images: [image] },
-                    },
-                ],
-            });
-            const parts = [];
-            for (const item of nextItems) {
-                if (item.type === 'botMessage' && item.botMessage.text)
-                    parts.push(item.botMessage.text);
-            }
-            return parts.join('\n').trim() || undefined;
-        }
-        catch (err) {
-            this.logger.warn(`failed to describe image '${image.id}'`, err instanceof Error ? { message: err.message } : { err });
-            return undefined;
-        }
-    }
-};
-ImageDescriber = __decorate([
-    injectable(),
-    __metadata("design:paramtypes", [ChatAdapter])
-], ImageDescriber);
-
-export { ImageDescriber };

package/dist/src/feature/chat-bot/unconsumedMediaStartIndex.js

@@ -1,27 +0,0 @@
-/**
- * Index of the first item whose media (images/documents) the model has not been
- * shown yet — i.e. right after the last model output, be it a bot message or a
- * function call.
- *
- * A file's binary should only be sent on the model's first exposure to it. Once
- * the model has produced anything in response to a human message (a function
- * call during a tool loop, or a reply), it has already analyzed that message's
- * files; re-sending the bytes on the next call would analyze the same file
- * again. This is the within-turn counterpart of {@link pendingMediaStartIndex}:
- * that one keeps a turn's media "active" for vision-model selection across the
- * whole tool loop, while this one stops re-uploading the bytes after the first
- * call.
- *
- * Returns 0 when the model has not produced any output yet, so a brand-new
- * message keeps its media.
- */
-function unconsumedMediaStartIndex(items) {
-    for (let i = items.length - 1; i >= 0; i--) {
-        const type = items[i].type;
-        if (type === 'botMessage' || type === 'functionCall')
-            return i + 1;
-    }
-    return 0;
-}
-
-export { unconsumedMediaStartIndex };