anantham-v2 2.0.0-alpha.1

package/dist/models/adapters/openrouter-adapter.js

@@ -0,0 +1,31 @@
+import { OpenAICompatibleAdapter, } from "./openai-compatible-adapter.js";
+/**
+ * OpenRouter aggregation provider adapter.
+ * PRD Part 2 Section 42.
+ */
+export class OpenRouterProviderAdapter extends OpenAICompatibleAdapter {
+    constructor(options = {}) {
+        super({
+            ...options,
+            providerId: "openrouter",
+            name: "OpenRouter AI Aggregator",
+            baseUrl: "https://openrouter.ai/api/v1",
+            customHeaders: {
+                "HTTP-Referer": options.siteUrl || "https://anantham.ai",
+                "X-Title": options.siteName || "Anantham V2",
+                ...options.customHeaders,
+            },
+        });
+    }
+    getCapabilities(_modelId) {
+        return {
+            supportsStreaming: true,
+            supportsTools: true,
+            supportsVision: true,
+            supportsAudio: false,
+            maxContextTokens: 128000,
+            maxOutputTokens: 4096,
+        };
+    }
+}
+//# sourceMappingURL=openrouter-adapter.js.map

package/dist/models/adapters/openrouter-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter-adapter.js","sourceRoot":"","sources":["../../../src/models/adapters/openrouter-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GAExB,MAAM,gCAAgC,CAAC;AAQxC;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,uBAAuB;IACpE,YAAY,UAA4C,EAAE;QACxD,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,8BAA8B;YACvC,aAAa,EAAE;gBACb,cAAc,EAAE,OAAO,CAAC,OAAO,IAAI,qBAAqB;gBACxD,SAAS,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa;gBAC5C,GAAG,OAAO,CAAC,aAAa;aACzB;SACF,CAAC,CAAC;IACL,CAAC;IAEe,eAAe,CAAC,QAAgB;QAC9C,OAAO;YACL,iBAAiB,EAAE,IAAI;YACvB,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;YACpB,gBAAgB,EAAE,MAAM;YACxB,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/models/capability-profiles.d.ts

@@ -0,0 +1,6 @@
+import type { ModelCapabilityProfile } from "../domain/capability.js";
+export declare const GPT_4O_PROFILE: Readonly<ModelCapabilityProfile>;
+export declare const CLAUDE_3_5_SONNET_PROFILE: Readonly<ModelCapabilityProfile>;
+export declare const GEMINI_1_5_PRO_PROFILE: Readonly<ModelCapabilityProfile>;
+export declare const TEXT_ONLY_LOCAL_PROFILE: Readonly<ModelCapabilityProfile>;
+//# sourceMappingURL=capability-profiles.d.ts.map

package/dist/models/capability-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-profiles.d.ts","sourceRoot":"","sources":["../../src/models/capability-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,sBAAsB,CAiC1D,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,sBAAsB,CAiCrE,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB,CAiClE,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,sBAAsB,CAiCnE,CAAC"}

package/dist/models/capability-profiles.js

@@ -0,0 +1,137 @@
+export const GPT_4O_PROFILE = Object.freeze({
+    modelId: "gpt-4o",
+    providerId: "openai",
+    inputs: {
+        textInput: true,
+        imageInput: true,
+        audioInput: true,
+        videoInput: false,
+        documentInput: true,
+    },
+    outputs: {
+        textOutput: true,
+        imageOutput: false,
+        audioOutput: true,
+        videoOutput: false,
+    },
+    features: {
+        toolCalling: true,
+        parallelToolCalls: true,
+        structuredOutput: true,
+        jsonSchema: true,
+        streaming: true,
+        reasoning: false,
+        computerUse: false,
+        webSearch: false,
+        codeExecution: false,
+        promptCaching: false,
+    },
+    limits: {
+        contextWindow: 128000,
+        maxOutputTokens: 16384,
+    },
+    status: "valid",
+});
+export const CLAUDE_3_5_SONNET_PROFILE = Object.freeze({
+    modelId: "claude-3-5-sonnet",
+    providerId: "anthropic",
+    inputs: {
+        textInput: true,
+        imageInput: true,
+        audioInput: false,
+        videoInput: false,
+        documentInput: true,
+    },
+    outputs: {
+        textOutput: true,
+        imageOutput: false,
+        audioOutput: false,
+        videoOutput: false,
+    },
+    features: {
+        toolCalling: true,
+        parallelToolCalls: true,
+        structuredOutput: true,
+        jsonSchema: true,
+        streaming: true,
+        reasoning: false,
+        computerUse: true,
+        webSearch: false,
+        codeExecution: false,
+        promptCaching: true,
+    },
+    limits: {
+        contextWindow: 200000,
+        maxOutputTokens: 8192,
+    },
+    status: "valid",
+});
+export const GEMINI_1_5_PRO_PROFILE = Object.freeze({
+    modelId: "gemini-1.5-pro",
+    providerId: "google",
+    inputs: {
+        textInput: true,
+        imageInput: true,
+        audioInput: true,
+        videoInput: true,
+        documentInput: true,
+    },
+    outputs: {
+        textOutput: true,
+        imageOutput: false,
+        audioOutput: false,
+        videoOutput: false,
+    },
+    features: {
+        toolCalling: true,
+        parallelToolCalls: true,
+        structuredOutput: true,
+        jsonSchema: true,
+        streaming: true,
+        reasoning: false,
+        computerUse: false,
+        webSearch: true,
+        codeExecution: true,
+        promptCaching: true,
+    },
+    limits: {
+        contextWindow: 2000000,
+        maxOutputTokens: 8192,
+    },
+    status: "valid",
+});
+export const TEXT_ONLY_LOCAL_PROFILE = Object.freeze({
+    modelId: "local-llama-3-8b",
+    providerId: "ollama",
+    inputs: {
+        textInput: true,
+        imageInput: false,
+        audioInput: false,
+        videoInput: false,
+        documentInput: false,
+    },
+    outputs: {
+        textOutput: true,
+        imageOutput: false,
+        audioOutput: false,
+        videoOutput: false,
+    },
+    features: {
+        toolCalling: true,
+        parallelToolCalls: false,
+        structuredOutput: false,
+        jsonSchema: false,
+        streaming: true,
+        reasoning: false,
+        computerUse: false,
+        webSearch: false,
+        codeExecution: false,
+        promptCaching: false,
+    },
+    limits: {
+        contextWindow: 8192,
+        maxOutputTokens: 2048,
+    },
+    status: "valid",
+});
+//# sourceMappingURL=capability-profiles.js.map

package/dist/models/capability-profiles.js.map

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

package/dist/models/capability-resolver.d.ts

@@ -0,0 +1,15 @@
+import { type CapabilityRequirement, type CapabilityResolutionResult, type ModelCapabilityProfile } from "../domain/capability.js";
+import type { ProviderCapabilities } from "./provider-adapter.js";
+export interface CapabilityResolverOptions {
+    providerCapabilities?: ProviderCapabilities;
+    strictStaleness?: boolean;
+}
+export declare class CapabilityResolver {
+    /**
+     * Deterministically evaluates whether a ModelCapabilityProfile meets requested
+     * operational CapabilityRequirements.
+     * PRD Part 1 Section 83 & PRD Part 2 Section 41.
+     */
+    static resolve(profile: ModelCapabilityProfile, requirements: CapabilityRequirement, options?: CapabilityResolverOptions): CapabilityResolutionResult;
+}
+//# sourceMappingURL=capability-resolver.d.ts.map

package/dist/models/capability-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-resolver.d.ts","sourceRoot":"","sources":["../../src/models/capability-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAE/B,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,kBAAkB;IAC7B;;;;OAIG;WACW,OAAO,CACnB,OAAO,EAAE,sBAAsB,EAC/B,YAAY,EAAE,qBAAqB,EACnC,OAAO,CAAC,EAAE,yBAAyB,GAClC,0BAA0B;CAqL9B"}

package/dist/models/capability-resolver.js

@@ -0,0 +1,175 @@
+import { CapabilityResolutionResultSchema, CapabilityRequirementSchema, ModelCapabilityProfileSchema, } from "../domain/capability.js";
+export class CapabilityResolver {
+    /**
+     * Deterministically evaluates whether a ModelCapabilityProfile meets requested
+     * operational CapabilityRequirements.
+     * PRD Part 1 Section 83 & PRD Part 2 Section 41.
+     */
+    static resolve(profile, requirements, options) {
+        const validatedProfile = ModelCapabilityProfileSchema.parse(profile);
+        const validatedReq = CapabilityRequirementSchema.parse(requirements);
+        const missingCapabilities = [];
+        const insufficientLimits = [];
+        const conflicts = [];
+        // 1. Profile Status Checks
+        if (validatedProfile.status === "unknown") {
+            return Object.freeze(CapabilityResolutionResultSchema.parse({
+                compatible: false,
+                status: "UNKNOWN",
+                missingCapabilities: [],
+                insufficientLimits: [],
+                conflicts: [],
+                explanation: `Model capability profile for '${validatedProfile.modelId}' is unknown or unavailable.`,
+            }));
+        }
+        if (validatedProfile.status === "invalid") {
+            return Object.freeze(CapabilityResolutionResultSchema.parse({
+                compatible: false,
+                status: "INCOMPATIBLE",
+                missingCapabilities: ["valid_profile_metadata"],
+                insufficientLimits: [],
+                conflicts: [],
+                explanation: `Model capability profile for '${validatedProfile.modelId}' is marked invalid.`,
+            }));
+        }
+        if (validatedProfile.status === "stale" && options?.strictStaleness) {
+            conflicts.push("profile_stale");
+        }
+        // 2. Input Modalities
+        if (validatedReq.requiredInputs) {
+            for (const input of validatedReq.requiredInputs) {
+                if (input === "text" && !validatedProfile.inputs.textInput) {
+                    missingCapabilities.push("input:text");
+                }
+                else if (input === "image" && !validatedProfile.inputs.imageInput) {
+                    missingCapabilities.push("input:image");
+                }
+                else if (input === "audio" && !validatedProfile.inputs.audioInput) {
+                    missingCapabilities.push("input:audio");
+                }
+                else if (input === "video" && !validatedProfile.inputs.videoInput) {
+                    missingCapabilities.push("input:video");
+                }
+                else if (input === "document" && !validatedProfile.inputs.documentInput) {
+                    missingCapabilities.push("input:document");
+                }
+            }
+        }
+        // 3. Output Modalities
+        if (validatedReq.requiredOutputs) {
+            for (const output of validatedReq.requiredOutputs) {
+                if (output === "text" && !validatedProfile.outputs.textOutput) {
+                    missingCapabilities.push("output:text");
+                }
+                else if (output === "image" && !validatedProfile.outputs.imageOutput) {
+                    missingCapabilities.push("output:image");
+                }
+                else if (output === "audio" && !validatedProfile.outputs.audioOutput) {
+                    missingCapabilities.push("output:audio");
+                }
+                else if (output === "video" && !validatedProfile.outputs.videoOutput) {
+                    missingCapabilities.push("output:video");
+                }
+            }
+        }
+        // 4. Execution Features & Dependencies
+        if (validatedReq.requiredFeatures) {
+            for (const feature of validatedReq.requiredFeatures) {
+                if (!validatedProfile.features[feature]) {
+                    missingCapabilities.push(`feature:${feature}`);
+                }
+            }
+            // Feature dependencies
+            if (validatedReq.requiredFeatures.includes("parallelToolCalls") &&
+                !validatedProfile.features.toolCalling) {
+                conflicts.push("parallelToolCalls_requires_toolCalling");
+            }
+            if (validatedReq.requiredFeatures.includes("jsonSchema") &&
+                !validatedProfile.features.structuredOutput) {
+                conflicts.push("jsonSchema_requires_structuredOutput");
+            }
+        }
+        // 5. Quantitative Token Limits
+        if (validatedReq.minContextTokens) {
+            if (validatedReq.minContextTokens > validatedProfile.limits.contextWindow) {
+                insufficientLimits.push({
+                    limit: "contextWindow",
+                    required: validatedReq.minContextTokens,
+                    supported: validatedProfile.limits.contextWindow,
+                });
+            }
+        }
+        if (validatedReq.requiredOutputTokens) {
+            if (validatedReq.requiredOutputTokens > validatedProfile.limits.maxOutputTokens) {
+                insufficientLimits.push({
+                    limit: "maxOutputTokens",
+                    required: validatedReq.requiredOutputTokens,
+                    supported: validatedProfile.limits.maxOutputTokens,
+                });
+            }
+        }
+        // 6. Provider Adapter Constraints Overlay
+        if (options?.providerCapabilities) {
+            const pCaps = options.providerCapabilities;
+            if (validatedReq.requiredFeatures?.includes("streaming") && !pCaps.supportsStreaming) {
+                missingCapabilities.push("provider:streaming");
+            }
+            if (validatedReq.requiredFeatures?.includes("toolCalling") && !pCaps.supportsTools) {
+                missingCapabilities.push("provider:tools");
+            }
+            if (validatedReq.requiredInputs?.includes("image") && !pCaps.supportsVision) {
+                missingCapabilities.push("provider:vision");
+            }
+            if (validatedReq.requiredInputs?.includes("audio") && !pCaps.supportsAudio) {
+                missingCapabilities.push("provider:audio");
+            }
+        }
+        // 7. Synthesize Result Status
+        const isCompatible = missingCapabilities.length === 0 &&
+            insufficientLimits.length === 0 &&
+            conflicts.length === 0;
+        let status;
+        if (isCompatible) {
+            status = "COMPATIBLE";
+        }
+        else if (insufficientLimits.length > 0 && missingCapabilities.length === 0 && conflicts.length === 0) {
+            status = "LIMIT_EXCEEDED";
+        }
+        else {
+            status = "INCOMPATIBLE";
+        }
+        // Build operational explanation
+        let explanation;
+        if (status === "COMPATIBLE") {
+            explanation = `Model '${validatedProfile.modelId}' fully satisfies requested capabilities and limits.`;
+        }
+        else if (status === "LIMIT_EXCEEDED") {
+            const limitDetails = insufficientLimits
+                .map((l) => `${l.limit} (required ${l.required} > supported ${l.supported})`)
+                .join(", ");
+            explanation = `Model '${validatedProfile.modelId}' exceeds token capacity limits: ${limitDetails}.`;
+        }
+        else {
+            const reasons = [];
+            if (missingCapabilities.length > 0) {
+                reasons.push(`missing: [${missingCapabilities.join(", ")}]`);
+            }
+            if (insufficientLimits.length > 0) {
+                reasons.push(`insufficient limits: [${insufficientLimits.map((l) => l.limit).join(", ")}]`);
+            }
+            if (conflicts.length > 0) {
+                reasons.push(`conflicts: [${conflicts.join(", ")}]`);
+            }
+            explanation = `Model '${validatedProfile.modelId}' incompatible: ${reasons.join("; ")}.`;
+        }
+        return Object.freeze(CapabilityResolutionResultSchema.parse({
+            compatible: isCompatible,
+            status,
+            missingCapabilities,
+            insufficientLimits,
+            conflicts,
+            explanation,
+        }));
+    }
+}
+//# sourceMappingURL=capability-resolver.js.map

package/dist/models/capability-resolver.js.map

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

package/dist/models/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./model-errors.js";
+export * from "./provider-adapter.js";
+export * from "./mock-provider-adapter.js";
+export * from "./capability-profiles.js";
+export * from "./capability-resolver.js";
+export * from "./model-router.js";
+export * from "./secret-store.js";
+export * from "./provider-health-tracker.js";
+export * from "./key-pool-manager.js";
+export * from "./provider-registry.js";
+export * from "./adapters/openai-compatible-adapter.js";
+export * from "./adapters/anthropic-compatible-adapter.js";
+export * from "./adapters/gemini-adapter.js";
+export * from "./adapters/openrouter-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,15 @@
+export * from "./model-errors.js";
+export * from "./provider-adapter.js";
+export * from "./mock-provider-adapter.js";
+export * from "./capability-profiles.js";
+export * from "./capability-resolver.js";
+export * from "./model-router.js";
+export * from "./secret-store.js";
+export * from "./provider-health-tracker.js";
+export * from "./key-pool-manager.js";
+export * from "./provider-registry.js";
+export * from "./adapters/openai-compatible-adapter.js";
+export * from "./adapters/anthropic-compatible-adapter.js";
+export * from "./adapters/gemini-adapter.js";
+export * from "./adapters/openrouter-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC"}

package/dist/models/key-pool-manager.d.ts

@@ -0,0 +1,38 @@
+import { type CredentialReference, type KeyLease, type KeyPool } from "../domain/auth.js";
+import { type SecretStore } from "./secret-store.js";
+export interface KeyAcquisitionResult {
+    success: boolean;
+    lease?: KeyLease;
+    credential?: CredentialReference;
+    rawSecret?: string;
+    rejectionReason?: string;
+}
+export declare class KeyPoolManager {
+    private pools;
+    private credentials;
+    private activeLeases;
+    private secretStore;
+    constructor(secretStore?: SecretStore);
+    registerPool(pool: KeyPool): void;
+    addCredential(credential: CredentialReference, rawSecret?: string): Promise<void>;
+    getCredential(credentialId: string): CredentialReference | undefined;
+    listCredentials(providerId?: string): CredentialReference[];
+    /**
+     * Deterministically selects an eligible credential and issues a KeyLease.
+     */
+    acquireKey(providerId: string, options?: {
+        ownerTaskId?: string;
+    }): Promise<KeyAcquisitionResult>;
+    /**
+     * Releases an active key lease, updating concurrency and applying cooldown on error.
+     */
+    releaseKey(leaseId: string, options?: {
+        isError?: boolean;
+        cooldownMs?: number;
+    }): void;
+    /**
+     * Reclaims orphaned/stale leases after process crash or abnormal termination.
+     */
+    reclaimStaleLeases(maxAgeMs?: number): number;
+}
+//# sourceMappingURL=key-pool-manager.d.ts.map

package/dist/models/key-pool-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-pool-manager.d.ts","sourceRoot":"","sources":["../../src/models/key-pool-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,OAAO,EAIb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,mBAAmB,CAAC;AAG1E,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,WAAW,CAAc;gBAErB,WAAW,CAAC,EAAE,WAAW;IAI9B,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK3B,aAAa,CAAC,UAAU,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvF,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIpE,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAQlE;;OAEG;IACU,UAAU,CACrB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GACrC,OAAO,CAAC,oBAAoB,CAAC;IAgFhC;;OAEG;IACI,UAAU,CACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GACvD,IAAI;IA4BP;;OAEG;IACI,kBAAkB,CAAC,QAAQ,SAAQ,GAAG,MAAM;CAcpD"}

package/dist/models/key-pool-manager.js

@@ -0,0 +1,157 @@
+import { CredentialReferenceSchema, KeyLeaseSchema, KeyPoolSchema, } from "../domain/auth.js";
+import { InMemorySecretStore } from "./secret-store.js";
+import { randomUUID } from "node:crypto";
+export class KeyPoolManager {
+    pools = new Map();
+    credentials = new Map();
+    activeLeases = new Map();
+    secretStore;
+    constructor(secretStore) {
+        this.secretStore = secretStore || new InMemorySecretStore();
+    }
+    registerPool(pool) {
+        const validated = KeyPoolSchema.parse(pool);
+        this.pools.set(validated.providerId, validated);
+    }
+    async addCredential(credential, rawSecret) {
+        const validated = CredentialReferenceSchema.parse(credential);
+        this.credentials.set(validated.credentialId, validated);
+        if (rawSecret) {
+            await this.secretStore.setSecret(validated.credentialId, rawSecret);
+        }
+        // Add to pool if pool exists
+        const pool = this.pools.get(validated.providerId);
+        if (pool) {
+            const existingIdx = pool.members.findIndex((m) => m.credentialId === validated.credentialId);
+            if (existingIdx >= 0) {
+                pool.members[existingIdx] = validated;
+            }
+            else {
+                pool.members.push(validated);
+            }
+        }
+    }
+    getCredential(credentialId) {
+        return this.credentials.get(credentialId);
+    }
+    listCredentials(providerId) {
+        const all = Array.from(this.credentials.values());
+        if (providerId) {
+            return all.filter((c) => c.providerId === providerId);
+        }
+        return all;
+    }
+    /**
+     * Deterministically selects an eligible credential and issues a KeyLease.
+     */
+    async acquireKey(providerId, options = {}) {
+        const pool = this.pools.get(providerId);
+        const candidates = pool
+            ? pool.members
+            : Array.from(this.credentials.values()).filter((c) => c.providerId === providerId);
+        if (candidates.length === 0) {
+            return {
+                success: false,
+                rejectionReason: `No credentials configured for provider '${providerId}'`,
+            };
+        }
+        const now = new Date();
+        const nowIso = now.toISOString();
+        // 1. Filter eligible candidates
+        const eligible = [];
+        for (const cred of candidates) {
+            // Disabled / expired / invalid checks
+            if (cred.status === "disabled" || cred.status === "expired" || cred.status === "invalid" || cred.status === "revoked") {
+                continue;
+            }
+            // Cooldown check
+            if (cred.cooldownUntil && new Date(cred.cooldownUntil) > now) {
+                continue;
+            }
+            // Concurrency limit check
+            if (cred.concurrencyCount >= cred.maxConcurrent) {
+                continue;
+            }
+            eligible.push(cred);
+        }
+        if (eligible.length === 0) {
+            return {
+                success: false,
+                rejectionReason: `All credentials for provider '${providerId}' are exhausted, in cooldown, or over concurrency limits`,
+            };
+        }
+        // 2. Deterministic selection: least busy (lowest concurrencyCount)
+        eligible.sort((a, b) => a.concurrencyCount - b.concurrencyCount);
+        const selected = eligible[0];
+        if (!selected) {
+            return {
+                success: false,
+                rejectionReason: `No eligible candidate found for provider '${providerId}'`,
+            };
+        }
+        // 3. Acquire Lease
+        const leaseId = `lease_${randomUUID().slice(0, 8)}`;
+        const lease = KeyLeaseSchema.parse({
+            leaseId,
+            credentialId: selected.credentialId,
+            providerId: selected.providerId,
+            ownerTaskId: options.ownerTaskId,
+            acquiredAt: nowIso,
+            status: "active",
+        });
+        selected.concurrencyCount += 1;
+        selected.lastUsedAt = nowIso;
+        this.activeLeases.set(leaseId, lease);
+        const rawSecret = await this.secretStore.getSecret(selected.credentialId);
+        return {
+            success: true,
+            lease,
+            credential: selected,
+            rawSecret,
+        };
+    }
+    /**
+     * Releases an active key lease, updating concurrency and applying cooldown on error.
+     */
+    releaseKey(leaseId, options = {}) {
+        const lease = this.activeLeases.get(leaseId);
+        if (!lease || lease.status !== "active") {
+            return;
+        }
+        lease.status = "released";
+        lease.releasedAt = new Date().toISOString();
+        this.activeLeases.delete(leaseId);
+        const cred = this.credentials.get(lease.credentialId);
+        if (cred) {
+            cred.concurrencyCount = Math.max(0, cred.concurrencyCount - 1);
+            if (options.isError) {
+                cred.failureCount += 1;
+                if (options.cooldownMs && options.cooldownMs > 0) {
+                    cred.status = "cooldown";
+                    cred.cooldownUntil = new Date(Date.now() + options.cooldownMs).toISOString();
+                }
+            }
+            else {
+                cred.status = "available";
+                cred.cooldownUntil = undefined;
+                cred.failureCount = 0;
+            }
+        }
+    }
+    /**
+     * Reclaims orphaned/stale leases after process crash or abnormal termination.
+     */
+    reclaimStaleLeases(maxAgeMs = 60000) {
+        const now = Date.now();
+        let reclaimed = 0;
+        for (const [leaseId, lease] of this.activeLeases.entries()) {
+            const age = now - new Date(lease.acquiredAt).getTime();
+            if (age > maxAgeMs) {
+                this.releaseKey(leaseId, { isError: true });
+                reclaimed += 1;
+            }
+        }
+        return reclaimed;
+    }
+}
+//# sourceMappingURL=key-pool-manager.js.map

package/dist/models/key-pool-manager.js.map

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