@office-ai/aioncli-core 0.2.3 → 0.18.4

package/dist/src/routing/strategies/classifierStrategy.js

@@ -0,0 +1,166 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import { promptIdContext } from '../../utils/promptIdContext.js';
+import { GEMINI_MODEL_ALIAS_FLASH, GEMINI_MODEL_ALIAS_PRO, resolveModel, } from '../../config/models.js';
+import { createUserContent, Type } from '@google/genai';
+import { isFunctionCall, isFunctionResponse, } from '../../utils/messageInspectors.js';
+import { debugLogger } from '../../utils/debugLogger.js';
+// The number of recent history turns to provide to the router for context.
+const HISTORY_TURNS_FOR_CONTEXT = 4;
+const HISTORY_SEARCH_WINDOW = 20;
+const FLASH_MODEL = 'flash';
+const PRO_MODEL = 'pro';
+const CLASSIFIER_SYSTEM_PROMPT = `
+You are a specialized Task Routing AI. Your sole function is to analyze the user's request and classify its complexity. Choose between \`${FLASH_MODEL}\` (SIMPLE) or \`${PRO_MODEL}\` (COMPLEX).
+1.  \`${FLASH_MODEL}\`: A fast, efficient model for simple, well-defined tasks.
+2.  \`${PRO_MODEL}\`: A powerful, advanced model for complex, open-ended, or multi-step tasks.
+<complexity_rubric>
+A task is COMPLEX (Choose \`${PRO_MODEL}\`) if it meets ONE OR MORE of the following criteria:
+1.  **High Operational Complexity (Est. 4+ Steps/Tool Calls):** Requires dependent actions, significant planning, or multiple coordinated changes.
+2.  **Strategic Planning & Conceptual Design:** Asking "how" or "why." Requires advice, architecture, or high-level strategy.
+3.  **High Ambiguity or Large Scope (Extensive Investigation):** Broadly defined requests requiring extensive investigation.
+4.  **Deep Debugging & Root Cause Analysis:** Diagnosing unknown or complex problems from symptoms.
+A task is SIMPLE (Choose \`${FLASH_MODEL}\`) if it is highly specific, bounded, and has Low Operational Complexity (Est. 1-3 tool calls). Operational simplicity overrides strategic phrasing.
+</complexity_rubric>
+**Output Format:**
+Respond *only* in JSON format according to the following schema. Do not include any text outside the JSON structure.
+{
+  "type": "object",
+  "properties": {
+    "reasoning": {
+      "type": "string",
+      "description": "A brief, step-by-step explanation for the model choice, referencing the rubric."
+    },
+    "model_choice": {
+      "type": "string",
+      "enum": ["${FLASH_MODEL}", "${PRO_MODEL}"]
+    }
+  },
+  "required": ["reasoning", "model_choice"]
+}
+--- EXAMPLES ---
+**Example 1 (Strategic Planning):**
+*User Prompt:* "How should I architect the data pipeline for this new analytics service?"
+*Your JSON Output:*
+{
+  "reasoning": "The user is asking for high-level architectural design and strategy. This falls under 'Strategic Planning & Conceptual Design'.",
+  "model_choice": "${PRO_MODEL}"
+}
+**Example 2 (Simple Tool Use):**
+*User Prompt:* "list the files in the current directory"
+*Your JSON Output:*
+{
+  "reasoning": "This is a direct command requiring a single tool call (ls). It has Low Operational Complexity (1 step).",
+  "model_choice": "${FLASH_MODEL}"
+}
+**Example 3 (High Operational Complexity):**
+*User Prompt:* "I need to add a new 'email' field to the User schema in 'src/models/user.ts', migrate the database, and update the registration endpoint."
+*Your JSON Output:*
+{
+  "reasoning": "This request involves multiple coordinated steps across different files and systems. This meets the criteria for High Operational Complexity (4+ steps).",
+  "model_choice": "${PRO_MODEL}"
+}
+**Example 4 (Simple Read):**
+*User Prompt:* "Read the contents of 'package.json'."
+*Your JSON Output:*
+{
+  "reasoning": "This is a direct command requiring a single read. It has Low Operational Complexity (1 step).",
+  "model_choice": "${FLASH_MODEL}"
+}
+
+**Example 5 (Deep Debugging):**
+*User Prompt:* "I'm getting an error 'Cannot read property 'map' of undefined' when I click the save button. Can you fix it?"
+*Your JSON Output:*
+{
+  "reasoning": "The user is reporting an error symptom without a known cause. This requires investigation and falls under 'Deep Debugging'.",
+  "model_choice": "${PRO_MODEL}"
+}
+**Example 6 (Simple Edit despite Phrasing):**
+*User Prompt:* "What is the best way to rename the variable 'data' to 'userData' in 'src/utils.js'?"
+*Your JSON Output:*
+{
+  "reasoning": "Although the user uses strategic language ('best way'), the underlying task is a localized edit. The operational complexity is low (1-2 steps).",
+  "model_choice": "${FLASH_MODEL}"
+}
+`;
+const RESPONSE_SCHEMA = {
+    type: Type.OBJECT,
+    properties: {
+        reasoning: {
+            type: Type.STRING,
+            description: 'A brief, step-by-step explanation for the model choice, referencing the rubric.',
+        },
+        model_choice: {
+            type: Type.STRING,
+            enum: [FLASH_MODEL, PRO_MODEL],
+        },
+    },
+    required: ['reasoning', 'model_choice'],
+};
+const ClassifierResponseSchema = z.object({
+    reasoning: z.string(),
+    model_choice: z.enum([FLASH_MODEL, PRO_MODEL]),
+});
+export class ClassifierStrategy {
+    name = 'classifier';
+    async route(context, config, baseLlmClient) {
+        const startTime = Date.now();
+        try {
+            let promptId = promptIdContext.getStore();
+            if (!promptId) {
+                promptId = `classifier-router-fallback-${Date.now()}-${Math.random()
+                    .toString(16)
+                    .slice(2)}`;
+                debugLogger.warn(`Could not find promptId in context. This is unexpected. Using a fallback ID: ${promptId}`);
+            }
+            const historySlice = context.history.slice(-HISTORY_SEARCH_WINDOW);
+            // Filter out tool-related turns.
+            // TODO - Consider using function req/res if they help accuracy.
+            const cleanHistory = historySlice.filter((content) => !isFunctionCall(content) && !isFunctionResponse(content));
+            // Take the last N turns from the *cleaned* history.
+            const finalHistory = cleanHistory.slice(-HISTORY_TURNS_FOR_CONTEXT);
+            const jsonResponse = await baseLlmClient.generateJson({
+                modelConfigKey: { model: 'classifier' },
+                contents: [...finalHistory, createUserContent(context.request)],
+                schema: RESPONSE_SCHEMA,
+                systemInstruction: CLASSIFIER_SYSTEM_PROMPT,
+                abortSignal: context.signal,
+                promptId,
+            });
+            const routerResponse = ClassifierResponseSchema.parse(jsonResponse);
+            const reasoning = routerResponse.reasoning;
+            const latencyMs = Date.now() - startTime;
+            if (routerResponse.model_choice === FLASH_MODEL) {
+                return {
+                    model: resolveModel(GEMINI_MODEL_ALIAS_FLASH, config.getPreviewFeatures()),
+                    metadata: {
+                        source: 'Classifier',
+                        latencyMs,
+                        reasoning,
+                    },
+                };
+            }
+            else {
+                return {
+                    model: resolveModel(GEMINI_MODEL_ALIAS_PRO, config.getPreviewFeatures()),
+                    metadata: {
+                        source: 'Classifier',
+                        reasoning,
+                        latencyMs,
+                    },
+                };
+            }
+        }
+        catch (error) {
+            // If the classifier fails for any reason (API error, parsing error, etc.),
+            // we log it and return null to allow the composite strategy to proceed.
+            debugLogger.warn(`[Routing] ClassifierStrategy failed:`, error);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=classifierStrategy.js.map

package/dist/src/routing/strategies/classifierStrategy.js.map

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

package/dist/src/routing/strategies/classifierStrategy.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/routing/strategies/classifierStrategy.test.js

@@ -0,0 +1,196 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { ClassifierStrategy } from './classifierStrategy.js';
+import { isFunctionCall, isFunctionResponse, } from '../../utils/messageInspectors.js';
+import { DEFAULT_GEMINI_FLASH_MODEL, DEFAULT_GEMINI_MODEL, } from '../../config/models.js';
+import { promptIdContext } from '../../utils/promptIdContext.js';
+import { debugLogger } from '../../utils/debugLogger.js';
+vi.mock('../../core/baseLlmClient.js');
+vi.mock('../../utils/promptIdContext.js');
+describe('ClassifierStrategy', () => {
+    let strategy;
+    let mockContext;
+    let mockConfig;
+    let mockBaseLlmClient;
+    let mockResolvedConfig;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        strategy = new ClassifierStrategy();
+        mockContext = {
+            history: [],
+            request: [{ text: 'simple task' }],
+            signal: new AbortController().signal,
+        };
+        mockResolvedConfig = {
+            model: 'classifier',
+            generateContentConfig: {},
+        };
+        mockConfig = {
+            modelConfigService: {
+                getResolvedConfig: vi.fn().mockReturnValue(mockResolvedConfig),
+            },
+            getPreviewFeatures: () => false,
+        };
+        mockBaseLlmClient = {
+            generateJson: vi.fn(),
+        };
+        vi.mocked(promptIdContext.getStore).mockReturnValue('test-prompt-id');
+    });
+    it('should call generateJson with the correct parameters', async () => {
+        const mockApiResponse = {
+            reasoning: 'Simple task',
+            model_choice: 'flash',
+        };
+        vi.mocked(mockBaseLlmClient.generateJson).mockResolvedValue(mockApiResponse);
+        await strategy.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(mockBaseLlmClient.generateJson).toHaveBeenCalledWith(expect.objectContaining({
+            modelConfigKey: { model: mockResolvedConfig.model },
+            promptId: 'test-prompt-id',
+        }));
+    });
+    it('should route to FLASH model for a simple task', async () => {
+        const mockApiResponse = {
+            reasoning: 'This is a simple task.',
+            model_choice: 'flash',
+        };
+        vi.mocked(mockBaseLlmClient.generateJson).mockResolvedValue(mockApiResponse);
+        const decision = await strategy.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(mockBaseLlmClient.generateJson).toHaveBeenCalledOnce();
+        expect(decision).toEqual({
+            model: DEFAULT_GEMINI_FLASH_MODEL,
+            metadata: {
+                source: 'Classifier',
+                latencyMs: expect.any(Number),
+                reasoning: mockApiResponse.reasoning,
+            },
+        });
+    });
+    it('should route to PRO model for a complex task', async () => {
+        const mockApiResponse = {
+            reasoning: 'This is a complex task.',
+            model_choice: 'pro',
+        };
+        vi.mocked(mockBaseLlmClient.generateJson).mockResolvedValue(mockApiResponse);
+        mockContext.request = [{ text: 'how do I build a spaceship?' }];
+        const decision = await strategy.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(mockBaseLlmClient.generateJson).toHaveBeenCalledOnce();
+        expect(decision).toEqual({
+            model: DEFAULT_GEMINI_MODEL,
+            metadata: {
+                source: 'Classifier',
+                latencyMs: expect.any(Number),
+                reasoning: mockApiResponse.reasoning,
+            },
+        });
+    });
+    it('should return null if the classifier API call fails', async () => {
+        const consoleWarnSpy = vi
+            .spyOn(debugLogger, 'warn')
+            .mockImplementation(() => { });
+        const testError = new Error('API Failure');
+        vi.mocked(mockBaseLlmClient.generateJson).mockRejectedValue(testError);
+        const decision = await strategy.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(decision).toBeNull();
+        expect(consoleWarnSpy).toHaveBeenCalled();
+        consoleWarnSpy.mockRestore();
+    });
+    it('should return null if the classifier returns a malformed JSON object', async () => {
+        const consoleWarnSpy = vi
+            .spyOn(debugLogger, 'warn')
+            .mockImplementation(() => { });
+        const malformedApiResponse = {
+            reasoning: 'This is a simple task.',
+            // model_choice is missing, which will cause a Zod parsing error.
+        };
+        vi.mocked(mockBaseLlmClient.generateJson).mockResolvedValue(malformedApiResponse);
+        const decision = await strategy.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(decision).toBeNull();
+        expect(consoleWarnSpy).toHaveBeenCalled();
+        consoleWarnSpy.mockRestore();
+    });
+    it('should filter out tool-related history before sending to classifier', async () => {
+        mockContext.history = [
+            { role: 'user', parts: [{ text: 'call a tool' }] },
+            { role: 'model', parts: [{ functionCall: { name: 'test_tool' } }] },
+            {
+                role: 'user',
+                parts: [
+                    { functionResponse: { name: 'test_tool', response: { ok: true } } },
+                ],
+            },
+            { role: 'user', parts: [{ text: 'another user turn' }] },
+        ];
+        const mockApiResponse = {
+            reasoning: 'Simple.',
+            model_choice: 'flash',
+        };
+        vi.mocked(mockBaseLlmClient.generateJson).mockResolvedValue(mockApiResponse);
+        await strategy.route(mockContext, mockConfig, mockBaseLlmClient);
+        const generateJsonCall = vi.mocked(mockBaseLlmClient.generateJson).mock
+            .calls[0][0];
+        const contents = generateJsonCall.contents;
+        const expectedContents = [
+            { role: 'user', parts: [{ text: 'call a tool' }] },
+            { role: 'user', parts: [{ text: 'another user turn' }] },
+            { role: 'user', parts: [{ text: 'simple task' }] },
+        ];
+        expect(contents).toEqual(expectedContents);
+    });
+    it('should respect HISTORY_SEARCH_WINDOW and HISTORY_TURNS_FOR_CONTEXT', async () => {
+        const longHistory = [];
+        for (let i = 0; i < 30; i++) {
+            longHistory.push({ role: 'user', parts: [{ text: `Message ${i}` }] });
+            // Add noise that should be filtered
+            if (i % 2 === 0) {
+                longHistory.push({
+                    role: 'model',
+                    parts: [{ functionCall: { name: 'noise', args: {} } }],
+                });
+            }
+        }
+        mockContext.history = longHistory;
+        const mockApiResponse = {
+            reasoning: 'Simple.',
+            model_choice: 'flash',
+        };
+        vi.mocked(mockBaseLlmClient.generateJson).mockResolvedValue(mockApiResponse);
+        await strategy.route(mockContext, mockConfig, mockBaseLlmClient);
+        const generateJsonCall = vi.mocked(mockBaseLlmClient.generateJson).mock
+            .calls[0][0];
+        const contents = generateJsonCall.contents;
+        // Manually calculate what the history should be
+        const HISTORY_SEARCH_WINDOW = 20;
+        const HISTORY_TURNS_FOR_CONTEXT = 4;
+        const historySlice = longHistory.slice(-HISTORY_SEARCH_WINDOW);
+        const cleanHistory = historySlice.filter((content) => !isFunctionCall(content) && !isFunctionResponse(content));
+        const finalHistory = cleanHistory.slice(-HISTORY_TURNS_FOR_CONTEXT);
+        expect(contents).toEqual([
+            ...finalHistory,
+            { role: 'user', parts: mockContext.request },
+        ]);
+        // There should be 4 history items + the current request
+        expect(contents).toHaveLength(5);
+    });
+    it('should use a fallback promptId if not found in context', async () => {
+        const consoleWarnSpy = vi
+            .spyOn(debugLogger, 'warn')
+            .mockImplementation(() => { });
+        vi.mocked(promptIdContext.getStore).mockReturnValue(undefined);
+        const mockApiResponse = {
+            reasoning: 'Simple.',
+            model_choice: 'flash',
+        };
+        vi.mocked(mockBaseLlmClient.generateJson).mockResolvedValue(mockApiResponse);
+        await strategy.route(mockContext, mockConfig, mockBaseLlmClient);
+        const generateJsonCall = vi.mocked(mockBaseLlmClient.generateJson).mock
+            .calls[0][0];
+        expect(generateJsonCall.promptId).toMatch(/^classifier-router-fallback-\d+-\w+$/);
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining('Could not find promptId in context. This is unexpected. Using a fallback ID:'));
+        consoleWarnSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=classifierStrategy.test.js.map

package/dist/src/routing/strategies/classifierStrategy.test.js.map

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

package/dist/src/routing/strategies/compositeStrategy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../../config/config.js';
+import type { BaseLlmClient } from '../../core/baseLlmClient.js';
+import type { RoutingContext, RoutingDecision, RoutingStrategy, TerminalStrategy } from '../routingStrategy.js';
+/**
+ * A strategy that attempts a list of child strategies in order (Chain of Responsibility).
+ */
+export declare class CompositeStrategy implements TerminalStrategy {
+    readonly name: string;
+    private strategies;
+    /**
+     * Initializes the CompositeStrategy.
+     * @param strategies The strategies to try, in order of priority. The last strategy must be terminal.
+     * @param name The name of this composite configuration (e.g., 'router' or 'composite').
+     */
+    constructor(strategies: [...RoutingStrategy[], TerminalStrategy], name?: string);
+    route(context: RoutingContext, config: Config, baseLlmClient: BaseLlmClient): Promise<RoutingDecision>;
+    /**
+     * Helper function to enhance the decision metadata with composite information.
+     */
+    private finalizeDecision;
+}

package/dist/src/routing/strategies/compositeStrategy.js

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A strategy that attempts a list of child strategies in order (Chain of Responsibility).
+ */
+export class CompositeStrategy {
+    name;
+    strategies;
+    /**
+     * Initializes the CompositeStrategy.
+     * @param strategies The strategies to try, in order of priority. The last strategy must be terminal.
+     * @param name The name of this composite configuration (e.g., 'router' or 'composite').
+     */
+    constructor(strategies, name = 'composite') {
+        this.strategies = strategies;
+        this.name = name;
+    }
+    async route(context, config, baseLlmClient) {
+        const startTime = performance.now();
+        // Separate non-terminal strategies from the terminal one.
+        // This separation allows TypeScript to understand the control flow guarantees.
+        const nonTerminalStrategies = this.strategies.slice(0, -1);
+        const terminalStrategy = this.strategies[this.strategies.length - 1];
+        // Try non-terminal strategies, allowing them to fail gracefully.
+        for (const strategy of nonTerminalStrategies) {
+            try {
+                const decision = await strategy.route(context, config, baseLlmClient);
+                if (decision) {
+                    return this.finalizeDecision(decision, startTime);
+                }
+            }
+            catch (error) {
+                console.error(`[Routing] Strategy '${strategy.name}' failed. Continuing to next strategy. Error:`, error);
+            }
+        }
+        // If no other strategy matched, execute the terminal strategy.
+        try {
+            const decision = await terminalStrategy.route(context, config, baseLlmClient);
+            return this.finalizeDecision(decision, startTime);
+        }
+        catch (error) {
+            console.error(`[Routing] Critical Error: Terminal strategy '${terminalStrategy.name}' failed. Routing cannot proceed. Error:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Helper function to enhance the decision metadata with composite information.
+     */
+    finalizeDecision(decision, startTime) {
+        const endTime = performance.now();
+        const compositeSource = `${this.name}/${decision.metadata.source}`;
+        // Use the child's latency if it's a meaningful (non-zero) value,
+        // otherwise use the total time spent in the composite strategy.
+        const latency = decision.metadata.latencyMs || endTime - startTime;
+        return {
+            ...decision,
+            metadata: {
+                ...decision.metadata,
+                source: compositeSource,
+                latencyMs: Math.round(latency), // Round to ensure int for telemetry.
+            },
+        };
+    }
+}
+//# sourceMappingURL=compositeStrategy.js.map

package/dist/src/routing/strategies/compositeStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositeStrategy.js","sourceRoot":"","sources":["../../../../src/routing/strategies/compositeStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACnB,IAAI,CAAS;IAEd,UAAU,CAA2C;IAE7D;;;;OAIG;IACH,YACE,UAAoD,EACpD,OAAe,WAAW;QAE1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK,CACT,OAAuB,EACvB,MAAc,EACd,aAA4B;QAE5B,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,0DAA0D;QAC1D,+EAA+E;QAC/E,MAAM,qBAAqB,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CACjD,CAAC,EACD,CAAC,CAAC,CACkB,CAAC;QACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,CACtC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CACP,CAAC;QAEtB,iEAAiE;QACjE,KAAK,MAAM,QAAQ,IAAI,qBAAqB,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;gBACtE,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CACX,uBAAuB,QAAQ,CAAC,IAAI,+CAA+C,EACnF,KAAK,CACN,CAAC;YACJ,CAAC;QACH,CAAC;QAED,+DAA+D;QAC/D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAC3C,OAAO,EACP,MAAM,EACN,aAAa,CACd,CAAC;YAEF,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,gDAAgD,gBAAgB,CAAC,IAAI,0CAA0C,EAC/G,KAAK,CACN,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,QAAyB,EACzB,SAAiB;QAEjB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,eAAe,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAEnE,iEAAiE;QACjE,gEAAgE;QAChE,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,OAAO,GAAG,SAAS,CAAC;QAEnE,OAAO;YACL,GAAG,QAAQ;YACX,QAAQ,EAAE;gBACR,GAAG,QAAQ,CAAC,QAAQ;gBACpB,MAAM,EAAE,eAAe;gBACvB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,qCAAqC;aACtE;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/routing/strategies/compositeStrategy.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/routing/strategies/compositeStrategy.test.js

@@ -0,0 +1,123 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { CompositeStrategy } from './compositeStrategy.js';
+describe('CompositeStrategy', () => {
+    let mockContext;
+    let mockConfig;
+    let mockBaseLlmClient;
+    let mockStrategy1;
+    let mockStrategy2;
+    let mockTerminalStrategy;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockContext = {};
+        mockConfig = {};
+        mockBaseLlmClient = {};
+        mockStrategy1 = {
+            name: 'strategy1',
+            route: vi.fn().mockResolvedValue(null),
+        };
+        mockStrategy2 = {
+            name: 'strategy2',
+            route: vi.fn().mockResolvedValue(null),
+        };
+        mockTerminalStrategy = {
+            name: 'terminal',
+            route: vi.fn().mockResolvedValue({
+                model: 'terminal-model',
+                metadata: {
+                    source: 'terminal',
+                    latencyMs: 10,
+                    reasoning: 'Terminal decision',
+                },
+            }),
+        };
+    });
+    it('should try strategies in order and return the first successful decision', async () => {
+        const decision = {
+            model: 'strategy2-model',
+            metadata: {
+                source: 'strategy2',
+                latencyMs: 20,
+                reasoning: 'Strategy 2 decided',
+            },
+        };
+        vi.spyOn(mockStrategy2, 'route').mockResolvedValue(decision);
+        const composite = new CompositeStrategy([mockStrategy1, mockStrategy2, mockTerminalStrategy], 'test-router');
+        const result = await composite.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(mockStrategy1.route).toHaveBeenCalledWith(mockContext, mockConfig, mockBaseLlmClient);
+        expect(mockStrategy2.route).toHaveBeenCalledWith(mockContext, mockConfig, mockBaseLlmClient);
+        expect(mockTerminalStrategy.route).not.toHaveBeenCalled();
+        expect(result.model).toBe('strategy2-model');
+        expect(result.metadata.source).toBe('test-router/strategy2');
+    });
+    it('should fall back to the terminal strategy if no other strategy provides a decision', async () => {
+        const composite = new CompositeStrategy([mockStrategy1, mockStrategy2, mockTerminalStrategy], 'test-router');
+        const result = await composite.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(mockStrategy1.route).toHaveBeenCalledTimes(1);
+        expect(mockStrategy2.route).toHaveBeenCalledTimes(1);
+        expect(mockTerminalStrategy.route).toHaveBeenCalledTimes(1);
+        expect(result.model).toBe('terminal-model');
+        expect(result.metadata.source).toBe('test-router/terminal');
+    });
+    it('should handle errors in non-terminal strategies and continue', async () => {
+        const consoleErrorSpy = vi
+            .spyOn(console, 'error')
+            .mockImplementation(() => { });
+        vi.spyOn(mockStrategy1, 'route').mockRejectedValue(new Error('Strategy 1 failed'));
+        const composite = new CompositeStrategy([mockStrategy1, mockTerminalStrategy], 'test-router');
+        const result = await composite.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(consoleErrorSpy).toHaveBeenCalledWith("[Routing] Strategy 'strategy1' failed. Continuing to next strategy. Error:", expect.any(Error));
+        expect(result.model).toBe('terminal-model');
+        consoleErrorSpy.mockRestore();
+    });
+    it('should re-throw an error from the terminal strategy', async () => {
+        const consoleErrorSpy = vi
+            .spyOn(console, 'error')
+            .mockImplementation(() => { });
+        const terminalError = new Error('Terminal strategy failed');
+        vi.spyOn(mockTerminalStrategy, 'route').mockRejectedValue(terminalError);
+        const composite = new CompositeStrategy([mockTerminalStrategy]);
+        await expect(composite.route(mockContext, mockConfig, mockBaseLlmClient)).rejects.toThrow(terminalError);
+        expect(consoleErrorSpy).toHaveBeenCalledWith("[Routing] Critical Error: Terminal strategy 'terminal' failed. Routing cannot proceed. Error:", terminalError);
+        consoleErrorSpy.mockRestore();
+    });
+    it('should correctly finalize the decision metadata', async () => {
+        const decision = {
+            model: 'some-model',
+            metadata: {
+                source: 'child-source',
+                latencyMs: 50,
+                reasoning: 'Child reasoning',
+            },
+        };
+        vi.spyOn(mockStrategy1, 'route').mockResolvedValue(decision);
+        const composite = new CompositeStrategy([mockStrategy1, mockTerminalStrategy], 'my-composite');
+        const result = await composite.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(result.model).toBe('some-model');
+        expect(result.metadata.source).toBe('my-composite/child-source');
+        expect(result.metadata.reasoning).toBe('Child reasoning');
+        // It should keep the child's latency
+        expect(result.metadata.latencyMs).toBe(50);
+    });
+    it('should calculate total latency if child latency is not provided', async () => {
+        const decision = {
+            model: 'some-model',
+            metadata: {
+                source: 'child-source',
+                // No latencyMs here
+                latencyMs: 0,
+                reasoning: 'Child reasoning',
+            },
+        };
+        vi.spyOn(mockStrategy1, 'route').mockResolvedValue(decision);
+        const composite = new CompositeStrategy([mockStrategy1, mockTerminalStrategy], 'my-composite');
+        const result = await composite.route(mockContext, mockConfig, mockBaseLlmClient);
+        expect(result.metadata.latencyMs).toBeGreaterThanOrEqual(0);
+    });
+});
+//# sourceMappingURL=compositeStrategy.test.js.map

package/dist/src/routing/strategies/compositeStrategy.test.js.map

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

package/dist/src/routing/strategies/defaultStrategy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../../config/config.js';
+import type { BaseLlmClient } from '../../core/baseLlmClient.js';
+import type { RoutingContext, RoutingDecision, TerminalStrategy } from '../routingStrategy.js';
+export declare class DefaultStrategy implements TerminalStrategy {
+    readonly name = "default";
+    route(_context: RoutingContext, _config: Config, _baseLlmClient: BaseLlmClient): Promise<RoutingDecision>;
+}