anantham-v2 2.0.0-alpha.1

package/dist/models/mock-provider-adapter.d.ts

@@ -0,0 +1,22 @@
+import { type ModelRequest, type ModelResponse, type ModelStreamChunk } from "../domain/model.js";
+import type { ProviderAdapter, ProviderCapabilities } from "./provider-adapter.js";
+export interface MockProviderOptions {
+    providerId?: string;
+    name?: string;
+    defaultResponseText?: string;
+    simulatedDelayMs?: number;
+    injectedError?: "rate_limit" | "auth" | "timeout" | "unavailable" | "context_overflow";
+    retryAfterMs?: number;
+}
+export declare class MockProviderAdapter implements ProviderAdapter {
+    readonly providerId: string;
+    readonly name: string;
+    private options;
+    constructor(options?: MockProviderOptions);
+    setOptions(options: Partial<MockProviderOptions>): void;
+    getCapabilities(_modelId: string): ProviderCapabilities;
+    private checkInjectedError;
+    send(request: ModelRequest): Promise<ModelResponse>;
+    stream(request: ModelRequest): AsyncIterable<ModelStreamChunk>;
+}
+//# sourceMappingURL=mock-provider-adapter.d.ts.map

package/dist/models/mock-provider-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-provider-adapter.d.ts","sourceRoot":"","sources":["../../src/models/mock-provider-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,kBAAkB,CAAC;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACzD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,CAAC,EAAE,mBAAmB;IAMlC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAIvD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB;IAW9D,OAAO,CAAC,kBAAkB;IAgCb,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA+DlD,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAAC,gBAAgB,CAAC;CAgC7E"}

package/dist/models/mock-provider-adapter.js

@@ -0,0 +1,144 @@
+import { randomUUID } from "node:crypto";
+import { ModelRequestSchema, ModelResponseSchema, } from "../domain/model.js";
+import { AuthenticationError, ContextWindowExceededError, ModelTimeoutError, ProviderUnavailableError, RateLimitError, } from "./model-errors.js";
+export class MockProviderAdapter {
+    providerId;
+    name;
+    options;
+    constructor(options) {
+        this.providerId = options?.providerId || "mock-provider";
+        this.name = options?.name || "Mock Provider Adapter";
+        this.options = options || {};
+    }
+    setOptions(options) {
+        this.options = { ...this.options, ...options };
+    }
+    getCapabilities(_modelId) {
+        return {
+            supportsStreaming: true,
+            supportsTools: true,
+            supportsVision: true,
+            supportsAudio: false,
+            maxContextTokens: 128000,
+            maxOutputTokens: 8192,
+        };
+    }
+    checkInjectedError() {
+        if (this.options.injectedError === "rate_limit") {
+            throw new RateLimitError("Mock provider rate limit exceeded (429)", {
+                providerId: this.providerId,
+                retryAfterMs: this.options.retryAfterMs || 5000,
+            });
+        }
+        if (this.options.injectedError === "auth") {
+            throw new AuthenticationError("Mock provider invalid credentials (401)", {
+                providerId: this.providerId,
+            });
+        }
+        if (this.options.injectedError === "timeout") {
+            throw new ModelTimeoutError("Mock provider execution timed out (408)", {
+                providerId: this.providerId,
+                timeoutMs: 30000,
+            });
+        }
+        if (this.options.injectedError === "unavailable") {
+            throw new ProviderUnavailableError("Mock provider service unavailable (503)", {
+                providerId: this.providerId,
+            });
+        }
+        if (this.options.injectedError === "context_overflow") {
+            throw new ContextWindowExceededError("Mock context window exceeded limit", {
+                providerId: this.providerId,
+                tokenCount: 150000,
+                maxContextTokens: 128000,
+            });
+        }
+    }
+    async send(request) {
+        const validatedReq = ModelRequestSchema.parse(request);
+        this.checkInjectedError();
+        if (this.options.simulatedDelayMs) {
+            await new Promise((resolve) => setTimeout(resolve, this.options.simulatedDelayMs));
+        }
+        const lastMessage = validatedReq.messages[validatedReq.messages.length - 1] ?? { role: "user", content: "" };
+        const responseId = `resp_${randomUUID().slice(0, 12)}`;
+        // Check if tools were provided and last message requested a tool
+        if (validatedReq.tools && validatedReq.tools.length > 0 && /tool|call|run/i.test(lastMessage.content)) {
+            const toolToCall = validatedReq.tools[0];
+            if (toolToCall) {
+                const response = {
+                    id: responseId,
+                    modelId: validatedReq.modelId,
+                    message: {
+                        role: "assistant",
+                        content: "",
+                        toolCalls: [
+                            {
+                                id: `call_${randomUUID().slice(0, 8)}`,
+                                name: toolToCall.name,
+                                argumentsJson: JSON.stringify({ query: "mock query argument" }),
+                            },
+                        ],
+                    },
+                    finishReason: "tool_calls",
+                    usage: {
+                        promptTokens: 50,
+                        completionTokens: 25,
+                        totalTokens: 75,
+                        costUsd: 0.0001,
+                    },
+                    createdAt: new Date().toISOString(),
+                };
+                return Object.freeze(ModelResponseSchema.parse(response));
+            }
+        }
+        const responseText = this.options.defaultResponseText || `Mock response for: ${lastMessage.content.slice(0, 50)}`;
+        const response = {
+            id: responseId,
+            modelId: validatedReq.modelId,
+            message: {
+                role: "assistant",
+                content: responseText,
+            },
+            finishReason: "stop",
+            usage: {
+                promptTokens: 40,
+                completionTokens: 20,
+                totalTokens: 60,
+                costUsd: 0.00008,
+            },
+            createdAt: new Date().toISOString(),
+        };
+        return Object.freeze(ModelResponseSchema.parse(response));
+    }
+    async *stream(request) {
+        const validatedReq = ModelRequestSchema.parse(request);
+        this.checkInjectedError();
+        const lastMessage = validatedReq.messages[validatedReq.messages.length - 1] ?? { role: "user", content: "" };
+        const streamId = `stream_${randomUUID().slice(0, 12)}`;
+        const responseText = this.options.defaultResponseText || `Streaming: ${lastMessage.content.slice(0, 50)}`;
+        const words = responseText.split(" ");
+        for (let i = 0; i < words.length; i++) {
+            if (this.options.simulatedDelayMs) {
+                await new Promise((resolve) => setTimeout(resolve, this.options.simulatedDelayMs));
+            }
+            yield {
+                id: streamId,
+                modelId: validatedReq.modelId,
+                deltaText: (i === 0 ? "" : " ") + words[i],
+            };
+        }
+        // Final chunk
+        yield {
+            id: streamId,
+            modelId: validatedReq.modelId,
+            finishReason: "stop",
+            usage: {
+                promptTokens: 40,
+                completionTokens: words.length * 2,
+                totalTokens: 40 + words.length * 2,
+            },
+        };
+    }
+}
+//# sourceMappingURL=mock-provider-adapter.js.map

package/dist/models/mock-provider-adapter.js.map

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

package/dist/models/model-errors.d.ts

@@ -0,0 +1,65 @@
+export declare class ModelExecutionError extends Error {
+    readonly providerId?: string;
+    readonly modelId?: string;
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        providerId?: string;
+        modelId?: string;
+        statusCode?: number;
+    });
+}
+export declare class RateLimitError extends ModelExecutionError {
+    readonly retryAfterMs?: number;
+    constructor(message: string, options?: {
+        providerId?: string;
+        modelId?: string;
+        retryAfterMs?: number;
+    });
+}
+export declare class ContextWindowExceededError extends ModelExecutionError {
+    readonly tokenCount?: number;
+    readonly maxContextTokens?: number;
+    constructor(message: string, options?: {
+        providerId?: string;
+        modelId?: string;
+        tokenCount?: number;
+        maxContextTokens?: number;
+    });
+}
+export declare class AuthenticationError extends ModelExecutionError {
+    constructor(message: string, options?: {
+        providerId?: string;
+        modelId?: string;
+    });
+}
+export declare class ProviderUnavailableError extends ModelExecutionError {
+    constructor(message: string, options?: {
+        providerId?: string;
+        modelId?: string;
+    });
+}
+export declare class ModelTimeoutError extends ModelExecutionError {
+    readonly timeoutMs?: number;
+    constructor(message: string, options?: {
+        providerId?: string;
+        modelId?: string;
+        timeoutMs?: number;
+    });
+}
+export declare class ContentFilterError extends ModelExecutionError {
+    constructor(message: string, options?: {
+        providerId?: string;
+        modelId?: string;
+    });
+}
+export declare class InvalidToolCallError extends ModelExecutionError {
+    readonly toolName?: string;
+    readonly rawArguments?: string;
+    constructor(message: string, options?: {
+        providerId?: string;
+        modelId?: string;
+        toolName?: string;
+        rawArguments?: string;
+    });
+}
+//# sourceMappingURL=model-errors.d.ts.map

package/dist/models/model-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-errors.d.ts","sourceRoot":"","sources":["../../src/models/model-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAQtG;AAED,qBAAa,cAAe,SAAQ,mBAAmB;IACrD,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;CAMxG;AAED,qBAAa,0BAA2B,SAAQ,mBAAmB;IACjE,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAGxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE;CAQtG;AAED,qBAAa,mBAAoB,SAAQ,mBAAmB;gBAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAKjF;AAED,qBAAa,wBAAyB,SAAQ,mBAAmB;gBACnD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAKjF;AAED,qBAAa,iBAAkB,SAAQ,mBAAmB;IACxD,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;CAMrG;AAED,qBAAa,kBAAmB,SAAQ,mBAAmB;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAKjF;AAED,qBAAa,oBAAqB,SAAQ,mBAAmB;IAC3D,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;gBAGpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;CAQhG"}

package/dist/models/model-errors.js

@@ -0,0 +1,75 @@
+export class ModelExecutionError extends Error {
+    providerId;
+    modelId;
+    statusCode;
+    constructor(message, options) {
+        super(message);
+        this.name = "ModelExecutionError";
+        this.providerId = options?.providerId;
+        this.modelId = options?.modelId;
+        this.statusCode = options?.statusCode;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class RateLimitError extends ModelExecutionError {
+    retryAfterMs;
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 429 });
+        this.name = "RateLimitError";
+        this.retryAfterMs = options?.retryAfterMs;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class ContextWindowExceededError extends ModelExecutionError {
+    tokenCount;
+    maxContextTokens;
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 400 });
+        this.name = "ContextWindowExceededError";
+        this.tokenCount = options?.tokenCount;
+        this.maxContextTokens = options?.maxContextTokens;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class AuthenticationError extends ModelExecutionError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 401 });
+        this.name = "AuthenticationError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class ProviderUnavailableError extends ModelExecutionError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 503 });
+        this.name = "ProviderUnavailableError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class ModelTimeoutError extends ModelExecutionError {
+    timeoutMs;
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 408 });
+        this.name = "ModelTimeoutError";
+        this.timeoutMs = options?.timeoutMs;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class ContentFilterError extends ModelExecutionError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 400 });
+        this.name = "ContentFilterError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class InvalidToolCallError extends ModelExecutionError {
+    toolName;
+    rawArguments;
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 422 });
+        this.name = "InvalidToolCallError";
+        this.toolName = options?.toolName;
+        this.rawArguments = options?.rawArguments;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# sourceMappingURL=model-errors.js.map

package/dist/models/model-errors.js.map

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

package/dist/models/model-router.d.ts

@@ -0,0 +1,40 @@
+import { type ExecutionAttemptRecord, type ModelCandidate, type RejectedCandidate, type RoutingDecision, type RoutingExecutionResult, type RoutingRequest } from "../domain/routing.js";
+import { type ModelRequest } from "../domain/model.js";
+import type { ProviderAdapter } from "./provider-adapter.js";
+import { ModelExecutionError } from "./model-errors.js";
+import { KeyPoolManager } from "./key-pool-manager.js";
+import { ProviderHealthTracker } from "./provider-health-tracker.js";
+export declare class NoCompatibleModelCandidateError extends ModelExecutionError {
+    readonly rejectedCandidates: RejectedCandidate[];
+    constructor(message: string, rejectedCandidates: RejectedCandidate[]);
+}
+export declare class AllCandidatesExhaustedError extends ModelExecutionError {
+    readonly attempts: ExecutionAttemptRecord[];
+    constructor(message: string, attempts: ExecutionAttemptRecord[]);
+}
+export interface ModelRouterOptions {
+    keyPoolManager?: KeyPoolManager;
+    healthTracker?: ProviderHealthTracker;
+}
+export declare class ModelRouter {
+    private candidates;
+    readonly keyPoolManager?: KeyPoolManager;
+    readonly healthTracker: ProviderHealthTracker;
+    constructor(options?: ModelRouterOptions);
+    registerCandidate(candidate: ModelCandidate, adapter: ProviderAdapter): void;
+    getCandidate(modelId: string, providerId?: string): {
+        candidate: ModelCandidate;
+        adapter: ProviderAdapter;
+    } | undefined;
+    listCandidates(): ModelCandidate[];
+    /**
+     * Deterministically evaluates registered model candidates against requirements, health, and policy.
+     * PRD Part 1 Section 83 & PRD Part 2 Section 42.
+     */
+    route(request: RoutingRequest): RoutingDecision;
+    /**
+     * Executes a model request through deterministic routing, key leasing, and bounded failover cascades.
+     */
+    execute(modelRequest: ModelRequest, routingRequest: RoutingRequest): Promise<RoutingExecutionResult>;
+}
+//# sourceMappingURL=model-router.d.ts.map

package/dist/models/model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../../src/models/model-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAGL,mBAAmB,EAIpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,qBAAa,+BAAgC,SAAQ,mBAAmB;IACtE,SAAgB,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;gBAE5C,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,iBAAiB,EAAE;CAMrE;AAED,qBAAa,2BAA4B,SAAQ,mBAAmB;IAClE,SAAgB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;gBAEvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE;CAMhE;AASD,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAmF;IACrG,SAAgB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChD,SAAgB,aAAa,EAAE,qBAAqB,CAAC;gBAEzC,OAAO,GAAE,kBAAuB;IAKrC,iBAAiB,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAM5E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,eAAe,CAAA;KAAE,GAAG,SAAS;IAYvH,cAAc,IAAI,cAAc,EAAE;IAIzC;;;OAGG;IACI,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe;IAyGtD;;OAEG;IACU,OAAO,CAClB,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,sBAAsB,CAAC;CAiInC"}

package/dist/models/model-router.js

@@ -0,0 +1,255 @@
+import { ModelCandidateSchema, RoutingDecisionSchema, RoutingExecutionResultSchema, RoutingRequestSchema, } from "../domain/routing.js";
+import { ModelRequestSchema, } from "../domain/model.js";
+import { CapabilityResolver } from "./capability-resolver.js";
+import { ContentFilterError, InvalidToolCallError, ModelExecutionError, RateLimitError, ProviderUnavailableError, ModelTimeoutError, } from "./model-errors.js";
+import { ProviderHealthTracker } from "./provider-health-tracker.js";
+export class NoCompatibleModelCandidateError extends ModelExecutionError {
+    rejectedCandidates;
+    constructor(message, rejectedCandidates) {
+        super(message, { statusCode: 400 });
+        this.name = "NoCompatibleModelCandidateError";
+        this.rejectedCandidates = rejectedCandidates;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class AllCandidatesExhaustedError extends ModelExecutionError {
+    attempts;
+    constructor(message, attempts) {
+        super(message, { statusCode: 503 });
+        this.name = "AllCandidatesExhaustedError";
+        this.attempts = attempts;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+const SENSITIVITY_RANK = {
+    public: 0,
+    normal: 1,
+    sensitive: 2,
+    secret: 3,
+};
+export class ModelRouter {
+    candidates = new Map();
+    keyPoolManager;
+    healthTracker;
+    constructor(options = {}) {
+        this.keyPoolManager = options.keyPoolManager;
+        this.healthTracker = options.healthTracker || new ProviderHealthTracker();
+    }
+    registerCandidate(candidate, adapter) {
+        const validatedCandidate = ModelCandidateSchema.parse(candidate);
+        const key = `${validatedCandidate.providerId}:${validatedCandidate.modelId}`;
+        this.candidates.set(key, { candidate: validatedCandidate, adapter });
+    }
+    getCandidate(modelId, providerId) {
+        if (providerId) {
+            return this.candidates.get(`${providerId}:${modelId}`);
+        }
+        for (const entry of this.candidates.values()) {
+            if (entry.candidate.modelId === modelId) {
+                return entry;
+            }
+        }
+        return undefined;
+    }
+    listCandidates() {
+        return Array.from(this.candidates.values()).map((e) => e.candidate);
+    }
+    /**
+     * Deterministically evaluates registered model candidates against requirements, health, and policy.
+     * PRD Part 1 Section 83 & PRD Part 2 Section 42.
+     */
+    route(request) {
+        const validatedReq = RoutingRequestSchema.parse(request);
+        const eligible = [];
+        const rejected = [];
+        const reqSensitivityRank = SENSITIVITY_RANK[validatedReq.sensitivity];
+        for (const { candidate, adapter } of this.candidates.values()) {
+            // 1. Data Sensitivity Authorization Filter
+            const candidateMaxRank = SENSITIVITY_RANK[candidate.maxSensitivity];
+            if (reqSensitivityRank > candidateMaxRank) {
+                rejected.push({
+                    modelId: candidate.modelId,
+                    providerId: candidate.providerId,
+                    reason: `Sensitivity level '${validatedReq.sensitivity}' exceeds candidate maxSensitivity '${candidate.maxSensitivity}'`,
+                });
+                continue;
+            }
+            // 2. Provider Health Filter
+            const provHealth = this.healthTracker.getProviderHealth(candidate.providerId);
+            if (provHealth.status === "unavailable") {
+                rejected.push({
+                    modelId: candidate.modelId,
+                    providerId: candidate.providerId,
+                    reason: `Provider '${candidate.providerId}' is currently unavailable (Reason: ${provHealth.reason || "Outage"})`,
+                });
+                continue;
+            }
+            // 3. Capability Resolution Filter
+            const resolution = CapabilityResolver.resolve(candidate.profile, validatedReq.requirements, {
+                providerCapabilities: adapter.getCapabilities(candidate.modelId),
+            });
+            if (!resolution.compatible) {
+                rejected.push({
+                    modelId: candidate.modelId,
+                    providerId: candidate.providerId,
+                    reason: resolution.explanation,
+                });
+                continue;
+            }
+            eligible.push(candidate);
+        }
+        if (eligible.length === 0) {
+            throw new NoCompatibleModelCandidateError(`No compatible model candidates available for requested capabilities. (${rejected.length} candidates rejected)`, rejected);
+        }
+        // 4. Deterministic Ranking
+        eligible.sort((a, b) => {
+            // Explicit model preference
+            if (validatedReq.preferredModelId) {
+                if (a.modelId === validatedReq.preferredModelId && b.modelId !== validatedReq.preferredModelId)
+                    return -1;
+                if (b.modelId === validatedReq.preferredModelId && a.modelId !== validatedReq.preferredModelId)
+                    return 1;
+            }
+            // Explicit provider preference
+            if (validatedReq.preferredProviderId) {
+                if (a.providerId === validatedReq.preferredProviderId && b.providerId !== validatedReq.preferredProviderId)
+                    return -1;
+                if (b.providerId === validatedReq.preferredProviderId && a.providerId !== validatedReq.preferredProviderId)
+                    return 1;
+            }
+            // Degraded health downranking
+            const aHealth = this.healthTracker.getProviderHealth(a.providerId);
+            const bHealth = this.healthTracker.getProviderHealth(b.providerId);
+            if (aHealth.status === "healthy" && bHealth.status === "degraded")
+                return -1;
+            if (bHealth.status === "healthy" && aHealth.status === "degraded")
+                return 1;
+            // Configured priority descending
+            if (b.priority !== a.priority) {
+                return b.priority - a.priority;
+            }
+            // Stable tie-break: providerId, then modelId
+            const provCmp = a.providerId.localeCompare(b.providerId);
+            if (provCmp !== 0)
+                return provCmp;
+            return a.modelId.localeCompare(b.modelId);
+        });
+        const selected = eligible[0];
+        if (!selected) {
+            throw new NoCompatibleModelCandidateError(`No compatible model candidates available for requested capabilities.`, rejected);
+        }
+        const explanation = `Selected '${selected.providerId}:${selected.modelId}' (Priority: ${selected.priority}). ${eligible.length - 1} fallback candidate(s) available.`;
+        return Object.freeze(RoutingDecisionSchema.parse({
+            selectedCandidate: selected,
+            rankedCandidates: eligible,
+            rejectedCandidates: rejected,
+            explanation,
+        }));
+    }
+    /**
+     * Executes a model request through deterministic routing, key leasing, and bounded failover cascades.
+     */
+    async execute(modelRequest, routingRequest) {
+        const validatedModelReq = ModelRequestSchema.parse(modelRequest);
+        const decision = this.route(routingRequest);
+        const attempts = [];
+        const maxAttempts = Math.min(routingRequest.maxAttempts, decision.rankedCandidates.length);
+        let lastError;
+        for (let i = 0; i < maxAttempts; i++) {
+            const candidate = decision.rankedCandidates[i];
+            if (!candidate) {
+                continue;
+            }
+            const entry = this.getCandidate(candidate.modelId, candidate.providerId);
+            if (!entry) {
+                continue;
+            }
+            const attemptNumber = i + 1;
+            const startTime = Date.now();
+            // Key lease acquisition if keyPoolManager is configured
+            let leaseId;
+            if (this.keyPoolManager) {
+                const keyResult = await this.keyPoolManager.acquireKey(candidate.providerId);
+                if (!keyResult.success) {
+                    // Key pool exhausted for this candidate -> record attempt failure and cascade to next candidate
+                    const durationMs = Date.now() - startTime;
+                    attempts.push({
+                        attemptNumber,
+                        modelId: candidate.modelId,
+                        providerId: candidate.providerId,
+                        status: "failure",
+                        errorName: "KeyPoolExhaustedError",
+                        errorMessage: keyResult.rejectionReason || "No eligible keys in pool",
+                        durationMs,
+                        timestamp: new Date().toISOString(),
+                    });
+                    continue;
+                }
+                leaseId = keyResult.lease?.leaseId;
+            }
+            try {
+                const response = await entry.adapter.send({
+                    ...validatedModelReq,
+                    modelId: candidate.modelId,
+                });
+                const durationMs = Date.now() - startTime;
+                if (leaseId && this.keyPoolManager) {
+                    this.keyPoolManager.releaseKey(leaseId, { isError: false });
+                }
+                this.healthTracker.recordSuccess(candidate.providerId, candidate.modelId);
+                attempts.push({
+                    attemptNumber,
+                    modelId: candidate.modelId,
+                    providerId: candidate.providerId,
+                    status: "success",
+                    durationMs,
+                    timestamp: new Date().toISOString(),
+                });
+                return Object.freeze(RoutingExecutionResultSchema.parse({
+                    response,
+                    decision,
+                    attempts,
+                    succeededCandidate: candidate,
+                }));
+            }
+            catch (err) {
+                const durationMs = Date.now() - startTime;
+                const errorName = err?.name || "ModelExecutionError";
+                const errorMessage = err?.message || String(err);
+                if (leaseId && this.keyPoolManager) {
+                    const isRateLimit = err instanceof RateLimitError;
+                    this.keyPoolManager.releaseKey(leaseId, {
+                        isError: true,
+                        cooldownMs: isRateLimit ? 5000 : 0,
+                    });
+                }
+                this.healthTracker.recordFailure(candidate.providerId, candidate.modelId, err);
+                attempts.push({
+                    attemptNumber,
+                    modelId: candidate.modelId,
+                    providerId: candidate.providerId,
+                    status: "failure",
+                    errorName,
+                    errorMessage,
+                    durationMs,
+                    timestamp: new Date().toISOString(),
+                });
+                lastError = err;
+                // Non-retryable / permanent errors abort immediately
+                if (err instanceof ContentFilterError ||
+                    err instanceof InvalidToolCallError) {
+                    throw err;
+                }
+                // Only retry on transient/recoverable errors
+                const isTransient = err instanceof RateLimitError ||
+                    err instanceof ProviderUnavailableError ||
+                    err instanceof ModelTimeoutError;
+                if (!isTransient && i === maxAttempts - 1) {
+                    throw err;
+                }
+            }
+        }
+        throw new AllCandidatesExhaustedError(`All ${maxAttempts} model candidate attempt(s) failed. Last error: ${lastError?.message || "Unknown"}`, attempts);
+    }
+}
+//# sourceMappingURL=model-router.js.map

package/dist/models/model-router.js.map

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