@wabot-dev/framework 0.9.18 → 0.9.20

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

@@ -167,11 +167,8 @@ let AnthropicChatAdapter = class AnthropicChatAdapter {
             description: tool.description,
             input_schema: {
                 type: 'object',
-                properties: tool.parameters.reduce((prev, param) => ({
-                    ...prev,
-                    [param.name]: { type: param.type, description: param.description },
-                }), {}),
-                required: tool.parameters.map((param) => param.name),
+                properties: tool.parameters.reduce((prev, param) => ({ ...prev, [param.name]: param.schema }), {}),
+                required: tool.parameters.filter((p) => p.required).map((p) => p.name),
             },
         };
     }

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

@@ -122,14 +122,10 @@ let DeepSeekChatAdapter = class DeepSeekChatAdapter {
                 description: tool.description,
                 parameters: {
                     type: 'object',
-                    properties: tool.parameters.reduce((prev, param) => ({
-                        ...prev,
-                        [param.name]: { type: param.type, description: param.description },
-                    }), {}),
-                    required: tool.parameters.map((param) => param.name),
+                    properties: tool.parameters.reduce((prev, param) => ({ ...prev, [param.name]: param.schema }), {}),
+                    required: tool.parameters.filter((p) => p.required).map((p) => p.name),
                     additionalProperties: false,
                 },
-                strict: true,
             },
         };
     }

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

@@ -169,11 +169,8 @@ let GoogleChatAdapter = class GoogleChatAdapter {
             description: tool.description,
             parametersJsonSchema: {
                 type: 'object',
-                properties: tool.parameters.reduce((prev, param) => ({
-                    ...prev,
-                    [param.name]: { type: param.type, description: param.description },
-                }), {}),
-                required: tool.parameters.map((param) => param.name),
+                properties: tool.parameters.reduce((prev, param) => ({ ...prev, [param.name]: param.schema }), {}),
+                required: tool.parameters.filter((p) => p.required).map((p) => p.name),
                 additionalProperties: false,
             },
         };

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

@@ -129,20 +129,18 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
         ];
     }
     mapTool(tool) {
+        const allRequired = tool.parameters.every((p) => p.required);
         return {
             type: 'function',
             name: tool.name,
             description: tool.description,
             parameters: {
                 type: 'object',
-                properties: tool.parameters.reduce((prev, param) => ({
-                    ...prev,
-                    [param.name]: { type: param.type, description: param.description },
-                }), {}),
-                required: tool.parameters.map((param) => param.name),
+                properties: tool.parameters.reduce((prev, param) => ({ ...prev, [param.name]: param.schema }), {}),
+                required: tool.parameters.filter((p) => p.required).map((p) => p.name),
                 additionalProperties: false,
             },
-            strict: true,
+            strict: allRequired,
         };
     }
     mapResponse(response, modelName) {

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

@@ -146,14 +146,10 @@ let OpenRouterChatAdapter = class OpenRouterChatAdapter {
                 description: tool.description,
                 parameters: {
                     type: 'object',
-                    properties: tool.parameters.reduce((prev, param) => ({
-                        ...prev,
-                        [param.name]: { type: param.type, description: param.description },
-                    }), {}),
-                    required: tool.parameters.map((param) => param.name),
+                    properties: tool.parameters.reduce((prev, param) => ({ ...prev, [param.name]: param.schema }), {}),
+                    required: tool.parameters.filter((p) => p.required).map((p) => p.name),
                     additionalProperties: false,
                 },
-                strict: true,
             },
         };
     }

package/dist/src/addon/chat-controller/telegram/TelegramChannel.js

@@ -2,6 +2,7 @@ import { __decorate, __metadata } from 'tslib';
 import { Bot } from 'grammy';
 import { TelegramChannelConfig } from './TelegramChannelConfig.js';
 import { injectable } from '../../../core/injection/index.js';
+import { markdownToTelegramHtml } from './markdownToTelegramHtml.js';
 import { telegramChannelName } from './telegramChannelName.js';
 
 var TelegramChannel_1;
@@ -35,7 +36,9 @@ let TelegramChannel = class TelegramChannel {
                 reply: async (replyMessage) => {
                     if (!replyMessage.text)
                         return;
-                    await ctx.reply(replyMessage.text);
+                    await ctx.reply(markdownToTelegramHtml(replyMessage.text), {
+                        parse_mode: 'HTML',
+                    });
                 },
             });
         });

package/dist/src/addon/chat-controller/telegram/markdownToTelegramHtml.js

@@ -0,0 +1,45 @@
+const PH_OPEN = '
';
+const PH_CLOSE = '';
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+function markdownToTelegramHtml(input) {
+    if (!input)
+        return input;
+    const reserved = [];
+    const reserve = (html) => {
+        const token = `${PH_OPEN}${reserved.length}${PH_CLOSE}`;
+        reserved.push(html);
+        return token;
+    };
+    let text = input.replace(/\r\n/g, '\n');
+    text = text.replace(/```(\w+)?\n?([\s\S]*?)```/g, (_, lang, code) => {
+        const escaped = escapeHtml(code.replace(/\n$/, ''));
+        if (lang)
+            return reserve(`<pre><code class="language-${lang}">${escaped}</code></pre>`);
+        return reserve(`<pre>${escaped}</pre>`);
+    });
+    text = text.replace(/`([^`\n]+)`/g, (_, code) => {
+        return reserve(`<code>${escapeHtml(code)}</code>`);
+    });
+    text = text.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (_, label, url) => {
+        return reserve(`<a href="${escapeHtml(url)}">${escapeHtml(label)}</a>`);
+    });
+    text = escapeHtml(text);
+    text = text.replace(/^(#{1,6})\s+(.+)$/gm, (_, _hashes, content) => `<b>${content.trim()}</b>`);
+    text = text.replace(/^&gt;\s?(.*)$/gm, '<blockquote>$1</blockquote>');
+    text = text.replace(/<\/blockquote>\n<blockquote>/g, '\n');
+    text = text.replace(/\*\*([^\n*]+?)\*\*/g, '<b>$1</b>');
+    text = text.replace(/__([^\n_]+?)__/g, '<b>$1</b>');
+    text = text.replace(/(^|[\s(>])\*([^\s*][^*\n]*?)\*(?=[\s).,!?:;]|$)/g, '$1<i>$2</i>');
+    text = text.replace(/(^|[\s(>])_([^\s_][^_\n]*?)_(?=[\s).,!?:;]|$)/g, '$1<i>$2</i>');
+    text = text.replace(/~~([^\n~]+?)~~/g, '<s>$1</s>');
+    text = text.replace(/^[ \t]*[-*+]\s+(.+)$/gm, '• $1');
+    text = text.replace(new RegExp(`${PH_OPEN}(\\d+)${PH_CLOSE}`, 'g'), (_, idx) => reserved[Number(idx)]);
+    return text;
+}
+
+export { markdownToTelegramHtml };

package/dist/src/addon/chat-controller/whatsapp/kapso/@kapso.js

@@ -0,0 +1,23 @@
+import { container } from '../../../../core/injection/index.js';
+import { resolveConfigReferences } from '../../../../core/config/resolver.js';
+import { ControllerMetadataStore } from '../../../../feature/chat-controller/metadata/ControllerMetadataStore.js';
+import '../../../../feature/chat-controller/ChatResolver.js';
+import '../../../../feature/chat-controller/runChatControllers.js';
+import { KapsoChannel } from './KapsoChannel.js';
+import { KapsoChannelConfig } from './KapsoChannelConfig.js';
+
+function kapso(config) {
+    return function (target, propertyKey) {
+        const cfg = config ?? {};
+        const resolvedConfig = resolveConfigReferences(cfg);
+        const store = container.resolve(ControllerMetadataStore);
+        store.saveChannelMetadata({
+            channelConstructor: KapsoChannel,
+            functionName: propertyKey.toString(),
+            controllerConstructor: target.constructor,
+            channelConfig: new KapsoChannelConfig(resolvedConfig),
+        });
+    };
+}
+
+export { kapso };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoChannel.js

@@ -0,0 +1,65 @@
+import { __decorate, __metadata } from 'tslib';
+import { injectable } from '../../../../core/injection/index.js';
+import { Env } from '../../../../core/env/Env.js';
+import { Logger } from '../../../../core/logger/Logger.js';
+import { KapsoChannelConfig } from './KapsoChannelConfig.js';
+import { KapsoReceiver } from './KapsoReceiver.js';
+import { KapsoSender } from './KapsoSender.js';
+import { kapsoChannelName } from './KapsoChannelName.js';
+
+var KapsoChannel_1;
+let KapsoChannel = class KapsoChannel {
+    static { KapsoChannel_1 = this; }
+    logger = new Logger('wabot:whatsapp-by-kapso-channel');
+    sender;
+    receiver;
+    phoneNumberId;
+    static channelName = kapsoChannelName;
+    constructor(config, env) {
+        const apiKey = config.apiKey ?? env.requireString('KAPSO_API_KEY');
+        const webhookSecret = config.webhookSecret ?? process.env.KAPSO_WEBHOOK_SECRET;
+        this.phoneNumberId = config.phoneNumberId ?? env.requireString('KAPSO_PHONE_NUMBER_ID');
+        this.sender = new KapsoSender(apiKey, this.phoneNumberId);
+        this.receiver = new KapsoReceiver({
+            webhookSecret,
+            webhookPath: config.webhookPath,
+        });
+    }
+    listen(callback) {
+        this.receiver.listenMessage(async (message, from) => {
+            try {
+                await callback({
+                    channel: kapsoChannelName,
+                    chatConnection: {
+                        chatType: 'PRIVATE',
+                        channelName: KapsoChannel_1.channelName,
+                        id: from,
+                    },
+                    message,
+                    reply: async (replyMessage) => {
+                        await this.sender.sendMessage({
+                            from: this.phoneNumberId,
+                            to: from,
+                            message: replyMessage,
+                        });
+                    },
+                });
+            }
+            catch (err) {
+                this.logger.error('Failed to handle WhatsApp message', err);
+            }
+        });
+    }
+    connect() {
+        this.receiver.connect();
+    }
+    disconnect() {
+        this.receiver.disconnect();
+    }
+};
+KapsoChannel = KapsoChannel_1 = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [KapsoChannelConfig, Env])
+], KapsoChannel);
+
+export { KapsoChannel };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoChannelConfig.js

@@ -0,0 +1,14 @@
+class KapsoChannelConfig {
+    apiKey;
+    webhookSecret;
+    phoneNumberId;
+    webhookPath;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.webhookSecret = config.webhookSecret;
+        this.phoneNumberId = config.phoneNumberId;
+        this.webhookPath = config.webhookPath ?? '/kapso/hook';
+    }
+}
+
+export { KapsoChannelConfig };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoChannelName.js

@@ -0,0 +1,3 @@
+const kapsoChannelName = 'WhatsAppByKapsoChannel';
+
+export { kapsoChannelName };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoReceiver.js

@@ -0,0 +1,36 @@
+import { __decorate, __metadata } from 'tslib';
+import '../../../../core/injection/index.js';
+import '../../../../feature/rest-controller/metadata/RestControllerMetadataStore.js';
+import { restController } from '../../../../feature/rest-controller/metadata/@restController.js';
+import { runRestControllers } from '../../../../feature/rest-controller/runRestControllers.js';
+import { KapsoWebhookController } from './KapsoWebhookController.js';
+
+class KapsoReceiver {
+    config;
+    listener = null;
+    constructor(config) {
+        this.config = config;
+    }
+    listenMessage(listener) {
+        this.listener = listener;
+    }
+    connect() {
+        const webhookSecret = this.config.webhookSecret;
+        const listener = this.listener;
+        let UniqueController = class UniqueController extends KapsoWebhookController {
+            constructor() {
+                super(webhookSecret, listener);
+            }
+        };
+        UniqueController = __decorate([
+            restController(this.config.webhookPath),
+            __metadata("design:paramtypes", [])
+        ], UniqueController);
+        runRestControllers([UniqueController]);
+    }
+    disconnect() {
+        // Nothing to disconnect
+    }
+}
+
+export { KapsoReceiver };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoSender.js

@@ -0,0 +1,44 @@
+import { Logger } from '../../../../core/logger/Logger.js';
+
+class KapsoSender {
+    apiKey;
+    phoneNumberId;
+    logger = new Logger('wabot:whatsapp-sender-by-kapso');
+    baseUrl = 'https://api.kapso.ai/meta/whatsapp/v24.0';
+    constructor(apiKey, phoneNumberId) {
+        this.apiKey = apiKey;
+        this.phoneNumberId = phoneNumberId;
+    }
+    async sendMessage(request) {
+        const url = `${this.baseUrl}/${this.phoneNumberId}/messages`;
+        const payload = {
+            messaging_product: 'whatsapp',
+            recipient_type: 'individual',
+            to: request.to.replace(/\D+/g, ''),
+            type: 'text',
+            text: {
+                preview_url: false,
+                body: request.message.text ?? '',
+            },
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'X-API-Key': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            this.logger.error(`Failed to send message from '${request.from}' to '${request.to}': ${response.status} ${errorBody}`);
+            throw new Error(`Kapso send message failed: ${response.status} ${errorBody}`);
+        }
+        this.logger.trace(`message sent from '${request.from}' to '${request.to}'`);
+    }
+    async sendTemplate(_request) {
+        throw new Error('Method not implemented.');
+    }
+}
+
+export { KapsoSender };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoWebhookController.js

@@ -0,0 +1,99 @@
+import { __decorate, __metadata } from 'tslib';
+import { createHmac, timingSafeEqual } from 'node:crypto';
+import { IncomingMessage } from 'node:http';
+import { Logger } from '../../../../core/logger/Logger.js';
+import '../../../../core/injection/index.js';
+import '../../../../feature/rest-controller/metadata/RestControllerMetadataStore.js';
+import { onPost } from '../../../../feature/rest-controller/metadata/@onPost.js';
+
+class KapsoWebhookController {
+    webhookSecret;
+    listener;
+    logger = new Logger('wabot:kapso-webhook');
+    constructor(webhookSecret, listener) {
+        this.webhookSecret = webhookSecret;
+        this.listener = listener;
+    }
+    async handleWebhook(req) {
+        const rawBody = await this.getRawBody(req);
+        if (!this.verifySignature(req, rawBody)) {
+            this.logger.warn('rejected webhook with invalid signature');
+            throw new Error('Invalid webhook signature');
+        }
+        let event;
+        try {
+            event = JSON.parse(rawBody);
+        }
+        catch (err) {
+            this.logger.error('Failed to parse webhook payload', err);
+            throw new Error('Invalid webhook payload');
+        }
+        this.logger.trace(`received event ${event.event}`);
+        switch (event.event) {
+            case 'whatsapp.message.received':
+                await this.handleMessageReceived(event);
+                break;
+            default:
+                this.logger.trace(`unhandled event type ${event.event}`);
+        }
+    }
+    async handleMessageReceived(event) {
+        const message = event.message;
+        if (message.type !== 'text' || !message.text) {
+            this.logger.warn(`message type '${message.type}' is not supported yet`);
+            return;
+        }
+        const rawNumber = message.from ?? event.conversation?.phone_number ?? '';
+        if (!rawNumber) {
+            this.logger.warn('received message without a sender number');
+            return;
+        }
+        const from = rawNumber.startsWith('+') ? rawNumber : `+${rawNumber}`;
+        const senderName = event.conversation?.kapso?.contact_name ?? message.username ?? from;
+        this.logger.trace(`new message from '${from}'`);
+        await this.listener({
+            text: message.text.body,
+            senderName,
+            senderId: from,
+            metadata: {
+                whatsAppNumber: from,
+            },
+        }, from);
+    }
+    verifySignature(req, rawBody) {
+        if (!this.webhookSecret) {
+            return true;
+        }
+        const headerValue = req.headers['x-webhook-signature'];
+        const provided = Array.isArray(headerValue) ? headerValue[0] : headerValue;
+        if (!provided) {
+            return false;
+        }
+        const expected = createHmac('sha256', this.webhookSecret).update(rawBody).digest('hex');
+        const providedHex = provided.startsWith('sha256=') ? provided.slice('sha256='.length) : provided;
+        const expectedBuf = Buffer.from(expected, 'hex');
+        const providedBuf = Buffer.from(providedHex, 'hex');
+        if (expectedBuf.length !== providedBuf.length) {
+            return false;
+        }
+        return timingSafeEqual(expectedBuf, providedBuf);
+    }
+    getRawBody(req) {
+        return new Promise((resolve, reject) => {
+            let data = '';
+            req.on('data', (chunk) => {
+                data += chunk;
+            });
+            req.on('end', () => resolve(data));
+            req.on('error', (err) => reject(err));
+        });
+    }
+}
+__decorate([
+    onPost({ disableJsonParser: true, disableUrlEncodedParser: true }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [IncomingMessage]),
+    __metadata("design:returntype", Promise)
+], KapsoWebhookController.prototype, "handleWebhook", null);
+
+export { KapsoWebhookController };

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

@@ -5,11 +5,20 @@ import { MindsetOperator } from '../mindset/MindsetOperator.js';
 import { ChatAdapter } from './ChatAdapter.js';
 import { ChatItem } from './ChatItem.js';
 import { ChatMemory } from './ChatMemory.js';
+import { Logger } from '../../core/logger/Logger.js';
 
+const MAX_CONSECUTIVE_INVALID_ARGS = 2;
+function isInvalidArgsResult(result) {
+    if (!result)
+        return false;
+    return (result.startsWith('{"error":"INVALID_ARGUMENTS"') ||
+        result.startsWith('{"error":"INVALID_JSON_ARGUMENTS"'));
+}
 let ChatBot = class ChatBot {
     memory;
     adapter;
     mindset;
+    logger = new Logger('wabot:chat-bot');
     constructor(memory, adapter, mindset) {
         this.memory = memory;
         this.adapter = adapter;
@@ -21,9 +30,9 @@ let ChatBot = class ChatBot {
             humanMessage: message,
         });
         await this.memory.create(newChatItem);
-        await this.processLoop(callback);
+        await this.processLoop(callback, 0);
     }
-    async processLoop(callback) {
+    async processLoop(callback, invalidArgsCount) {
         const prevItems = await this.memory.findLastItems(16);
         if (prevItems.length === 0) {
             return;
@@ -53,6 +62,12 @@ let ChatBot = class ChatBot {
         for (const newItemData of newItemsData) {
             if (newItemData.type === 'functionCall') {
                 newItemData.functionCall.result = await this.mindset.callFunction(newItemData.functionCall.name, newItemData.functionCall.arguments ?? '{}');
+                if (isInvalidArgsResult(newItemData.functionCall.result)) {
+                    invalidArgsCount++;
+                }
+                else {
+                    invalidArgsCount = 0;
+                }
             }
             else if (newItemData.type === 'botMessage') {
                 newItemData.botMessage.senderName = identity.name;
@@ -63,10 +78,14 @@ let ChatBot = class ChatBot {
                 await callback(newChatItem.botMessage);
             }
         }
+        if (invalidArgsCount >= MAX_CONSECUTIVE_INVALID_ARGS) {
+            this.logger.warn(`Aborting chat loop after ${invalidArgsCount} consecutive invalid-argument function calls`);
+            return;
+        }
         if (newItemsData.length == 0 || newItemsData[newItemsData.length - 1].type === 'botMessage') {
             return;
         }
-        await this.processLoop(callback);
+        await this.processLoop(callback, invalidArgsCount);
     }
 };
 ChatBot = __decorate([

package/dist/src/feature/mindset/MindsetOperator.js

@@ -7,6 +7,8 @@ import '../../core/validation/metadata/ValidationMetadataStore.js';
 import { CustomError, errorToPlainObject } from '../../core/error/CustomError.js';
 import '../../core/error/setupErrorHandlers.js';
 import { Logger } from '../../core/logger/Logger.js';
+import { DescriptionMetadataStore } from '../../core/description/metadata/DescriptionMetadataStore.js';
+import { buildPropertySchema } from './buildParameterSchema.js';
 import { Container } from '../../core/injection/Container.js';
 
 const MODEL_KIND_FALLBACK = {
@@ -16,11 +18,13 @@ const MODEL_KIND_FALLBACK = {
 let MindsetOperator = class MindsetOperator {
     mindset;
     container;
+    descriptionStore;
     logger = new Logger('wabot:mindset-operator');
     metadata;
-    constructor(mindset, container, metadataStore) {
+    constructor(mindset, container, metadataStore, descriptionStore) {
         this.mindset = mindset;
         this.container = container;
+        this.descriptionStore = descriptionStore;
         this.metadata = metadataStore.getMindsetInfo(this.mindset.constructor);
     }
     context() {
@@ -107,38 +111,37 @@ let MindsetOperator = class MindsetOperator {
         return systemPrompt;
     }
     tools() {
+        const deps = {
+            descriptionStore: this.descriptionStore,
+        };
         return this.metadata.modules
             .map((module) => module.functions.map((fn) => {
+            const argsValidatorsInfo = fn.argsValidatorsInfo;
+            const propertyValidators = argsValidatorsInfo?.properties ?? {};
             return {
                 language: module.config?.language ?? 'english',
                 name: fn.name,
                 description: fn.description,
-                parameters: fn.argsDescriptions.map((x) => ({
-                    type: this.paramType(x.typeDescriptor),
-                    name: x.propertyName,
-                    description: this.paramDescription(x.description, x.typeDescriptor),
-                })),
+                parameters: fn.argsDescriptions.map((arg) => {
+                    const propInfo = propertyValidators[arg.propertyName];
+                    const schema = buildPropertySchema(propInfo?.validators ?? [], this.paramDescription(arg.description, arg.typeDescriptor), deps);
+                    return {
+                        name: arg.propertyName,
+                        required: !propInfo?.isOptional,
+                        schema,
+                    };
+                }),
             };
         }))
             .flat();
     }
     paramDescription(rawDescription, rawType) {
-        let description = `
-      ### description (in your main language)
-      ${rawDescription.replaceAll('#', ' ')}
-    `;
+        let description = rawDescription.replaceAll('#', ' ').trim();
         if (rawType === 'date') {
-            description = `${description}
-          ### format: ISO 8681 - YYYY-MM-DDTHH:mm:ssZ
-      `;
+            description = `${description}\nFormat: ISO 8601 - YYYY-MM-DDTHH:mm:ssZ`;
         }
         return description;
     }
-    paramType(rawType) {
-        if (rawType === 'date')
-            return 'string';
-        return rawType;
-    }
     async callFunction(name, params) {
         const fnMetadata = this.metadata.modules
             .map((module) => module.functions)
@@ -151,16 +154,37 @@ let MindsetOperator = class MindsetOperator {
                 message: `Function '${name}' is not registered in mindset tools`,
             });
         }
+        let paramsObj;
         try {
-            let paramsObj = JSON.parse(params);
-            const modelValidationInfo = fnMetadata.argsValidatorsInfo;
-            if (modelValidationInfo) {
-                const validation = validateModel(paramsObj, modelValidationInfo);
-                if (validation.error) {
-                    throw new CustomError({ message: 'IA Params Are invalid', info: validation.error });
-                }
-                paramsObj = validation.value;
+            paramsObj = JSON.parse(params);
+        }
+        catch (parseError) {
+            const aiResponse = JSON.stringify({
+                error: 'INVALID_JSON_ARGUMENTS',
+                message: 'The function call arguments are not valid JSON. Re-issue the call with a valid JSON object.',
+                details: parseError instanceof Error ? parseError.message : String(parseError),
+            });
+            this.logger.error(`Function '${name}' received non-JSON arguments`, { params, parseError });
+            return aiResponse;
+        }
+        const modelValidationInfo = fnMetadata.argsValidatorsInfo;
+        if (modelValidationInfo) {
+            const validation = validateModel(paramsObj, modelValidationInfo);
+            if (validation.error) {
+                const aiResponse = JSON.stringify({
+                    error: 'INVALID_ARGUMENTS',
+                    message: 'The provided arguments did not pass validation. Inspect the errors below and re-issue the call with corrected arguments.',
+                    details: this.flattenValidationError(validation.error),
+                });
+                this.logger.warn(`Function '${name}' received invalid arguments`, {
+                    params,
+                    errors: validation.error,
+                });
+                return aiResponse;
             }
+            paramsObj = validation.value;
+        }
+        try {
             const module = this.container.resolve(fnMetadata.moduleConstructor);
             const response = await module[name](paramsObj);
             if (!response) {
@@ -179,6 +203,41 @@ let MindsetOperator = class MindsetOperator {
             return aiResponse;
         }
     }
+    flattenValidationError(error, path = '') {
+        const out = [];
+        if (!error)
+            return out;
+        if (Array.isArray(error?.items)) {
+            error.items.forEach((itemErrors, idx) => {
+                if (!itemErrors)
+                    return;
+                const itemPath = `${path}[${idx}]`;
+                if (Array.isArray(itemErrors)) {
+                    itemErrors.forEach((ie) => out.push(...this.flattenValidationError(ie, itemPath)));
+                }
+                else {
+                    out.push(...this.flattenValidationError(itemErrors, itemPath));
+                }
+            });
+            if (out.length > 0)
+                return out;
+        }
+        if (error?.properties && typeof error.properties === 'object') {
+            for (const propName in error.properties) {
+                const propErrors = error.properties[propName];
+                const propPath = path ? `${path}.${propName}` : propName;
+                if (Array.isArray(propErrors)) {
+                    propErrors.forEach((pe) => out.push(...this.flattenValidationError(pe, propPath)));
+                }
+            }
+            if (out.length > 0)
+                return out;
+        }
+        if (typeof error.description === 'string') {
+            out.push({ path: path || '(root)', message: error.description });
+        }
+        return out;
+    }
     async functionResponseToString(response) {
         if (response instanceof Response) {
             const contentType = response.headers.get('Content-Type') || '';
@@ -232,7 +291,8 @@ MindsetOperator = __decorate([
     injectable(),
     __metadata("design:paramtypes", [Mindset,
         Container,
-        MindsetMetadataStore])
+        MindsetMetadataStore,
+        DescriptionMetadataStore])
 ], MindsetOperator);
 
 export { MindsetOperator };

package/dist/src/feature/mindset/buildParameterSchema.js

@@ -0,0 +1,155 @@
+import '../../core/injection/index.js';
+import { validateModel } from '../../core/validation/core/validateModel.js';
+import '../../core/validation/metadata/ValidationMetadataStore.js';
+import { validateArray } from '../../core/validation/core/validateArray.js';
+import { validateIsBoolean } from '../../core/validation/validators/is-boolean/validateIsBoolean.js';
+import { validateIsDate } from '../../core/validation/validators/is-date/validateIsDate.js';
+import { validateIsIn } from '../../core/validation/validators/is-in/validateIsIn.js';
+import { validateIsNotEmpty } from '../../core/validation/validators/is-not-empty/validateIsNotEmpty.js';
+import { validateIsNumber } from '../../core/validation/validators/is-number/validateIsNumber.js';
+import { validateIsString } from '../../core/validation/validators/is-string/validateIsString.js';
+import { validateMax } from '../../core/validation/validators/max/validateMax.js';
+import { validateMin } from '../../core/validation/validators/min/validateMin.js';
+import { validateIsRecord } from '../../core/validation/validators/is-record/validateIsRecord.js';
+
+function buildPropertySchema(validators, description, deps) {
+    const schema = { type: 'string' };
+    if (description)
+        schema.description = description;
+    let typeAssigned = false;
+    for (const v of validators) {
+        const { validator, validatorOptions } = v;
+        if (validator === validateIsString) {
+            schema.type = 'string';
+            typeAssigned = true;
+        }
+        else if (validator === validateIsNumber) {
+            schema.type = 'number';
+            typeAssigned = true;
+        }
+        else if (validator === validateIsBoolean) {
+            schema.type = 'boolean';
+            typeAssigned = true;
+        }
+        else if (validator === validateIsDate) {
+            schema.type = 'string';
+            schema.format = 'date-time';
+            typeAssigned = true;
+        }
+        else if (validator === validateArray) {
+            schema.type = 'array';
+            typeAssigned = true;
+            const arrOpts = validatorOptions;
+            if (arrOpts?.minLength != null)
+                schema.minItems = arrOpts.minLength;
+            if (arrOpts?.maxLength != null)
+                schema.maxItems = arrOpts.maxLength;
+            if (arrOpts?.itemsValidator && arrOpts.itemsValidator.length > 0) {
+                const itemValidatorInfos = arrOpts.itemsValidator.map((iv, idx) => ({
+                    propertyName: `__item_${idx}`,
+                    validator: iv.validator,
+                    validatorOptions: iv.options,
+                }));
+                schema.items = buildPropertySchema(itemValidatorInfos, undefined, deps);
+            }
+            else {
+                schema.items = { type: 'string' };
+            }
+        }
+        else if (validator === validateModel) {
+            const modelInfo = validatorOptions;
+            schema.type = 'object';
+            typeAssigned = true;
+            if (modelInfo) {
+                const built = buildModelSchema(modelInfo, deps);
+                schema.properties = built.properties;
+                if (built.required && built.required.length > 0) {
+                    schema.required = built.required;
+                }
+                schema.additionalProperties = false;
+            }
+        }
+        else if (validator === validateIsRecord) {
+            schema.type = 'object';
+            typeAssigned = true;
+            const opts = validatorOptions;
+            if (opts) {
+                schema.additionalProperties = { type: opts.valueType };
+            }
+        }
+        else if (validator === validateIsIn) {
+            const opts = validatorOptions;
+            if (opts) {
+                schema.enum = [...opts.values];
+                if (!typeAssigned) {
+                    const sample = opts.values.find((x) => x != null);
+                    const t = typeof sample;
+                    if (t === 'string' || t === 'number' || t === 'boolean') {
+                        schema.type = t;
+                        typeAssigned = true;
+                    }
+                }
+            }
+        }
+        else if (validator === validateMin) {
+            const opts = validatorOptions;
+            const limit = opts && Number(opts.limit);
+            if (limit != null && !Number.isNaN(limit)) {
+                if (schema.type === 'string') {
+                    schema.minLength = limit;
+                }
+                else if (schema.type === 'array') {
+                    schema.minItems = limit;
+                }
+                else {
+                    schema.minimum = limit;
+                }
+            }
+        }
+        else if (validator === validateMax) {
+            const opts = validatorOptions;
+            const limit = opts && Number(opts.limit);
+            if (limit != null && !Number.isNaN(limit)) {
+                if (schema.type === 'string') {
+                    schema.maxLength = limit;
+                }
+                else if (schema.type === 'array') {
+                    schema.maxItems = limit;
+                }
+                else {
+                    schema.maximum = limit;
+                }
+            }
+        }
+        else if (validator === validateIsNotEmpty) {
+            if (schema.type === 'array') {
+                if (schema.minItems == null || schema.minItems < 1)
+                    schema.minItems = 1;
+            }
+            else {
+                if (schema.minLength == null || schema.minLength < 1)
+                    schema.minLength = 1;
+            }
+        }
+    }
+    return schema;
+}
+function buildModelSchema(modelInfo, deps) {
+    const properties = {};
+    const required = [];
+    const descriptions = deps.descriptionStore.getModelDescriptions(modelInfo.modelConstructor);
+    const descByName = new Map(descriptions.map((d) => [d.propertyName, d]));
+    for (const propertyName in modelInfo.properties) {
+        const propInfo = modelInfo.properties[propertyName];
+        if (!propInfo)
+            continue;
+        const desc = descByName.get(propertyName)?.description;
+        const schema = buildPropertySchema(propInfo.validators ?? [], desc, deps);
+        properties[propertyName] = schema;
+        if (!propInfo.isOptional)
+            required.push(propertyName);
+    }
+    return { properties, required };
+}
+
+export { buildModelSchema, buildPropertySchema };

package/dist/src/index.d.ts

@@ -867,10 +867,26 @@ declare class MindsetMetadataStore {
     };
 }
 
+interface IMindsetParameterSchema {
+    type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+    description?: string;
+    enum?: (string | number | boolean | null)[];
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    items?: IMindsetParameterSchema;
+    properties?: Record<string, IMindsetParameterSchema>;
+    required?: string[];
+    additionalProperties?: boolean | IMindsetParameterSchema;
+}
 interface IMindsetToolParameter {
-    type: string;
     name: string;
-    description: string;
+    required: boolean;
+    schema: IMindsetParameterSchema;
 }
 
 interface IMindsetTool {
@@ -883,9 +899,10 @@ interface IMindsetTool {
 declare class MindsetOperator implements IMindset {
     private mindset;
     private container;
+    private descriptionStore;
     private logger;
     private metadata;
-    constructor(mindset: Mindset, container: Container, metadataStore: MindsetMetadataStore);
+    constructor(mindset: Mindset, container: Container, metadataStore: MindsetMetadataStore, descriptionStore: DescriptionMetadataStore);
     context(): Promise<string>;
     identity(): Promise<IMindsetIdentity>;
     skills(): Promise<string>;
@@ -898,8 +915,8 @@ declare class MindsetOperator implements IMindset {
     systemPrompt(): Promise<string>;
     tools(): IMindsetTool[];
     protected paramDescription(rawDescription: string, rawType: string): string;
-    protected paramType(rawType: string): string;
     callFunction(name: string, params: string): Promise<string>;
+    private flattenValidationError;
     functionResponseToString(response: any): Promise<string>;
     functionErrorToString(error: any): Promise<string>;
 }
@@ -1028,9 +1045,10 @@ declare class ChatBot implements IChatBot {
     private memory;
     private adapter;
     private mindset;
+    private logger;
     constructor(memory: ChatMemory, adapter: ChatAdapter, mindset: MindsetOperator);
     sendMessage(message: IChatMessage, callback: (message: IChatMessage) => Promise<void>): Promise<void>;
-    protected processLoop(callback: (message: IChatMessage) => Promise<void>): Promise<void>;
+    protected processLoop(callback: (message: IChatMessage) => Promise<void>, invalidArgsCount: number): Promise<void>;
 }
 
 interface IChatRepository {
@@ -2187,6 +2205,8 @@ declare class TelegramChannel implements IChatChannel {
     disconnect(): void;
 }
 
+declare function markdownToTelegramHtml(input: string): string;
+
 interface IWhatsAppCloudTemplateResponse {
     data: IWhatsAppCloudTemplate[];
     paging: IWhatsAppCloudApiPaging;
@@ -2335,6 +2355,130 @@ declare class WhatsAppApiSender implements IWhatsAppSender {
     sendTemplate(request: ISendWhatsAppTemplateReq): Promise<void>;
 }
 
+interface IKapsoChannelConfig {
+    apiKey?: string | ConfigReference<string>;
+    webhookSecret?: string | ConfigReference<string>;
+    phoneNumberId?: string | ConfigReference<string>;
+    webhookPath?: string;
+}
+
+declare function kapso(config?: IKapsoChannelConfig): (target: object, propertyKey: string | symbol) => void;
+
+interface IKapsoChatMessage extends IChatMessage {
+    metadata: {
+        whatsAppNumber: string;
+    };
+}
+
+declare const kapsoChannelName: "WhatsAppByKapsoChannel";
+
+interface IKapsoReceivedMessage extends IReceivedMessage {
+    channel: typeof kapsoChannelName;
+    message: IKapsoChatMessage;
+}
+
+interface IKapsoChannelMessage extends IKapsoReceivedMessage {
+    chatConnection: IChatConnection;
+    injectInstances?: [any, any][];
+}
+
+type IKapsoEvent = IKapsoMessageReceivedEvent | IKapsoUnknownEvent;
+interface IKapsoUnknownEvent {
+    event: string;
+    [key: string]: unknown;
+}
+interface IKapsoMessageReceivedEvent {
+    event: 'whatsapp.message.received';
+    message: IKapsoIncomingMessage;
+    conversation: IKapsoConversation;
+    is_new_conversation?: boolean;
+    phone_number_id?: string;
+}
+interface IKapsoIncomingMessage {
+    id: string;
+    timestamp: string;
+    type: string;
+    from: string;
+    from_user_id?: string;
+    from_parent_user_id?: string;
+    username?: string;
+    text?: {
+        body: string;
+    };
+}
+interface IKapsoConversation {
+    id: string;
+    phone_number?: string;
+    business_scoped_user_id?: string;
+    parent_business_scoped_user_id?: string;
+    username?: string;
+    status?: string;
+    phone_number_id?: string;
+    kapso?: {
+        contact_name?: string;
+        [key: string]: unknown;
+    };
+}
+
+declare class KapsoChannelConfig {
+    readonly apiKey?: string;
+    readonly webhookSecret?: string;
+    readonly phoneNumberId?: string;
+    readonly webhookPath: string;
+    constructor(config: {
+        apiKey?: string;
+        webhookSecret?: string;
+        phoneNumberId?: string;
+        webhookPath?: string;
+    });
+}
+
+declare class KapsoChannel implements IChatChannel {
+    private logger;
+    private sender;
+    private receiver;
+    private phoneNumberId;
+    static channelName: "WhatsAppByKapsoChannel";
+    constructor(config: KapsoChannelConfig, env: Env);
+    listen(callback: (message: IKapsoChannelMessage) => Promise<void>): void;
+    connect(): void;
+    disconnect(): void;
+}
+
+type IKapsoChannelMessageListener = (message: IKapsoChatMessage, from: string) => Promise<void>;
+declare class KapsoWebhookController {
+    private webhookSecret;
+    private listener;
+    private logger;
+    constructor(webhookSecret: string | undefined, listener: IKapsoChannelMessageListener);
+    handleWebhook(req: IncomingMessage): Promise<void>;
+    private handleMessageReceived;
+    private verifySignature;
+    private getRawBody;
+}
+
+declare class KapsoReceiver {
+    private config;
+    private listener;
+    constructor(config: {
+        webhookSecret?: string;
+        webhookPath: string;
+    });
+    listenMessage(listener: IKapsoChannelMessageListener): void;
+    connect(): void;
+    disconnect(): void;
+}
+
+declare class KapsoSender implements IWhatsAppSender {
+    private apiKey;
+    private phoneNumberId;
+    private logger;
+    private baseUrl;
+    constructor(apiKey: string, phoneNumberId: string);
+    sendMessage(request: ISendWhatsAppMessageReq): Promise<void>;
+    sendTemplate(_request: ISendWhatsAppTemplateReq): Promise<void>;
+}
+
 interface IWasenderChannelConfig {
     apiKey?: string | ConfigReference<string>;
     webhookSecret?: string | ConfigReference<string>;
@@ -2504,4 +2648,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 ICmdReceivedMessage, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICronConfig, type ICronHandler, type ICronJobData, type ICronJobRepository, type ICrudRepository, type ICustomErrorData, 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 IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, 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 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, 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, 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, max, memExtension, middleware, min, mindset, mindsetModule, modelInfo, num, numArr, obj, onDelete, onGet, onPost, onPut, onSocketEvent, parseQueryMethodName, 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, 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 ICmdReceivedMessage, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICronConfig, type ICronHandler, type ICronJobData, type ICronJobRepository, type ICrudRepository, type ICustomErrorData, 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 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, 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, 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, validateAndTransform, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsRecord, validateIsString, validateMax, validateMin, validateModel, wasender, wasenderChannelName, withPgClient, withPgTransaction, writeJsonToFile };

package/dist/src/index.js

@@ -177,8 +177,16 @@ export { telegram } from './addon/chat-controller/telegram/@telegram.js';
 export { TelegramChannelConfig } from './addon/chat-controller/telegram/TelegramChannelConfig.js';
 export { TelegramChannel } from './addon/chat-controller/telegram/TelegramChannel.js';
 export { telegramChannelName } from './addon/chat-controller/telegram/telegramChannelName.js';
+export { markdownToTelegramHtml } from './addon/chat-controller/telegram/markdownToTelegramHtml.js';
 export { WhatsAppReceiverByCloudApi } from './addon/chat-controller/whatsapp/cloud-api/WhatsAppReceiverByCloudApi.js';
 export { WhatsAppApiSender } from './addon/chat-controller/whatsapp/cloud-api/WhatsAppApiSender.js';
+export { kapso } from './addon/chat-controller/whatsapp/kapso/@kapso.js';
+export { KapsoChannel } from './addon/chat-controller/whatsapp/kapso/KapsoChannel.js';
+export { KapsoChannelConfig } from './addon/chat-controller/whatsapp/kapso/KapsoChannelConfig.js';
+export { kapsoChannelName } from './addon/chat-controller/whatsapp/kapso/KapsoChannelName.js';
+export { KapsoReceiver } from './addon/chat-controller/whatsapp/kapso/KapsoReceiver.js';
+export { KapsoSender } from './addon/chat-controller/whatsapp/kapso/KapsoSender.js';
+export { KapsoWebhookController } from './addon/chat-controller/whatsapp/kapso/KapsoWebhookController.js';
 export { wasender } from './addon/chat-controller/whatsapp/wasender/@wasender.js';
 export { WasenderChannel } from './addon/chat-controller/whatsapp/wasender/WasenderChannel.js';
 export { WasenderChannelConfig } from './addon/chat-controller/whatsapp/wasender/WasenderChannelConfig.js';

package/package.json

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