@anthropic-field/core 0.1.0

package/dist/src/resources/resource-registry.js

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const resourceKey = (serverName, uri) => `${serverName}::${uri}`;
+/**
+ * Tracks resources discovered from MCP servers so other
+ * components can query or include them in conversations.
+ */
+export class ResourceRegistry {
+    resources = new Map();
+    /**
+     * Replace the resources for a specific server.
+     */
+    setResourcesForServer(serverName, resources) {
+        this.removeResourcesByServer(serverName);
+        const discoveredAt = Date.now();
+        for (const resource of resources) {
+            if (!resource.uri) {
+                continue;
+            }
+            this.resources.set(resourceKey(serverName, resource.uri), {
+                serverName,
+                discoveredAt,
+                ...resource,
+            });
+        }
+    }
+    getAllResources() {
+        return Array.from(this.resources.values());
+    }
+    /**
+     * Find a resource by its identifier.
+     * Format: serverName:uri (e.g., "myserver:file:///data.txt")
+     */
+    findResourceByUri(identifier) {
+        const colonIndex = identifier.indexOf(':');
+        if (colonIndex <= 0) {
+            return undefined;
+        }
+        const serverName = identifier.substring(0, colonIndex);
+        const uri = identifier.substring(colonIndex + 1);
+        return this.resources.get(resourceKey(serverName, uri));
+    }
+    removeResourcesByServer(serverName) {
+        for (const key of Array.from(this.resources.keys())) {
+            if (key.startsWith(`${serverName}::`)) {
+                this.resources.delete(key);
+            }
+        }
+    }
+    clear() {
+        this.resources.clear();
+    }
+}
+//# sourceMappingURL=resource-registry.js.map

package/dist/src/resources/resource-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.js","sourceRoot":"","sources":["../../../src/resources/resource-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,GAAG,CAAC,UAAkB,EAAE,GAAW,EAAU,EAAE,CAC9D,GAAG,UAAU,KAAK,GAAG,EAAE,CAAC;AAQ1B;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAA6B,IAAI,GAAG,EAAE,CAAC;IAExD;;OAEG;IACH,qBAAqB,CAAC,UAAkB,EAAE,SAAqB;QAC7D,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAChC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;gBACxD,UAAU;gBACV,YAAY;gBACZ,GAAG,QAAQ;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,UAAkB;QAClC,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,uBAAuB,CAAC,UAAkB;QACxC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACpD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,UAAU,IAAI,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/src/routing/modelRouterService.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { RoutingContext, RoutingDecision } from './routingStrategy.js';
+/**
+ * A centralized service for making model routing decisions.
+ */
+export declare class ModelRouterService {
+    private config;
+    private strategy;
+    constructor(config: Config);
+    private initializeDefaultStrategy;
+    /**
+     * Determines which model to use for a given request context.
+     *
+     * @param context The full context of the request.
+     * @returns A promise that resolves to a RoutingDecision.
+     */
+    route(context: RoutingContext): Promise<RoutingDecision>;
+}

package/dist/src/routing/modelRouterService.js

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DefaultStrategy } from './strategies/defaultStrategy.js';
+import { ClassifierStrategy } from './strategies/classifierStrategy.js';
+import { NumericalClassifierStrategy } from './strategies/numericalClassifierStrategy.js';
+import { CompositeStrategy } from './strategies/compositeStrategy.js';
+import { FallbackStrategy } from './strategies/fallbackStrategy.js';
+import { OverrideStrategy } from './strategies/overrideStrategy.js';
+import { logModelRouting } from '../telemetry/loggers.js';
+import { ModelRoutingEvent } from '../telemetry/types.js';
+import { debugLogger } from '../utils/debugLogger.js';
+/**
+ * A centralized service for making model routing decisions.
+ */
+export class ModelRouterService {
+    config;
+    strategy;
+    constructor(config) {
+        this.config = config;
+        this.strategy = this.initializeDefaultStrategy();
+    }
+    initializeDefaultStrategy() {
+        // Initialize the composite strategy with the desired priority order.
+        // The strategies are ordered in order of highest priority.
+        return new CompositeStrategy([
+            new FallbackStrategy(),
+            new OverrideStrategy(),
+            new ClassifierStrategy(),
+            new NumericalClassifierStrategy(),
+            new DefaultStrategy(),
+        ], 'agent-router');
+    }
+    /**
+     * Determines which model to use for a given request context.
+     *
+     * @param context The full context of the request.
+     * @returns A promise that resolves to a RoutingDecision.
+     */
+    async route(context) {
+        const startTime = Date.now();
+        let decision;
+        const [enableNumericalRouting, thresholdValue] = await Promise.all([
+            this.config.getNumericalRoutingEnabled(),
+            this.config.getClassifierThreshold(),
+        ]);
+        const classifierThreshold = thresholdValue !== undefined ? String(thresholdValue) : undefined;
+        let failed = false;
+        let error_message;
+        try {
+            decision = await this.strategy.route(context, this.config, this.config.getBaseLlmClient());
+            debugLogger.debug(`[Routing] Selected model: ${decision.model} (Source: ${decision.metadata.source}, Latency: ${decision.metadata.latencyMs}ms)\n\t[Routing] Reasoning: ${decision.metadata.reasoning}`);
+        }
+        catch (e) {
+            failed = true;
+            error_message = e instanceof Error ? e.message : String(e);
+            // Create a fallback decision for logging purposes
+            // We do not actually route here. This should never happen so we should
+            // fail loudly to catch any issues where this happens.
+            decision = {
+                model: this.config.getModel(),
+                metadata: {
+                    source: 'router-exception',
+                    latencyMs: Date.now() - startTime,
+                    reasoning: 'An exception occurred during routing.',
+                    error: error_message,
+                },
+            };
+            debugLogger.debug(`[Routing] Exception during routing: ${error_message}\n\tFallback model: ${decision.model} (Source: ${decision.metadata.source})`);
+        }
+        finally {
+            const event = new ModelRoutingEvent(decision.model, decision.metadata.source, decision.metadata.latencyMs, decision.metadata.reasoning, failed, error_message, enableNumericalRouting, classifierThreshold);
+            logModelRouting(this.config, event);
+        }
+        return decision;
+    }
+}
+//# sourceMappingURL=modelRouterService.js.map

package/dist/src/routing/modelRouterService.js.map

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

package/dist/src/routing/routingStrategy.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Content, PartListUnion } from '@google/genai';
+import type { BaseLlmClient } from '../core/baseLlmClient.js';
+import type { Config } from '../config/config.js';
+/**
+ * The output of a routing decision. It specifies which model to use and why.
+ */
+export interface RoutingDecision {
+    /** The model identifier string to use for the next API call (e.g., 'gemini-2.5-pro'). */
+    model: string;
+    /**
+     * Metadata about the routing decision for logging purposes.
+     */
+    metadata: {
+        source: string;
+        latencyMs: number;
+        reasoning: string;
+        error?: string;
+    };
+}
+/**
+ * The context provided to the router for making a decision.
+ */
+export interface RoutingContext {
+    /** The full history of the conversation. */
+    history: Content[];
+    /** The immediate request parts to be processed. */
+    request: PartListUnion;
+    /** An abort signal to cancel an LLM call during routing. */
+    signal: AbortSignal;
+    /** The model string requested for this turn, if any. */
+    requestedModel?: string;
+}
+/**
+ * The core interface that all routing strategies must implement.
+ * Strategies implementing this interface may decline a request by returning null.
+ */
+export interface RoutingStrategy {
+    /** The name of the strategy (e.g., 'fallback', 'override', 'composite'). */
+    readonly name: string;
+    /**
+     * Determines which model to use for a given request context.
+     * @param context The full context of the request.
+     * @param config The current configuration.
+     * @param client A reference to the GeminiClient, allowing the strategy to make its own API calls if needed.
+     * @returns A promise that resolves to a RoutingDecision, or null if the strategy is not applicable.
+     */
+    route(context: RoutingContext, config: Config, baseLlmClient: BaseLlmClient): Promise<RoutingDecision | null>;
+}
+/**
+ * A strategy that is guaranteed to return a decision. It must not return null.
+ * This is used to ensure that a composite chain always terminates.
+ */
+export interface TerminalStrategy extends RoutingStrategy {
+    /**
+     * Determines which model to use for a given request context.
+     * @returns A promise that resolves to a RoutingDecision.
+     */
+    route(context: RoutingContext, config: Config, baseLlmClient: BaseLlmClient): Promise<RoutingDecision>;
+}

package/dist/src/routing/routingStrategy.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=routingStrategy.js.map

package/dist/src/routing/routingStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routingStrategy.js","sourceRoot":"","sources":["../../../src/routing/routingStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

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

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

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import { getPromptIdWithFallback } from '../../utils/promptIdContext.js';
+import { resolveClassifierModel } 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 {
+            if (await config.getNumericalRoutingEnabled()) {
+                return null;
+            }
+            const promptId = getPromptIdWithFallback('classifier-router');
+            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;
+            const selectedModel = resolveClassifierModel(context.requestedModel ?? config.getModel(), routerResponse.model_choice, config.getPreviewFeatures());
+            return {
+                model: selectedModel,
+                metadata: {
+                    source: 'Classifier',
+                    latencyMs,
+                    reasoning,
+                },
+            };
+        }
+        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/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,70 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debugLogger } from '../../utils/debugLogger.js';
+import { coreEvents } from '../../utils/events.js';
+/**
+ * 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) {
+                debugLogger.warn(`[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) {
+            coreEvents.emitFeedback('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;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQnD;;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,WAAW,CAAC,IAAI,CACd,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,UAAU,CAAC,YAAY,CACrB,OAAO,EACP,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/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>;
+}

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { resolveModel } from '../../config/models.js';
+export class DefaultStrategy {
+    name = 'default';
+    async route(_context, config, _baseLlmClient) {
+        const defaultModel = resolveModel(config.getModel(), config.getPreviewFeatures());
+        return {
+            model: defaultModel,
+            metadata: {
+                source: this.name,
+                latencyMs: 0,
+                reasoning: `Routing to default model: ${defaultModel}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=defaultStrategy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultStrategy.js","sourceRoot":"","sources":["../../../../src/routing/strategies/defaultStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,SAAS,CAAC;IAE1B,KAAK,CAAC,KAAK,CACT,QAAwB,EACxB,MAAc,EACd,cAA6B;QAE7B,MAAM,YAAY,GAAG,YAAY,CAC/B,MAAM,CAAC,QAAQ,EAAE,EACjB,MAAM,CAAC,kBAAkB,EAAE,CAC5B,CAAC;QACF,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE;gBACR,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,6BAA6B,YAAY,EAAE;aACvD;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/routing/strategies/fallbackStrategy.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, RoutingStrategy } from '../routingStrategy.js';
+export declare class FallbackStrategy implements RoutingStrategy {
+    readonly name = "fallback";
+    route(context: RoutingContext, config: Config, _baseLlmClient: BaseLlmClient): Promise<RoutingDecision | null>;
+}

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { selectModelForAvailability } from '../../availability/policyHelpers.js';
+import { resolveModel } from '../../config/models.js';
+export class FallbackStrategy {
+    name = 'fallback';
+    async route(context, config, _baseLlmClient) {
+        const requestedModel = context.requestedModel ?? config.getModel();
+        const resolvedModel = resolveModel(requestedModel, config.getPreviewFeatures());
+        const service = config.getModelAvailabilityService();
+        const snapshot = service.snapshot(resolvedModel);
+        if (snapshot.available) {
+            return null;
+        }
+        const selection = selectModelForAvailability(config, requestedModel);
+        if (selection?.selectedModel &&
+            selection.selectedModel !== requestedModel) {
+            return {
+                model: selection.selectedModel,
+                metadata: {
+                    source: this.name,
+                    latencyMs: 0,
+                    reasoning: `Model ${requestedModel} is unavailable (${snapshot.reason}). Using fallback: ${selection.selectedModel}`,
+                },
+            };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=fallbackStrategy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackStrategy.js","sourceRoot":"","sources":["../../../../src/routing/strategies/fallbackStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQtD,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,UAAU,CAAC;IAE3B,KAAK,CAAC,KAAK,CACT,OAAuB,EACvB,MAAc,EACd,cAA6B;QAE7B,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnE,MAAM,aAAa,GAAG,YAAY,CAChC,cAAc,EACd,MAAM,CAAC,kBAAkB,EAAE,CAC5B,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,2BAA2B,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAEjD,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,0BAA0B,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAErE,IACE,SAAS,EAAE,aAAa;YACxB,SAAS,CAAC,aAAa,KAAK,cAAc,EAC1C,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,SAAS,CAAC,aAAa;gBAC9B,QAAQ,EAAE;oBACR,MAAM,EAAE,IAAI,CAAC,IAAI;oBACjB,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,SAAS,cAAc,oBAAoB,QAAQ,CAAC,MAAM,sBAAsB,SAAS,CAAC,aAAa,EAAE;iBACrH;aACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BaseLlmClient } from '../../core/baseLlmClient.js';
+import type { RoutingContext, RoutingDecision, RoutingStrategy } from '../routingStrategy.js';
+import type { Config } from '../../config/config.js';
+export declare class NumericalClassifierStrategy implements RoutingStrategy {
+    readonly name = "numerical_classifier";
+    route(context: RoutingContext, config: Config, baseLlmClient: BaseLlmClient): Promise<RoutingDecision | null>;
+    private getRoutingDecision;
+}