@aeye/ai 0.1.0

package/dist/apis/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../../src/apis/speech.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,MAAM,OAAO,SAAiC,SAAQ,OAKrD;IACC,YAAY,EAAS;QACnB,KAAK,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC;IAED,+EAA+E;IAC/E,2CAA2C;IAC3C,+EAA+E;IAErE,uBAAuB,CAAC,QAA2B,EAAE,OAAsB,EAAE,YAAqB;QAC1G,OAAO,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IAChC,CAAC;IAES,qBAAqB,CAAC,QAA0B,EAAE,OAAsB,EAAE,YAAqB;QACvG,MAAM,MAAM,GAAG,IAAI,GAAG,CAAiB,QAAQ,CAAC,CAAC;QAEjD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAES,oBAAoB;QAC5B,OAAO,iDAAiD,CAAC;IAC3D,CAAC;IAES,YAAY,CAAC,SAA+B;QACpD,OAAO,SAAS,KAAK,SAAS;YAC5B,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,iCAAiC,CAAC;IACxC,CAAC;IAES,eAAe,CAAC,SAA+B;QACvD,OAAO,SAAS,KAAK,SAAS;YAC5B,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,oCAAoC,CAAC;IAC3C,CAAC;IAES,KAAK,CAAC,cAAc,CAC5B,OAAsB,EACtB,QAA6B,EAC7B,GAAiB;QAEjB,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAO,CACpC,OAAO,EACP,GAAG,EACH,QAAQ,CAAC,cAAc,CACxB,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,CAAC,oBAAoB,CACnC,OAAsB,EACtB,QAA6B,EAC7B,GAAiB;QAEjB,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,+EAA+E;IAC/E,qBAAqB;IACrB,+EAA+E;IAErE,oBAAoB,CAAC,OAAsB;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClD,0FAA0F;QAC1F,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;QACzD,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,EAAE,CAAC;QAE/C,OAAO;YACL,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM;aACd;YACD,KAAK,EAAE;gBACL,OAAO,EAAE,gBAAgB;aAC1B;SACF,CAAC;IACJ,CAAC;IAES,gBAAgB,CAAC,QAAwB;QACjD,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IAES,gBAAgB,CAAC,MAAwB,EAAE,KAAa;QAChE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAES,mBAAmB,CAC3B,OAA4B;QAE5B,OAAO,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC;IAC9B,CAAC;IAES,sBAAsB,CAC9B,OAA4B;QAE5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAES,mBAAmB,CAAC,QAA6B;QACzD,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;IACpC,CAAC;IAES,mBAAmB,CAAC,QAA6B;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/apis/transcribe.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Transcribe API
+ *
+ * Provides speech-to-text functionality.
+ */
+import type { AI } from '../ai';
+import type { AIBaseTypes, AIContext, ModelCapability, ModelHandlerFor, ModelParameter, SelectedModelFor, TranscriptionChunk, TranscriptionRequest, TranscriptionResponse, Usage } from '../types';
+import { BaseAPI } from './base';
+export declare class TranscribeAPI<T extends AIBaseTypes> extends BaseAPI<T, TranscriptionRequest, TranscriptionResponse, TranscriptionChunk> {
+    constructor(ai: AI<T>);
+    protected getRequiredCapabilities(provided: ModelCapability[], request: TranscriptionRequest, forStreaming: boolean): ModelCapability[];
+    protected getRequiredParameters(provided: ModelParameter[], request: TranscriptionRequest, forStreaming: boolean): ModelParameter[];
+    protected getNoModelFoundError(): string;
+    protected getErrorType(): string;
+    protected getErrorMessage(): string;
+    protected executeRequest(request: TranscriptionRequest, selected: SelectedModelFor<T>, ctx: AIContext<T>): Promise<TranscriptionResponse>;
+    protected estimateRequestUsage(): Usage;
+    protected executeStreamRequest(request: TranscriptionRequest, selected: SelectedModelFor<T>, ctx: AIContext<T>): AsyncIterable<TranscriptionChunk>;
+    protected responseToChunks(response: TranscriptionResponse): TranscriptionChunk[];
+    protected chunksToResponse(chunks: TranscriptionChunk[], givenModel: string): TranscriptionResponse;
+    protected getHandlerGetMethod(handler?: ModelHandlerFor<T>): ((request: TranscriptionRequest, ctx: AIContext<T>) => Promise<TranscriptionResponse>) | undefined;
+    protected getHandlerStreamMethod(handler?: ModelHandlerFor<T>): ((request: TranscriptionRequest, ctx: AIContext<T>) => AsyncIterable<TranscriptionChunk>) | undefined;
+    protected hasProviderExecutor(selected: SelectedModelFor<T>): boolean;
+    protected hasProviderStreamer(selected: SelectedModelFor<T>): boolean;
+}
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/apis/transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../../src/apis/transcribe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,EACN,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,qBAAa,aAAa,CAAC,CAAC,SAAS,WAAW,CAAE,SAAQ,OAAO,CAC/D,CAAC,EACD,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,CACnB;gBACa,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAQrB,SAAS,CAAC,uBAAuB,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,OAAO,GAAG,eAAe,EAAE;IAIvI,SAAS,CAAC,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,OAAO,GAAG,cAAc,EAAE;IAanI,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAIxC,SAAS,CAAC,YAAY,IAAI,MAAM;IAIhC,SAAS,CAAC,eAAe,IAAI,MAAM;cAInB,cAAc,CAC5B,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC7B,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAChB,OAAO,CAAC,qBAAqB,CAAC;IAYjC,SAAS,CAAC,oBAAoB,IAAI,KAAK;cAiBtB,oBAAoB,CACnC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC7B,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAChB,aAAa,CAAC,kBAAkB,CAAC;IAYpC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,kBAAkB,EAAE;IAQjF,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,qBAAqB;IAuBnG,SAAS,CAAC,mBAAmB,CAC3B,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,SAAS;IAIrG,SAAS,CAAC,sBAAsB,CAC9B,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,kBAAkB,CAAC,CAAC,GAAG,SAAS;IAIxG,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO;IAIrE,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO;CAGtE"}

package/dist/apis/transcribe.js

@@ -0,0 +1,103 @@
+/**
+ * Transcribe API
+ *
+ * Provides speech-to-text functionality.
+ */
+import { BaseAPI } from './base';
+export class TranscribeAPI extends BaseAPI {
+    constructor(ai) {
+        super(ai);
+    }
+    // ============================================================================
+    // REQUIRED ABSTRACT METHOD IMPLEMENTATIONS
+    // ============================================================================
+    getRequiredCapabilities(provided, request, forStreaming) {
+        return ['hearing', ...provided];
+    }
+    getRequiredParameters(provided, request, forStreaming) {
+        const params = new Set();
+        if (request.prompt !== undefined) {
+            params.add('transcribePrompt');
+        }
+        if (forStreaming) {
+            params.add('transcribeStream');
+        }
+        return Array.from(params);
+    }
+    getNoModelFoundError() {
+        return 'No compatible model found for transcription';
+    }
+    getErrorType() {
+        return 'transcription-failed';
+    }
+    getErrorMessage() {
+        return 'Transcription failed';
+    }
+    async executeRequest(request, selected, ctx) {
+        return await selected.provider.transcribe(request, ctx, selected.providerConfig);
+    }
+    // ============================================================================
+    // OPTIONAL OVERRIDES
+    // ============================================================================
+    estimateRequestUsage() {
+        // Default estimate for audio transcription
+        // Assume 1 minute of audio ~ 200 tokens of output
+        const estimatedMinutes = 1;
+        const estimatedTokens = estimatedMinutes * 200;
+        return {
+            audio: {
+                seconds: estimatedMinutes * 60,
+                input: 1000 // Rough estimate for audio input tokens
+            },
+            text: {
+                output: estimatedTokens
+            }
+        };
+    }
+    async *executeStreamRequest(request, selected, ctx) {
+        if (!selected.provider.transcribeStream) {
+            throw new Error(`Provider ${selected.model.provider} does not support streaming transcription`);
+        }
+        yield* selected.provider.transcribeStream(request, ctx, selected.providerConfig);
+    }
+    responseToChunks(response) {
+        return [{
+                text: response.text,
+                model: response.model,
+                usage: response.usage,
+            }];
+    }
+    chunksToResponse(chunks, givenModel) {
+        let text = '';
+        let model = givenModel;
+        let usage;
+        for (const chunk of chunks) {
+            if (chunk.model) {
+                model = chunk.model;
+            }
+            if (chunk.usage) {
+                usage = chunk.usage;
+            }
+            if (chunk.delta) {
+                text += chunk.delta;
+            }
+            if (chunk.text) {
+                text = chunk.text;
+            }
+        }
+        return { text, model, usage };
+    }
+    getHandlerGetMethod(handler) {
+        return handler?.transcribe?.get;
+    }
+    getHandlerStreamMethod(handler) {
+        return handler?.transcribe?.stream;
+    }
+    hasProviderExecutor(selected) {
+        return !!selected.provider.transcribe;
+    }
+    hasProviderStreamer(selected) {
+        return !!selected.provider.transcribeStream;
+    }
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/apis/transcribe.js.map

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

package/dist/common.d.ts

@@ -0,0 +1,10 @@
+import { ModelInput } from "@aeye/core";
+import { ModelInfo } from "./types";
+/**
+* Type guard to check if a ModelInput is a ModelInfo object.
+*
+* @param input - The model input to check.
+* @returns True if the input is a ModelInfo object, false otherwise.
+*/
+export declare function isModelInfo<TProvider extends string = string>(input: ModelInput): input is ModelInfo<TProvider>;
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;EAKE;AACF,wBAAgB,WAAW,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,KAAK,IAAI,SAAS,CAAC,SAAS,CAAC,CAS/G"}

package/dist/common.js

@@ -0,0 +1,17 @@
+/**
+* Type guard to check if a ModelInput is a ModelInfo object.
+*
+* @param input - The model input to check.
+* @returns True if the input is a ModelInfo object, false otherwise.
+*/
+export function isModelInfo(input) {
+    return typeof input === 'object'
+        && ('id' in input)
+        && ('provider' in input)
+        && ('name' in input)
+        && ('capabilities' in input)
+        && ('tier' in input)
+        && ('pricing' in input)
+        && ('contextWindow' in input);
+}
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAGA;;;;;EAKE;AACF,MAAM,UAAU,WAAW,CAAoC,KAAiB;IAC9E,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,CAAC,IAAI,IAAI,KAAK,CAAC;WACf,CAAC,UAAU,IAAI,KAAK,CAAC;WACrB,CAAC,MAAM,IAAI,KAAK,CAAC;WACjB,CAAC,cAAc,IAAI,KAAK,CAAC;WACzB,CAAC,MAAM,IAAI,KAAK,CAAC;WACjB,CAAC,SAAS,IAAI,KAAK,CAAC;WACpB,CAAC,eAAe,IAAI,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AI Library (Instance-Based API)
+ *
+ * Main export file for the class-based AI library.
+ */
+export * from './types';
+export * from './modelDetection';
+export * from './ai';
+export * from './registry';
+export * from './apis/models';
+export * from './apis/base';
+export * from './apis/chat';
+export * from './apis/embed';
+export * from './apis/image';
+export * from './apis/speech';
+export * from './apis/transcribe';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * AI Library (Instance-Based API)
+ *
+ * Main export file for the class-based AI library.
+ */
+export * from './types';
+export * from './modelDetection';
+export * from './ai';
+export * from './registry';
+export * from './apis/models';
+export * from './apis/base';
+export * from './apis/chat';
+export * from './apis/embed';
+export * from './apis/image';
+export * from './apis/speech';
+export * from './apis/transcribe';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/dist/modelDetection.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Model Detection Utilities
+ *
+ * Shared utilities for detecting model capabilities, tiers, and other metadata
+ * independently of provider implementations. This allows providers to be used
+ * interchangeably (e.g., using OpenAI models through OpenRouter).
+ */
+import type { ModelCapability, ModelTier } from './types';
+/**
+ * Model metadata for capability detection
+ */
+export interface ModelMetadata {
+    id: string;
+    name: string;
+    modality?: string;
+    capabilities?: string[];
+}
+/**
+ * Detect model tier from model name
+ * Note: This should only be used as a fallback when provider doesn't provide tier info
+ */
+export declare function detectTier(name: string): ModelTier;
+/**
+ * Detect capabilities from modality string (OpenRouter format)
+ */
+export declare function detectCapabilitiesFromModality(modality: string, modelId: string): Set<ModelCapability>;
+/**
+ * Detect ZDR (Zero Data Retention) support from provider metadata
+ */
+export declare function detectZDRFromModeration(isModerated: boolean): boolean;
+//# sourceMappingURL=modelDetection.d.ts.map

package/dist/modelDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelDetection.d.ts","sourceRoot":"","sources":["../src/modelDetection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAgClD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,GAAG,CAAC,eAAe,CAAC,CAsCtB;AAGD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAGrE"}

package/dist/modelDetection.js

@@ -0,0 +1,78 @@
+/**
+ * Model Detection Utilities
+ *
+ * Shared utilities for detecting model capabilities, tiers, and other metadata
+ * independently of provider implementations. This allows providers to be used
+ * interchangeably (e.g., using OpenAI models through OpenRouter).
+ */
+/**
+ * Detect model tier from model name
+ * Note: This should only be used as a fallback when provider doesn't provide tier info
+ */
+export function detectTier(name) {
+    const n = name.toLowerCase();
+    // Check name for tier indicators
+    if (n.includes('flagship')) {
+        return 'flagship';
+    }
+    if (n.includes('preview') ||
+        n.includes('experimental') ||
+        n.includes('alpha') ||
+        n.includes('beta')) {
+        return 'experimental';
+    }
+    if (n.includes('legacy')) {
+        return 'legacy';
+    }
+    if (n.includes('mini') ||
+        n.includes('small') ||
+        n.includes('haiku') ||
+        n.includes('efficient')) {
+        return 'efficient';
+    }
+    // Default to flagship (assume modern model if no indicators)
+    return 'flagship';
+}
+/**
+ * Detect capabilities from modality string (OpenRouter format)
+ */
+export function detectCapabilitiesFromModality(modality, modelId) {
+    const capabilities = new Set();
+    const lowerModality = modality.toLowerCase();
+    const [input, output = input] = lowerModality.split('->').map((s) => s.trim());
+    // Text capabilities
+    if (output.includes('text')) {
+        capabilities.add('chat');
+        capabilities.add('json');
+        capabilities.add('tools');
+        // structured output can't be detected from this
+    }
+    // Vision capabilities
+    if (input.includes('image')) {
+        capabilities.add('vision');
+    }
+    // Image generation
+    if (output.includes('image')) {
+        capabilities.add('image');
+    }
+    // Audio capabilities
+    if (input.includes('audio')) {
+        capabilities.add('hearing');
+    }
+    if (output.includes('audio')) {
+        capabilities.add('audio');
+    }
+    // Embedding
+    if (output.includes('embedding') || output.includes('vector')) {
+        capabilities.add('embedding');
+    }
+    return capabilities;
+}
+/**
+ * Detect ZDR (Zero Data Retention) support from provider metadata
+ */
+export function detectZDRFromModeration(isModerated) {
+    // If a model is NOT moderated, it typically means ZDR is supported
+    return !isModerated;
+}
+//# sourceMappingURL=modelDetection.js.map

package/dist/modelDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelDetection.js","sourceRoot":"","sources":["../src/modelDetection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAE7B,iCAAiC;IACjC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IACE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC1B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAClB,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IACE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EACvB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,6DAA6D;IAC7D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAAgB,EAChB,OAAe;IAEf,MAAM,YAAY,GAAG,IAAI,GAAG,EAAmB,CAAC;IAChD,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAE7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE/E,oBAAoB;IACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,gDAAgD;IAClD,CAAC;IAED,sBAAsB;IACtB,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,mBAAmB;IACnB,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,qBAAqB;IACrB,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,YAAY;IACZ,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAGD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAoB;IAC1D,mEAAmE;IACnE,OAAO,CAAC,WAAW,CAAC;AACtB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Model Registry
+ *
+ * Centralized model management with provider ordering and adapter registration.
+ * Provider order ensures deterministic model resolution: first provider to return a model ID wins.
+ */
+import type { AIBaseMetadata, ModelCapability, ModelHandler, ModelInfo, ModelOverride, ModelSelectionWeights, ModelSource, Provider, Providers, ScoredModel, SelectedModel } from './types';
+/**
+ * Determines which capabilities a provider supports based on its defined methods.
+ * Treats streaming and non-streaming methods as equivalent for capability detection.
+ *
+ * This is useful for:
+ * - Filtering providers during model selection
+ * - Validating provider compatibility before requests
+ * - Displaying provider capabilities in UI
+ *
+ * @param provider - The provider to inspect
+ * @returns Set of capabilities the provider supports
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { OpenAIProvider } from '@aeye/openai';
+ * import { getProviderCapabilities } from '@aeye/ai';
+ *
+ * const openai = new OpenAIProvider({ apiKey: '...' });
+ * const caps = getProviderCapabilities(openai);
+ * console.log(caps);
+ * // Set(['chat', 'streaming', 'image', 'audio', 'hearing', 'embedding'])
+ * ```
+ *
+ * @example Checking specific capability
+ * ```typescript
+ * const openrouter = new OpenRouterProvider({ apiKey: '...' });
+ * const caps = getProviderCapabilities(openrouter);
+ *
+ * if (caps.has('image')) {
+ *   console.log('Provider supports image generation');
+ * } else {
+ *   console.log('Provider does not support image generation');
+ * }
+ * // Output: "Provider does not support image generation"
+ * ```
+ *
+ * @example Filtering providers by capability
+ * ```typescript
+ * const providers = { openai, openrouter, anthropic };
+ * const imageProviders = Object.entries(providers)
+ *   .filter(([name, provider]) => getProviderCapabilities(provider).has('image'))
+ *   .map(([name]) => name);
+ * console.log(imageProviders); // ['openai']
+ * ```
+ */
+export declare function getProviderCapabilities(provider: Provider): Set<ModelCapability>;
+export declare class ModelRegistry<TProviders extends Providers, TProviderKey extends keyof TProviders & string = keyof TProviders & string, TProvider extends TProviders[TProviderKey] = TProviders[TProviderKey]> {
+    private models;
+    private modelHandlers;
+    private providers;
+    private providerCapabilities;
+    private modelSources;
+    private modelOverrides;
+    private defaultCostPerMillionTokens;
+    private defaultWeights?;
+    private weightProfiles;
+    constructor(providers: TProviders, modelOverrides?: ModelOverride[], defaultCostPerMillionTokens?: number, modelSources?: ModelSource[], defaultWeights?: ModelSelectionWeights, weightProfiles?: Record<string, ModelSelectionWeights>);
+    /**
+     * Add model sources to the registry
+     */
+    addModelSources(sources: ModelSource[]): void;
+    /**
+     * Register a model in the registry
+     *
+     * Always registers under two keys:
+     * - model.id (e.g., "gpt-4" or "openai/gpt-4")
+     * - provider/model.id (e.g., "openai/gpt-4" or "openrouter/openai/gpt-4")
+     *
+     * On collision, models are merged
+     */
+    registerModel(model: ModelInfo<TProviderKey>): void;
+    /**
+     * Register multiple models
+     */
+    registerModels(models: ModelInfo<TProviderKey>[]): void;
+    /**
+     * Get a model by ID (checks all providers in order)
+     */
+    getModel(id: string): ModelInfo<TProviderKey> | undefined;
+    /**
+     * Gets the provider to use for a given model ID
+     *
+     * @param id
+     * @returns
+     */
+    getProviderFor(id: string): [TProviderKey, TProvider] | [];
+    /**
+     * List all models
+     */
+    listModels(): ModelInfo<TProviderKey>[];
+    /**
+     * List models for which we have providers
+     */
+    providedModels(): ModelInfo<TProviderKey>[];
+    /**
+     * Search and score models based on criteria
+     */
+    searchModels(metadata: AIBaseMetadata<TProviders>): ScoredModel<TProviderKey>[];
+    /**
+     * Select best model based on criteria
+     */
+    selectModel(criteria: AIBaseMetadata<TProviders>): SelectedModel<TProviders, TProviderKey> | undefined;
+    /**
+     * Register a model handler
+     */
+    registerHandler(handler: ModelHandler<any>): void;
+    /**
+     * Get handler for a model
+     */
+    getHandler(provider: string, model: string): ModelHandler | undefined;
+    /**
+     * Get provider info
+     */
+    getProvider(name: TProviderKey): TProvider | undefined;
+    /**
+     * Get pre-computed capabilities for a provider
+     * @param name - Provider name
+     * @returns Set of capabilities the provider supports, or undefined if provider not found
+     */
+    getProviderCapabilities(name: TProviderKey): Set<ModelCapability> | undefined;
+    /**
+     * Score a model against criteria
+     */
+    private scoreModel;
+    /**
+     * Calculate weighted score for a model
+     */
+    private calculateWeightedScore;
+    /**
+     * Apply overrides to a model
+     */
+    private applyOverrides;
+    /**
+     * Merge two ModelInfo objects intelligently
+     * Prefers non-default values and combines capabilities
+     */
+    private mergeModelInfo;
+    /**
+     * Refresh models from all providers and model sources
+     */
+    refresh(): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

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