@illuma-ai/agents 1.0.90 → 1.0.94

package/src/llm/openrouter/reasoning.test.js

@@ -0,0 +1,181 @@
+import { ChatOpenRouter } from './index';
+function createRouter(overrides = {}) {
+    return new ChatOpenRouter({
+        model: 'openrouter/test-model',
+        apiKey: 'test-key',
+        ...overrides,
+    });
+}
+describe('ChatOpenRouter reasoning handling', () => {
+    // ---------------------------------------------------------------
+    // 1. Constructor reasoning config
+    // ---------------------------------------------------------------
+    describe('constructor reasoning config', () => {
+        it('stores reasoning when passed directly', () => {
+            const router = createRouter({ reasoning: { effort: 'high' } });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ effort: 'high' });
+        });
+    });
+    // ---------------------------------------------------------------
+    // 2. modelKwargs reasoning extraction
+    // ---------------------------------------------------------------
+    describe('modelKwargs reasoning extraction', () => {
+        it('extracts reasoning from modelKwargs and places it into params.reasoning', () => {
+            const router = createRouter({
+                modelKwargs: { reasoning: { effort: 'medium' } },
+            });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ effort: 'medium' });
+        });
+        it('does not leak reasoning into modelKwargs that reach the parent', () => {
+            const router = createRouter({
+                modelKwargs: {
+                    reasoning: { effort: 'medium' },
+                },
+            });
+            const params = router.invocationParams();
+            // reasoning should be the structured OpenRouter object, not buried in modelKwargs
+            expect(params.reasoning).toEqual({ effort: 'medium' });
+        });
+    });
+    // ---------------------------------------------------------------
+    // 3. Reasoning merge precedence
+    // ---------------------------------------------------------------
+    describe('reasoning merge precedence', () => {
+        it('constructor reasoning overrides modelKwargs.reasoning', () => {
+            const router = createRouter({
+                reasoning: { effort: 'high' },
+                modelKwargs: { reasoning: { effort: 'low' } },
+            });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ effort: 'high' });
+        });
+        it('merges non-overlapping keys from modelKwargs.reasoning and constructor reasoning', () => {
+            const router = createRouter({
+                reasoning: { effort: 'high' },
+                modelKwargs: { reasoning: { max_tokens: 5000 } },
+            });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ effort: 'high', max_tokens: 5000 });
+        });
+    });
+    // ---------------------------------------------------------------
+    // 4. invocationParams output
+    // ---------------------------------------------------------------
+    describe('invocationParams output', () => {
+        it('includes reasoning object in params', () => {
+            const router = createRouter({ reasoning: { effort: 'high' } });
+            const params = router.invocationParams();
+            expect(params.reasoning).toBeDefined();
+            expect(params.reasoning).toEqual({ effort: 'high' });
+        });
+        it('does NOT include reasoning_effort in params', () => {
+            const router = createRouter({ reasoning: { effort: 'high' } });
+            const params = router.invocationParams();
+            expect(params.reasoning_effort).toBeUndefined();
+        });
+        it('does not include reasoning when none is configured', () => {
+            const router = createRouter();
+            const params = router.invocationParams();
+            expect(params.reasoning).toBeUndefined();
+            expect(params.reasoning_effort).toBeUndefined();
+        });
+    });
+    // ---------------------------------------------------------------
+    // 5. Legacy include_reasoning
+    // ---------------------------------------------------------------
+    describe('legacy include_reasoning', () => {
+        it('produces { enabled: true } when only include_reasoning is true', () => {
+            const router = createRouter({ include_reasoning: true });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ enabled: true });
+        });
+        it('does not produce reasoning when include_reasoning is false', () => {
+            const router = createRouter({ include_reasoning: false });
+            const params = router.invocationParams();
+            expect(params.reasoning).toBeUndefined();
+        });
+    });
+    // ---------------------------------------------------------------
+    // 6. Legacy include_reasoning ignored when reasoning is provided
+    // ---------------------------------------------------------------
+    describe('legacy include_reasoning ignored when reasoning provided', () => {
+        it('reasoning wins over include_reasoning', () => {
+            const router = createRouter({
+                reasoning: { effort: 'medium' },
+                include_reasoning: true,
+            });
+            const params = router.invocationParams();
+            // Should use the structured reasoning, NOT fall back to { enabled: true }
+            expect(params.reasoning).toEqual({ effort: 'medium' });
+        });
+        it('reasoning from modelKwargs also wins over include_reasoning', () => {
+            const router = createRouter({
+                modelKwargs: { reasoning: { effort: 'low' } },
+                include_reasoning: true,
+            });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ effort: 'low' });
+        });
+    });
+    // ---------------------------------------------------------------
+    // 7. Various effort levels (OpenRouter-specific)
+    // ---------------------------------------------------------------
+    describe('various effort levels', () => {
+        const efforts = [
+            { effort: 'xhigh' },
+            { effort: 'none' },
+            { effort: 'minimal' },
+            { effort: 'high' },
+            { effort: 'medium' },
+            { effort: 'low' },
+        ];
+        it.each(efforts)('supports effort level "$effort"', ({ effort }) => {
+            const router = createRouter({ reasoning: { effort } });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ effort });
+            expect(params.reasoning_effort).toBeUndefined();
+        });
+    });
+    // ---------------------------------------------------------------
+    // 8. max_tokens reasoning
+    // ---------------------------------------------------------------
+    describe('max_tokens reasoning', () => {
+        it('passes max_tokens in reasoning object', () => {
+            const router = createRouter({
+                reasoning: { max_tokens: 8000 },
+            });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ max_tokens: 8000 });
+        });
+        it('combines max_tokens with effort', () => {
+            const router = createRouter({
+                reasoning: { effort: 'high', max_tokens: 8000 },
+            });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ effort: 'high', max_tokens: 8000 });
+            expect(params.reasoning_effort).toBeUndefined();
+        });
+    });
+    // ---------------------------------------------------------------
+    // 9. exclude reasoning
+    // ---------------------------------------------------------------
+    describe('exclude reasoning', () => {
+        it('passes exclude flag in reasoning object', () => {
+            const router = createRouter({
+                reasoning: { effort: 'high', exclude: true },
+            });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ effort: 'high', exclude: true });
+        });
+        it('supports exclude without effort', () => {
+            const router = createRouter({
+                reasoning: { exclude: true },
+            });
+            const params = router.invocationParams();
+            expect(params.reasoning).toEqual({ exclude: true });
+        });
+    });
+});
+//# sourceMappingURL=reasoning.test.js.map

package/src/llm/openrouter/reasoning.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.test.js","sourceRoot":"","sources":["reasoning.test.ts"],"names":[],"mappings":"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"}

package/src/llm/openrouter/reasoning.test.ts

@@ -0,0 +1,207 @@
+import { ChatOpenRouter } from './index';
+import type { OpenRouterReasoning, ChatOpenRouterCallOptions } from './index';
+import type { OpenAIChatInput } from '@langchain/openai';
+
+type CreateRouterOptions = Partial<
+  ChatOpenRouterCallOptions & Pick<OpenAIChatInput, 'model' | 'apiKey'>
+>;
+
+function createRouter(overrides: CreateRouterOptions = {}): ChatOpenRouter {
+  return new ChatOpenRouter({
+    model: 'openrouter/test-model',
+    apiKey: 'test-key',
+    ...overrides,
+  });
+}
+
+describe('ChatOpenRouter reasoning handling', () => {
+  // ---------------------------------------------------------------
+  // 1. Constructor reasoning config
+  // ---------------------------------------------------------------
+  describe('constructor reasoning config', () => {
+    it('stores reasoning when passed directly', () => {
+      const router = createRouter({ reasoning: { effort: 'high' } });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ effort: 'high' });
+    });
+  });
+
+  // ---------------------------------------------------------------
+  // 2. modelKwargs reasoning extraction
+  // ---------------------------------------------------------------
+  describe('modelKwargs reasoning extraction', () => {
+    it('extracts reasoning from modelKwargs and places it into params.reasoning', () => {
+      const router = createRouter({
+        modelKwargs: { reasoning: { effort: 'medium' } },
+      });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ effort: 'medium' });
+    });
+
+    it('does not leak reasoning into modelKwargs that reach the parent', () => {
+      const router = createRouter({
+        modelKwargs: {
+          reasoning: { effort: 'medium' },
+        },
+      });
+      const params = router.invocationParams();
+      // reasoning should be the structured OpenRouter object, not buried in modelKwargs
+      expect(params.reasoning).toEqual({ effort: 'medium' });
+    });
+  });
+
+  // ---------------------------------------------------------------
+  // 3. Reasoning merge precedence
+  // ---------------------------------------------------------------
+  describe('reasoning merge precedence', () => {
+    it('constructor reasoning overrides modelKwargs.reasoning', () => {
+      const router = createRouter({
+        reasoning: { effort: 'high' },
+        modelKwargs: { reasoning: { effort: 'low' } },
+      });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ effort: 'high' });
+    });
+
+    it('merges non-overlapping keys from modelKwargs.reasoning and constructor reasoning', () => {
+      const router = createRouter({
+        reasoning: { effort: 'high' },
+        modelKwargs: { reasoning: { max_tokens: 5000 } },
+      });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ effort: 'high', max_tokens: 5000 });
+    });
+  });
+
+  // ---------------------------------------------------------------
+  // 4. invocationParams output
+  // ---------------------------------------------------------------
+  describe('invocationParams output', () => {
+    it('includes reasoning object in params', () => {
+      const router = createRouter({ reasoning: { effort: 'high' } });
+      const params = router.invocationParams();
+      expect(params.reasoning).toBeDefined();
+      expect(params.reasoning).toEqual({ effort: 'high' });
+    });
+
+    it('does NOT include reasoning_effort in params', () => {
+      const router = createRouter({ reasoning: { effort: 'high' } });
+      const params = router.invocationParams();
+      expect(params.reasoning_effort).toBeUndefined();
+    });
+
+    it('does not include reasoning when none is configured', () => {
+      const router = createRouter();
+      const params = router.invocationParams();
+      expect(params.reasoning).toBeUndefined();
+      expect(params.reasoning_effort).toBeUndefined();
+    });
+  });
+
+  // ---------------------------------------------------------------
+  // 5. Legacy include_reasoning
+  // ---------------------------------------------------------------
+  describe('legacy include_reasoning', () => {
+    it('produces { enabled: true } when only include_reasoning is true', () => {
+      const router = createRouter({ include_reasoning: true });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ enabled: true });
+    });
+
+    it('does not produce reasoning when include_reasoning is false', () => {
+      const router = createRouter({ include_reasoning: false });
+      const params = router.invocationParams();
+      expect(params.reasoning).toBeUndefined();
+    });
+  });
+
+  // ---------------------------------------------------------------
+  // 6. Legacy include_reasoning ignored when reasoning is provided
+  // ---------------------------------------------------------------
+  describe('legacy include_reasoning ignored when reasoning provided', () => {
+    it('reasoning wins over include_reasoning', () => {
+      const router = createRouter({
+        reasoning: { effort: 'medium' },
+        include_reasoning: true,
+      });
+      const params = router.invocationParams();
+      // Should use the structured reasoning, NOT fall back to { enabled: true }
+      expect(params.reasoning).toEqual({ effort: 'medium' });
+    });
+
+    it('reasoning from modelKwargs also wins over include_reasoning', () => {
+      const router = createRouter({
+        modelKwargs: { reasoning: { effort: 'low' } },
+        include_reasoning: true,
+      });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ effort: 'low' });
+    });
+  });
+
+  // ---------------------------------------------------------------
+  // 7. Various effort levels (OpenRouter-specific)
+  // ---------------------------------------------------------------
+  describe('various effort levels', () => {
+    const efforts: Array<{
+      effort: OpenRouterReasoning['effort'];
+    }> = [
+      { effort: 'xhigh' },
+      { effort: 'none' },
+      { effort: 'minimal' },
+      { effort: 'high' },
+      { effort: 'medium' },
+      { effort: 'low' },
+    ];
+
+    it.each(efforts)('supports effort level "$effort"', ({ effort }) => {
+      const router = createRouter({ reasoning: { effort } });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ effort });
+      expect(params.reasoning_effort).toBeUndefined();
+    });
+  });
+
+  // ---------------------------------------------------------------
+  // 8. max_tokens reasoning
+  // ---------------------------------------------------------------
+  describe('max_tokens reasoning', () => {
+    it('passes max_tokens in reasoning object', () => {
+      const router = createRouter({
+        reasoning: { max_tokens: 8000 },
+      });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ max_tokens: 8000 });
+    });
+
+    it('combines max_tokens with effort', () => {
+      const router = createRouter({
+        reasoning: { effort: 'high', max_tokens: 8000 },
+      });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ effort: 'high', max_tokens: 8000 });
+      expect(params.reasoning_effort).toBeUndefined();
+    });
+  });
+
+  // ---------------------------------------------------------------
+  // 9. exclude reasoning
+  // ---------------------------------------------------------------
+  describe('exclude reasoning', () => {
+    it('passes exclude flag in reasoning object', () => {
+      const router = createRouter({
+        reasoning: { effort: 'high', exclude: true },
+      });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ effort: 'high', exclude: true });
+    });
+
+    it('supports exclude without effort', () => {
+      const router = createRouter({
+        reasoning: { exclude: true },
+      });
+      const params = router.invocationParams();
+      expect(params.reasoning).toEqual({ exclude: true });
+    });
+  });
+});

package/src/llm/providers.js

@@ -0,0 +1,36 @@
+// src/llm/providers.ts
+import { ChatMistralAI } from '@langchain/mistralai';
+import { AzureChatOpenAI, ChatDeepSeek, ChatMoonshot, ChatOpenAI, ChatXAI, } from '@/llm/openai';
+import { CustomChatGoogleGenerativeAI } from '@/llm/google';
+import { CustomChatBedrockConverse } from '@/llm/bedrock';
+import { CustomAnthropic } from '@/llm/anthropic';
+import { ChatOpenRouter } from '@/llm/openrouter';
+import { ChatVertexAI } from '@/llm/vertexai';
+import { Providers } from '@/common';
+export const llmProviders = {
+    [Providers.XAI]: ChatXAI,
+    [Providers.OPENAI]: ChatOpenAI,
+    [Providers.AZURE]: AzureChatOpenAI,
+    [Providers.VERTEXAI]: ChatVertexAI,
+    [Providers.DEEPSEEK]: ChatDeepSeek,
+    [Providers.MISTRALAI]: ChatMistralAI,
+    [Providers.MISTRAL]: ChatMistralAI,
+    [Providers.ANTHROPIC]: CustomAnthropic,
+    [Providers.OPENROUTER]: ChatOpenRouter,
+    [Providers.BEDROCK]: CustomChatBedrockConverse,
+    // [Providers.ANTHROPIC]: ChatAnthropic,
+    [Providers.GOOGLE]: CustomChatGoogleGenerativeAI,
+    [Providers.MOONSHOT]: ChatMoonshot,
+};
+export const manualToolStreamProviders = new Set([
+    Providers.ANTHROPIC,
+    Providers.BEDROCK,
+]);
+export const getChatModelClass = (provider) => {
+    const ChatModelClass = llmProviders[provider];
+    if (!ChatModelClass) {
+        throw new Error(`Unsupported LLM provider: ${provider}`);
+    }
+    return ChatModelClass;
+};
+//# sourceMappingURL=providers.js.map

package/src/llm/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["providers.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMrD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC5D,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO;IACxB,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU;IAC9B,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,eAAe;IAClC,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,YAAY;IAClC,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,YAAY;IAClC,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,aAAa;IACpC,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa;IAClC,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,eAAe;IACtC,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,cAAc;IACtC,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,yBAAyB;IAC9C,wCAAwC;IACxC,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,4BAA4B;IAChD,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,YAAY;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAqB;IACnE,SAAS,CAAC,SAAS;IACnB,SAAS,CAAC,OAAO;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,QAAW,EAC6C,EAAE;IAC1D,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC"}

package/src/llm/text.js

@@ -0,0 +1,65 @@
+export class TextStream {
+    text;
+    currentIndex;
+    minChunkSize;
+    maxChunkSize;
+    delay;
+    firstWordChunk;
+    constructor(text, options = {}) {
+        this.text = text;
+        this.currentIndex = 0;
+        this.minChunkSize = options.minChunkSize ?? 4;
+        this.maxChunkSize = options.maxChunkSize ?? 8;
+        this.delay = options.delay ?? 20;
+        this.firstWordChunk = options.firstWordChunk ?? true;
+    }
+    randomInt(min, max) {
+        return Math.floor(Math.random() * (max - min)) + min;
+    }
+    static BOUNDARIES = new Set([
+        ' ',
+        '.',
+        ',',
+        '!',
+        '?',
+        ';',
+        ':',
+    ]);
+    findFirstWordBoundary(text, minSize) {
+        if (minSize >= text.length)
+            return text.length;
+        // Ensure we meet the minimum size first
+        let pos = minSize;
+        // Look forward until we find a boundary
+        while (pos < text.length) {
+            if (TextStream.BOUNDARIES.has(text[pos])) {
+                return pos + 1; // Include the boundary character
+            }
+            pos++;
+        }
+        return text.length; // If no boundary found, return entire remaining text
+    }
+    async *generateText(signal, progressCallback) {
+        const { delay, minChunkSize, maxChunkSize } = this;
+        while (this.currentIndex < this.text.length) {
+            if (signal?.aborted === true) {
+                break;
+            }
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            const remainingText = this.text.slice(this.currentIndex);
+            let chunkSize;
+            if (this.firstWordChunk) {
+                chunkSize = this.findFirstWordBoundary(remainingText, minChunkSize);
+            }
+            else {
+                const remainingChars = remainingText.length;
+                chunkSize = Math.min(this.randomInt(minChunkSize, maxChunkSize + 1), remainingChars);
+            }
+            const chunk = this.text.slice(this.currentIndex, this.currentIndex + chunkSize);
+            progressCallback?.(chunk);
+            yield chunk;
+            this.currentIndex += chunkSize;
+        }
+    }
+}
+//# sourceMappingURL=text.js.map

package/src/llm/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["text.ts"],"names":[],"mappings":"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"}