@wabot-dev/framework 0.8.2 → 0.9.0

package/dist/src/addon/async/pg/PgCronJobRepository.js

@@ -7,6 +7,8 @@ import 'debug';
 import 'node:crypto';
 import '../../../feature/pg/withPgClient.js';
 import '../../../feature/pg/pgStorage.js';
+import '../../../feature/pg/query/PgJsonRepository.js';
+import '../../../feature/pg/query/PgRepositoryMetadataStore.js';
 import { Pool } from 'pg';
 
 let PgCronJobRepository = class PgCronJobRepository extends PgCrudRepository {

package/dist/src/addon/async/pg/PgJobRepository.js

@@ -7,6 +7,8 @@ import 'debug';
 import 'node:crypto';
 import { withPgClient } from '../../../feature/pg/withPgClient.js';
 import '../../../feature/pg/pgStorage.js';
+import '../../../feature/pg/query/PgJsonRepository.js';
+import '../../../feature/pg/query/PgRepositoryMetadataStore.js';
 import '../../../feature/async/AsyncMetadataStore.js';
 import '../../../feature/async/Async.js';
 import '../../../_virtual/index.js';

package/dist/src/addon/auth/api-key/@apiKeyGuard.js

@@ -6,8 +6,8 @@ import 'debug';
 import '../../../core/validation/metadata/ValidationMetadataStore.js';
 import '../../../feature/express/ExpressProvider.js';
 import 'express';
-import 'path';
-import 'http';
+import 'node:path';
+import 'node:http';
 import { ApiKeyGuardMiddleware } from './ApiKeyGuardMiddleware.js';
 
 function apiKeyGuard() {

package/dist/src/addon/auth/api-key/PgApiKeyRepository.js

@@ -6,10 +6,12 @@ import { CustomError } from '../../../core/error/CustomError.js';
 import 'node:crypto';
 import '../../../feature/pg/withPgClient.js';
 import '../../../feature/pg/pgStorage.js';
+import { singleton } from '../../../core/injection/index.js';
+import '../../../feature/pg/query/PgJsonRepository.js';
+import '../../../feature/pg/query/PgRepositoryMetadataStore.js';
 import { Pool } from 'pg';
 import { ApiKey } from './ApiKey.js';
 import '../../../core/error/setupErrorHandlers.js';
-import { singleton } from '../../../core/injection/index.js';
 
 let PgApiKeyRepository = class PgApiKeyRepository extends PgCrudRepository {
     constructor(pool) {

package/dist/src/addon/auth/jwt/@jwtGuard.js

@@ -6,8 +6,8 @@ import 'debug';
 import '../../../core/validation/metadata/ValidationMetadataStore.js';
 import '../../../feature/express/ExpressProvider.js';
 import 'express';
-import 'path';
-import 'http';
+import 'node:path';
+import 'node:http';
 import { JwtGuardMiddleware } from './JwtGuardMiddleware.js';
 
 function jwtGuard() {

package/dist/src/addon/auth/jwt/PgJwtRefreshTokenRepository.js

@@ -8,6 +8,8 @@ import 'debug';
 import 'node:crypto';
 import '../../../feature/pg/withPgClient.js';
 import '../../../feature/pg/pgStorage.js';
+import '../../../feature/pg/query/PgJsonRepository.js';
+import '../../../feature/pg/query/PgRepositoryMetadataStore.js';
 import { Pool } from 'pg';
 import { JwtRefreshToken } from './JwtRefreshToken.js';
 

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

@@ -2,13 +2,18 @@ import { __decorate, __metadata } from 'tslib';
 import { Env } from '../../../core/env/Env.js';
 import { singleton } from '../../../core/injection/index.js';
 import { Logger } from '../../../core/logger/Logger.js';
+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 { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.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';
 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 { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { Anthropic } from '@anthropic-ai/sdk';
 
 const ANTHROPIC_SUPPORTED_IMAGE_MIME_TYPES = [
@@ -30,16 +35,28 @@ let AnthropicChatAdapter = class AnthropicChatAdapter {
     async nextItems(req) {
         const tools = req.tools.map((x) => this.mapTool(x));
         const messages = this.mapChatItems(req.prevItems);
-        const request = {
-            model: req.model,
-            max_tokens: 4096,
-            system: req.systemPrompt,
-            messages,
-            tools: tools.length > 0 ? tools : undefined,
-        };
-        this.logger.debug(`Call Claude API with model: ${request.model}, messages: ${request.messages.length}, tools: ${request.tools?.length ?? 0}`);
-        const response = await this.anthropic.messages.create(request);
-        return this.mapResponse(response);
+        let lastError;
+        for (const ref of req.models) {
+            const request = {
+                model: ref.model,
+                max_tokens: 4096,
+                system: req.systemPrompt,
+                messages,
+                tools: tools.length > 0 ? tools : undefined,
+            };
+            this.logger.debug(`Call Claude API with model: ${request.model}, messages: ${request.messages.length}, tools: ${request.tools?.length ?? 0}`);
+            try {
+                const response = await this.anthropic.messages.create(request);
+                return this.mapResponse(response, ref.model);
+            }
+            catch (err) {
+                if (!isRetryableError(err))
+                    throw err;
+                this.logger.warn(`Anthropic model '${ref.model}' failed with retryable error, trying next`, err instanceof Error ? { message: err.message } : { err });
+                lastError = err;
+            }
+        }
+        throw lastError ?? new Error('No Anthropic model could handle the request');
     }
     mapChatItems(chatItems) {
         const messages = [];
@@ -158,12 +175,18 @@ let AnthropicChatAdapter = class AnthropicChatAdapter {
             },
         };
     }
-    mapResponse(response) {
+    mapResponse(response, modelName) {
         let usage;
         if (response.usage) {
+            const cacheRead = response.usage.cache_read_input_tokens ?? 0;
+            const cacheWrite = response.usage.cache_creation_input_tokens ?? 0;
             usage = {
-                inputTokens: response.usage.input_tokens,
+                inputTokens: response.usage.input_tokens + cacheRead + cacheWrite,
                 outputTokens: response.usage.output_tokens,
+                cacheReadTokens: cacheRead || undefined,
+                cacheWriteTokens: cacheWrite || undefined,
+                provider: 'anthropic',
+                model: response.model ?? modelName,
             };
         }
         else {
@@ -189,6 +212,7 @@ let AnthropicChatAdapter = class AnthropicChatAdapter {
     }
 };
 AnthropicChatAdapter = __decorate([
+    chatAdapter({ provider: 'anthropic' }),
     singleton(),
     __metadata("design:paramtypes", [Env])
 ], AnthropicChatAdapter);

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

@@ -1,15 +1,21 @@
+import { __decorate, __metadata } from 'tslib';
+import { singleton } from '../../../core/injection/index.js';
 import { Logger } from '../../../core/logger/Logger.js';
+import '../../../feature/chat-bot/ChatAdapterRegistry.js';
 import '../../../feature/chat-bot/ChatBot.js';
 import '../../../feature/chat-bot/ChatOperator.js';
-import '../../../core/injection/index.js';
+import '../../../feature/chat-bot/UnionChatAdapter.js';
+import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.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';
 import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
+import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';
-import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { OpenAI } from 'openai';
 
-class DeepSeekChatAdapter {
+let DeepSeekChatAdapter = class DeepSeekChatAdapter {
     deepSeek;
     logger = new Logger('wabot:deepseek-chat-adapter');
     constructor() {
@@ -31,13 +37,25 @@ class DeepSeekChatAdapter {
         deepSeekInput.push({ role: 'system', content: req.systemPrompt });
         deepSeekInput.push(...this.mapChatItems(req.prevItems));
         const tools = req.tools.map((x) => this.mapTool(x));
-        const response = await this.deepSeek.chat.completions.create({
-            model: req.model,
-            messages: deepSeekInput,
-            tools,
-            tool_choice: 'auto',
-        });
-        return this.mapResponse(response);
+        let lastError;
+        for (const ref of req.models) {
+            try {
+                const response = await this.deepSeek.chat.completions.create({
+                    model: ref.model,
+                    messages: deepSeekInput,
+                    tools,
+                    tool_choice: 'auto',
+                });
+                return this.mapResponse(response, ref.model);
+            }
+            catch (err) {
+                if (!isRetryableError(err))
+                    throw err;
+                this.logger.warn(`DeepSeek model '${ref.model}' failed with retryable error, trying next`, err instanceof Error ? { message: err.message } : { err });
+                lastError = err;
+            }
+        }
+        throw lastError ?? new Error('No DeepSeek model could handle the request');
     }
     mapChatItems(chatItems) {
         const deepSeekInput = [];
@@ -115,7 +133,7 @@ class DeepSeekChatAdapter {
             },
         };
     }
-    mapResponse(response) {
+    mapResponse(response, modelName) {
         let chatItem;
         const { tool_calls: responseFunctionCall, content: responseText } = response.choices?.[0]?.message ?? {};
         if (responseText) {
@@ -136,9 +154,15 @@ class DeepSeekChatAdapter {
         }
         let usage;
         if (response.usage) {
+            // DeepSeek exposes prompt_cache_hit_tokens (not in OpenAI SDK types)
+            const cacheRead = response.usage
+                .prompt_cache_hit_tokens ?? 0;
             usage = {
                 inputTokens: response.usage.prompt_tokens,
                 outputTokens: response.usage.completion_tokens,
+                cacheReadTokens: cacheRead || undefined,
+                provider: 'deepseek',
+                model: response.model ?? modelName,
             };
         }
         else {
@@ -146,6 +170,11 @@ class DeepSeekChatAdapter {
         }
         return { nextItems: [chatItem], usage };
     }
-}
+};
+DeepSeekChatAdapter = __decorate([
+    chatAdapter({ provider: 'deepseek' }),
+    singleton(),
+    __metadata("design:paramtypes", [])
+], DeepSeekChatAdapter);
 
 export { DeepSeekChatAdapter };

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

@@ -3,13 +3,18 @@ import { Env } from '../../../core/env/Env.js';
 import { singleton } from '../../../core/injection/index.js';
 import { Logger } from '../../../core/logger/Logger.js';
 import { Random } from '../../../core/random/Random.js';
+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 { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.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';
 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 { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { GoogleGenAI } from '@google/genai';
 
 const GOOGLE_SUPPORTED_IMAGE_MIME_TYPES = [
@@ -38,21 +43,37 @@ let GoogleChatAdapter = class GoogleChatAdapter {
     async nextItems(req) {
         const contents = [];
         contents.push({ role: 'user', parts: [{ text: req.systemPrompt }] });
-        contents.push(...this.mapChatItems(req.prevItems));
+        contents.push(...(await this.mapChatItems(req.prevItems)));
         const functionDeclarations = req.tools.map((x) => this.mapTool(x));
-        const response = await this.ai.models.generateContent({
-            model: req.model,
-            contents,
-            config: { tools: [{ functionDeclarations }] },
-        });
-        return this.mapResponse(response);
+        const hasUnsignedFunctionCall = req.prevItems.some((item) => item.type === 'functionCall' && !item.functionCall.signature);
+        let lastError;
+        for (const ref of req.models) {
+            try {
+                const response = await this.ai.models.generateContent({
+                    model: ref.model,
+                    contents,
+                    config: {
+                        tools: [{ functionDeclarations }],
+                        ...(hasUnsignedFunctionCall ? { thinkingConfig: { thinkingBudget: 0 } } : {}),
+                    },
+                });
+                return this.mapResponse(response, ref.model);
+            }
+            catch (err) {
+                if (!isRetryableError(err))
+                    throw err;
+                this.logger.warn(`Google model '${ref.model}' failed with retryable error, trying next`, err instanceof Error ? { message: err.message } : { err });
+                lastError = err;
+            }
+        }
+        throw lastError ?? new Error('No Google model could handle the request');
     }
-    mapChatItems(chatItems) {
+    async mapChatItems(chatItems) {
         const contents = [];
         for (const chatItem of chatItems) {
             switch (chatItem.type) {
                 case 'humanMessage':
-                    contents.push(this.mapHumanMessage(chatItem.humanMessage));
+                    contents.push(await this.mapHumanMessage(chatItem.humanMessage));
                     break;
                 case 'botMessage':
                     contents.push(this.mapBotMessage(chatItem.botMessage));
@@ -64,7 +85,7 @@ let GoogleChatAdapter = class GoogleChatAdapter {
         }
         return contents;
     }
-    mapHumanMessage(item) {
+    async mapHumanMessage(item) {
         if (isChatMessageEmpty(item)) {
             throw new Error('User message content is empty');
         }
@@ -75,25 +96,32 @@ let GoogleChatAdapter = class GoogleChatAdapter {
                 supportedDocumentMimeTypes: GOOGLE_SUPPORTED_DOCUMENT_MIME_TYPES,
             }),
         });
+        const filesToSend = [];
         if (item.images) {
             for (const image of item.images) {
                 if (!GOOGLE_SUPPORTED_IMAGE_MIME_TYPES.includes(image.mimeType))
                     continue;
-                parts.push(this.toGoogleFilePart(image));
+                filesToSend.push(image);
             }
         }
         if (item.documents) {
             for (const doc of item.documents) {
                 if (!GOOGLE_SUPPORTED_DOCUMENT_MIME_TYPES.includes(doc.mimeType))
                     continue;
-                parts.push(this.toGoogleFilePart(doc));
+                filesToSend.push(doc);
             }
         }
+        const fileParts = await Promise.all(filesToSend.map((f) => this.toGoogleFilePart(f)));
+        parts.push(...fileParts);
         return { role: 'user', parts };
     }
-    toGoogleFilePart(file) {
+    async toGoogleFilePart(file) {
         if (file.publicUrl) {
-            return { fileData: { fileUri: file.publicUrl, mimeType: file.mimeType } };
+            if (isGoogleNativeFileUri(file.publicUrl)) {
+                return { fileData: { fileUri: file.publicUrl, mimeType: file.mimeType } };
+            }
+            const data = await fetchAsBase64(file.publicUrl);
+            return { inlineData: { data, mimeType: file.mimeType } };
         }
         return {
             inlineData: { data: stripDataUrlPrefix(file.base64Url), mimeType: file.mimeType },
@@ -106,18 +134,20 @@ let GoogleChatAdapter = class GoogleChatAdapter {
         return { role: 'model', parts: [{ text: extractChatMessageText(item) }] };
     }
     mapFunctionCall(item) {
+        const callPart = {
+            functionCall: {
+                id: item.id,
+                name: item.name,
+                args: safeJsonParse(item.arguments, 'function call arguments'),
+            },
+        };
+        if (item.signature) {
+            callPart.thoughtSignature = item.signature;
+        }
         return [
             {
                 role: 'model',
-                parts: [
-                    {
-                        functionCall: {
-                            id: item.id,
-                            name: item.name,
-                            args: safeJsonParse(item.arguments, 'function call arguments'),
-                        },
-                    },
-                ],
+                parts: [callPart],
             },
             {
                 role: 'function',
@@ -148,7 +178,7 @@ let GoogleChatAdapter = class GoogleChatAdapter {
             },
         };
     }
-    mapResponse(response) {
+    mapResponse(response, modelName) {
         if (!response.candidates || !response.candidates.length) {
             throw new Error('No candidates in response');
         }
@@ -177,18 +207,24 @@ let GoogleChatAdapter = class GoogleChatAdapter {
                         id: id ?? Random.alphaNumericLowerCase(10),
                         name,
                         arguments: args && JSON.stringify(args),
+                        signature: part.thoughtSignature,
                     },
                 });
             }
         }
+        const cachedTokens = response.usageMetadata.cachedContentTokenCount ?? 0;
         let usage = {
             inputTokens: response.usageMetadata.promptTokenCount,
             outputTokens: response.usageMetadata.candidatesTokenCount,
+            cacheReadTokens: cachedTokens || undefined,
+            provider: 'google',
+            model: response.modelVersion ?? modelName,
         };
         return { usage, nextItems };
     }
 };
 GoogleChatAdapter = __decorate([
+    chatAdapter({ provider: 'google' }),
     singleton(),
     __metadata("design:paramtypes", [Env])
 ], GoogleChatAdapter);
@@ -196,5 +232,20 @@ function stripDataUrlPrefix(dataUrl) {
     const commaIndex = dataUrl.indexOf(',');
     return commaIndex >= 0 && dataUrl.startsWith('data:') ? dataUrl.slice(commaIndex + 1) : dataUrl;
 }
+function isGoogleNativeFileUri(url) {
+    if (url.startsWith('gs://'))
+        return true;
+    if (url.startsWith('https://generativelanguage.googleapis.com/'))
+        return true;
+    return false;
+}
+async function fetchAsBase64(url) {
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Failed to fetch '${url}': ${res.status} ${res.statusText}`);
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    return buf.toString('base64');
+}
 
 export { GoogleChatAdapter };

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

@@ -1,12 +1,17 @@
 import { __decorate } from 'tslib';
+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 { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.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';
 import { singleton } from '../../../core/injection/index.js';
 import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
+import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';
-import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { Logger } from '../../../core/logger/Logger.js';
 import { OpenAI } from 'openai';
 
@@ -25,12 +30,24 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
         openIaInput.push({ role: 'system', content: req.systemPrompt });
         openIaInput.push(...this.mapChatItems(req.prevItems));
         const tools = req.tools.map((x) => this.mapTool(x));
-        const response = await this.openai.responses.create({
-            model: req.model,
-            input: openIaInput,
-            tools,
-        });
-        return this.mapResponse(response);
+        let lastError;
+        for (const ref of req.models) {
+            try {
+                const response = await this.openai.responses.create({
+                    model: ref.model,
+                    input: openIaInput,
+                    tools,
+                });
+                return this.mapResponse(response, ref.model);
+            }
+            catch (err) {
+                if (!isRetryableError(err))
+                    throw err;
+                this.logger.warn(`OpenAI model '${ref.model}' failed with retryable error, trying next`, err instanceof Error ? { message: err.message } : { err });
+                lastError = err;
+            }
+        }
+        throw lastError ?? new Error('No OpenAI model could handle the request');
     }
     mapChatItems(chatItems) {
         const openIaInput = [];
@@ -128,12 +145,16 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
             strict: true,
         };
     }
-    mapResponse(response) {
+    mapResponse(response, modelName) {
         let usage;
         if (response.usage) {
+            const cacheRead = response.usage.input_tokens_details?.cached_tokens ?? 0;
             usage = {
                 inputTokens: response.usage.input_tokens,
                 outputTokens: response.usage.output_tokens,
+                cacheReadTokens: cacheRead || undefined,
+                provider: 'openai',
+                model: response.model ?? modelName,
             };
         }
         else {
@@ -184,6 +205,7 @@ let OpenaiChatAdapter = class OpenaiChatAdapter {
     }
 };
 OpenaiChatAdapter = __decorate([
+    chatAdapter({ provider: 'openai' }),
     singleton()
 ], OpenaiChatAdapter);
 

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

@@ -2,13 +2,17 @@ import { __decorate, __metadata } from 'tslib';
 import { Env } from '../../../core/env/Env.js';
 import { singleton } from '../../../core/injection/index.js';
 import { Logger } from '../../../core/logger/Logger.js';
+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 { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
+import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
+import { chatAdapter } from '../../../feature/chat-bot/metadata/@chatAdapter.js';
 import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
+import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';
-import { extractChatMessageText } from '../../../feature/chat-bot/extractChatMessageText.js';
-import { isChatMessageEmpty } from '../../../feature/chat-bot/isChatMessageEmpty.js';
 import { OpenRouter } from '@openrouter/sdk';
 
 const OPENROUTER_SUPPORTED_IMAGE_MIME_TYPES = [
@@ -32,10 +36,13 @@ let OpenRouterChatAdapter = class OpenRouterChatAdapter {
         messages.push({ role: 'system', content: req.systemPrompt });
         messages.push(...this.mapChatItems(req.prevItems));
         const tools = req.tools.map((x) => this.mapTool(x));
-        this.logger.debug(`Call OpenRouter with model: ${req.model}, messages: ${messages.length}, tools: ${tools.length}`);
+        const modelNames = req.models.map((m) => m.model);
+        const [primary, ...fallbacks] = modelNames;
+        this.logger.debug(`Call OpenRouter with model: ${primary}, fallbacks: ${fallbacks.length}, messages: ${messages.length}, tools: ${tools.length}`);
         const response = await this.openRouter.chat.send({
             chatRequest: {
-                model: req.model,
+                model: primary,
+                models: fallbacks.length > 0 ? fallbacks : undefined,
                 messages,
                 tools: tools.length > 0 ? tools : undefined,
             },
@@ -160,9 +167,20 @@ let OpenRouterChatAdapter = class OpenRouterChatAdapter {
         }
         let usage;
         if (response.usage) {
+            const cacheRead = response.usage.promptTokensDetails?.cachedTokens ?? 0;
+            const cacheWrite = response.usage.promptTokensDetails?.cacheWriteTokens ?? 0;
+            // OpenRouter exposes `cost` (and provider) on the response but the SDK
+            // types haven't surfaced them yet — read via cast.
+            const costUsd = response.usage.cost;
+            const upstreamProvider = response.provider;
             usage = {
                 inputTokens: response.usage.promptTokens,
                 outputTokens: response.usage.completionTokens,
+                cacheReadTokens: cacheRead || undefined,
+                cacheWriteTokens: cacheWrite || undefined,
+                costUsd: typeof costUsd === 'number' ? costUsd : undefined,
+                provider: upstreamProvider ? `openrouter/${upstreamProvider}` : 'openrouter',
+                model: response.model,
             };
         }
         else {
@@ -172,6 +190,7 @@ let OpenRouterChatAdapter = class OpenRouterChatAdapter {
     }
 };
 OpenRouterChatAdapter = __decorate([
+    chatAdapter({ provider: 'openrouter' }),
     singleton(),
     __metadata("design:paramtypes", [Env])
 ], OpenRouterChatAdapter);

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

@@ -4,10 +4,15 @@ import 'debug';
 import 'node:crypto';
 import '../../../feature/pg/withPgClient.js';
 import '../../../feature/pg/pgStorage.js';
+import '../../../core/injection/index.js';
+import '../../../feature/pg/query/PgJsonRepository.js';
+import '../../../feature/pg/query/PgRepositoryMetadataStore.js';
+import '../../../feature/chat-bot/ChatAdapterRegistry.js';
 import '../../../feature/chat-bot/ChatBot.js';
 import { ChatItem } from '../../../feature/chat-bot/ChatItem.js';
 import '../../../feature/chat-bot/ChatOperator.js';
-import '../../../core/injection/index.js';
+import '../../../feature/chat-bot/UnionChatAdapter.js';
+import '../../../feature/chat-bot/metadata/ChatAdapterMetadataStore.js';
 import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';

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

@@ -8,9 +8,14 @@ import 'debug';
 import 'node:crypto';
 import '../../../feature/pg/withPgClient.js';
 import '../../../feature/pg/pgStorage.js';
+import '../../../feature/pg/query/PgJsonRepository.js';
+import '../../../feature/pg/query/PgRepositoryMetadataStore.js';
 import { Chat } from '../../../feature/chat-bot/Chat.js';
+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/metadata/ChatAdapterMetadataStore.js';
 import 'uuid';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';

package/dist/src/addon/chat-bot/ram/RamChatRepository.js

@@ -2,8 +2,11 @@ import { __decorate } from 'tslib';
 import { v4 } from 'uuid';
 import { RamChatMemory } from './RamChatMemory.js';
 import { singleton } from '../../../core/injection/index.js';
+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/metadata/ChatAdapterMetadataStore.js';
 import '../../../feature/chat-bot/metadata/ChatBotMetadataStore.js';
 import '../../../core/error/setupErrorHandlers.js';