aistatus 0.0.2

package/dist/index.d.cts

@@ -0,0 +1,202 @@
+declare enum Status {
+    OPERATIONAL = "operational",
+    DEGRADED = "degraded",
+    DOWN = "down",
+    UNKNOWN = "unknown"
+}
+type MessageRole = "system" | "user" | "assistant" | "tool";
+interface ChatMessage {
+    role: MessageRole | (string & {});
+    content: string;
+    name?: string;
+    toolCallId?: string;
+}
+interface ProviderConfig {
+    slug: string;
+    adapterType: string;
+    apiKey?: string;
+    env?: string;
+    baseUrl?: string;
+    aliases?: string[];
+    headers?: Record<string, string>;
+}
+interface RouteConfig {
+    tier?: string;
+    model?: string;
+    prefer?: string[];
+    allowFallback?: boolean;
+    providerTimeout?: number;
+}
+interface ProviderCallOptions {
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    providerOptions?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+interface RouteOptions extends ProviderCallOptions {
+    model?: string;
+    tier?: string;
+    system?: string;
+    allowFallback?: boolean;
+    timeout?: number;
+    prefer?: string[];
+    [key: string]: unknown;
+}
+interface Alternative {
+    slug: string;
+    name: string;
+    status: Status;
+    suggestedModel: string;
+}
+declare class CheckResult {
+    provider: string;
+    status: Status;
+    statusDetail: string | null;
+    model: string | null;
+    alternatives: Alternative[];
+    constructor(init: {
+        provider: string;
+        status: Status;
+        statusDetail?: string | null;
+        model?: string | null;
+        alternatives?: Alternative[];
+    });
+    get isAvailable(): boolean;
+}
+interface ModelInfo {
+    id: string;
+    name: string;
+    providerSlug: string;
+    contextLength: number;
+    modality: string;
+    promptPrice: number;
+    completionPrice: number;
+}
+interface ProviderStatus {
+    slug: string;
+    name: string;
+    status: Status;
+    statusDetail: string | null;
+    modelCount: number;
+}
+interface RouteResponseInit {
+    content: string;
+    modelUsed: string;
+    providerUsed: string;
+    wasFallback: boolean;
+    fallbackReason?: string | null;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    raw?: unknown;
+}
+declare class RouteResponse {
+    content: string;
+    modelUsed: string;
+    providerUsed: string;
+    wasFallback: boolean;
+    fallbackReason: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+    raw: unknown;
+    constructor(init: RouteResponseInit);
+    toString(): string;
+}
+
+declare abstract class ProviderAdapter {
+    readonly config: ProviderConfig;
+    constructor(config: ProviderConfig);
+    get slug(): string;
+    get aliases(): string[];
+    supportsProvider(slug: string): boolean;
+    stripProvider(modelId: string): string;
+    abstract call(modelId: string, messages: ChatMessage[], timeoutSeconds: number, options: ProviderCallOptions): Promise<RouteResponse>;
+}
+type ProviderAdapterConstructor = new (config: ProviderConfig) => ProviderAdapter;
+declare function registerAdapterType(typeName: string, ctor: ProviderAdapterConstructor): void;
+declare function createAdapter(config: ProviderConfig): ProviderAdapter;
+
+declare class StatusAPI {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(baseUrl?: string, timeoutSeconds?: number);
+    checkProvider(slug: string): Promise<CheckResult>;
+    checkModel(modelId: string): Promise<CheckResult>;
+    acheckProvider(slug: string): Promise<CheckResult>;
+    acheckModel(modelId: string): Promise<CheckResult>;
+    providers(): Promise<ProviderStatus[]>;
+    model(modelId: string): Promise<ModelInfo | null>;
+    searchModels(query: string): Promise<ModelInfo[]>;
+    private get;
+    private parseCheck;
+    private parseProviderStatus;
+    private parseModel;
+}
+
+declare class AIStatusError extends Error {
+    constructor(message: string);
+}
+declare class AllProvidersDown extends AIStatusError {
+    readonly tried: string[];
+    constructor(tried: string[]);
+}
+declare class ProviderCallFailed extends AIStatusError {
+    readonly provider: string;
+    readonly model: string;
+    readonly cause: unknown;
+    constructor(provider: string, model: string, cause: unknown);
+}
+declare class NoBudgetMatch extends AIStatusError {
+    readonly maxCost: number;
+    readonly tier: string;
+    constructor(maxCost: number, tier: string);
+}
+declare class ProviderNotConfigured extends AIStatusError {
+    readonly provider: string;
+    readonly envName?: string;
+    constructor(provider: string, envName?: string);
+}
+declare class ProviderNotInstalled extends AIStatusError {
+    readonly provider: string;
+    readonly packageName?: string;
+    constructor(provider: string, packageName?: string);
+}
+declare class CheckAPIUnreachable extends AIStatusError {
+    constructor();
+}
+
+interface RouterOptions {
+    baseUrl?: string;
+    checkTimeout?: number;
+    providers?: string[];
+    autoDiscover?: boolean;
+}
+declare class Router {
+    readonly api: StatusAPI;
+    private readonly adapters;
+    private readonly adapterIndex;
+    private readonly tiers;
+    constructor(options?: RouterOptions);
+    registerProvider(config: ProviderConfig): void;
+    addTier(name: string, models: string[]): void;
+    route(messages: string | ChatMessage[], options?: RouteOptions): Promise<RouteResponse>;
+    aroute(messages: string | ChatMessage[], options?: RouteOptions): Promise<RouteResponse>;
+    private autoDiscover;
+    private indexAdapter;
+    private normalizeMessages;
+    private extractCallOptions;
+    private resolveModel;
+    private guessProvider;
+    private sortAndBindCandidates;
+    private routeModel;
+    private routeTier;
+}
+
+declare const VERSION = "0.0.2";
+declare function route(messages: string | ChatMessage[], options?: RouteOptions): Promise<RouteResponse>;
+declare function aroute(messages: string | ChatMessage[], options?: RouteOptions): Promise<RouteResponse>;
+
+export { AIStatusError, AllProvidersDown, type Alternative, type ChatMessage, CheckAPIUnreachable, CheckResult, type MessageRole, type ModelInfo, NoBudgetMatch, ProviderAdapter, ProviderCallFailed, type ProviderCallOptions, type ProviderConfig, ProviderNotConfigured, ProviderNotInstalled, type ProviderStatus, type RouteConfig, type RouteOptions, RouteResponse, Router, type RouterOptions, Status, StatusAPI, VERSION, aroute, createAdapter, registerAdapterType, route };

package/dist/index.d.ts

@@ -0,0 +1,202 @@
+declare enum Status {
+    OPERATIONAL = "operational",
+    DEGRADED = "degraded",
+    DOWN = "down",
+    UNKNOWN = "unknown"
+}
+type MessageRole = "system" | "user" | "assistant" | "tool";
+interface ChatMessage {
+    role: MessageRole | (string & {});
+    content: string;
+    name?: string;
+    toolCallId?: string;
+}
+interface ProviderConfig {
+    slug: string;
+    adapterType: string;
+    apiKey?: string;
+    env?: string;
+    baseUrl?: string;
+    aliases?: string[];
+    headers?: Record<string, string>;
+}
+interface RouteConfig {
+    tier?: string;
+    model?: string;
+    prefer?: string[];
+    allowFallback?: boolean;
+    providerTimeout?: number;
+}
+interface ProviderCallOptions {
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    providerOptions?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+interface RouteOptions extends ProviderCallOptions {
+    model?: string;
+    tier?: string;
+    system?: string;
+    allowFallback?: boolean;
+    timeout?: number;
+    prefer?: string[];
+    [key: string]: unknown;
+}
+interface Alternative {
+    slug: string;
+    name: string;
+    status: Status;
+    suggestedModel: string;
+}
+declare class CheckResult {
+    provider: string;
+    status: Status;
+    statusDetail: string | null;
+    model: string | null;
+    alternatives: Alternative[];
+    constructor(init: {
+        provider: string;
+        status: Status;
+        statusDetail?: string | null;
+        model?: string | null;
+        alternatives?: Alternative[];
+    });
+    get isAvailable(): boolean;
+}
+interface ModelInfo {
+    id: string;
+    name: string;
+    providerSlug: string;
+    contextLength: number;
+    modality: string;
+    promptPrice: number;
+    completionPrice: number;
+}
+interface ProviderStatus {
+    slug: string;
+    name: string;
+    status: Status;
+    statusDetail: string | null;
+    modelCount: number;
+}
+interface RouteResponseInit {
+    content: string;
+    modelUsed: string;
+    providerUsed: string;
+    wasFallback: boolean;
+    fallbackReason?: string | null;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    raw?: unknown;
+}
+declare class RouteResponse {
+    content: string;
+    modelUsed: string;
+    providerUsed: string;
+    wasFallback: boolean;
+    fallbackReason: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+    raw: unknown;
+    constructor(init: RouteResponseInit);
+    toString(): string;
+}
+
+declare abstract class ProviderAdapter {
+    readonly config: ProviderConfig;
+    constructor(config: ProviderConfig);
+    get slug(): string;
+    get aliases(): string[];
+    supportsProvider(slug: string): boolean;
+    stripProvider(modelId: string): string;
+    abstract call(modelId: string, messages: ChatMessage[], timeoutSeconds: number, options: ProviderCallOptions): Promise<RouteResponse>;
+}
+type ProviderAdapterConstructor = new (config: ProviderConfig) => ProviderAdapter;
+declare function registerAdapterType(typeName: string, ctor: ProviderAdapterConstructor): void;
+declare function createAdapter(config: ProviderConfig): ProviderAdapter;
+
+declare class StatusAPI {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(baseUrl?: string, timeoutSeconds?: number);
+    checkProvider(slug: string): Promise<CheckResult>;
+    checkModel(modelId: string): Promise<CheckResult>;
+    acheckProvider(slug: string): Promise<CheckResult>;
+    acheckModel(modelId: string): Promise<CheckResult>;
+    providers(): Promise<ProviderStatus[]>;
+    model(modelId: string): Promise<ModelInfo | null>;
+    searchModels(query: string): Promise<ModelInfo[]>;
+    private get;
+    private parseCheck;
+    private parseProviderStatus;
+    private parseModel;
+}
+
+declare class AIStatusError extends Error {
+    constructor(message: string);
+}
+declare class AllProvidersDown extends AIStatusError {
+    readonly tried: string[];
+    constructor(tried: string[]);
+}
+declare class ProviderCallFailed extends AIStatusError {
+    readonly provider: string;
+    readonly model: string;
+    readonly cause: unknown;
+    constructor(provider: string, model: string, cause: unknown);
+}
+declare class NoBudgetMatch extends AIStatusError {
+    readonly maxCost: number;
+    readonly tier: string;
+    constructor(maxCost: number, tier: string);
+}
+declare class ProviderNotConfigured extends AIStatusError {
+    readonly provider: string;
+    readonly envName?: string;
+    constructor(provider: string, envName?: string);
+}
+declare class ProviderNotInstalled extends AIStatusError {
+    readonly provider: string;
+    readonly packageName?: string;
+    constructor(provider: string, packageName?: string);
+}
+declare class CheckAPIUnreachable extends AIStatusError {
+    constructor();
+}
+
+interface RouterOptions {
+    baseUrl?: string;
+    checkTimeout?: number;
+    providers?: string[];
+    autoDiscover?: boolean;
+}
+declare class Router {
+    readonly api: StatusAPI;
+    private readonly adapters;
+    private readonly adapterIndex;
+    private readonly tiers;
+    constructor(options?: RouterOptions);
+    registerProvider(config: ProviderConfig): void;
+    addTier(name: string, models: string[]): void;
+    route(messages: string | ChatMessage[], options?: RouteOptions): Promise<RouteResponse>;
+    aroute(messages: string | ChatMessage[], options?: RouteOptions): Promise<RouteResponse>;
+    private autoDiscover;
+    private indexAdapter;
+    private normalizeMessages;
+    private extractCallOptions;
+    private resolveModel;
+    private guessProvider;
+    private sortAndBindCandidates;
+    private routeModel;
+    private routeTier;
+}
+
+declare const VERSION = "0.0.2";
+declare function route(messages: string | ChatMessage[], options?: RouteOptions): Promise<RouteResponse>;
+declare function aroute(messages: string | ChatMessage[], options?: RouteOptions): Promise<RouteResponse>;
+
+export { AIStatusError, AllProvidersDown, type Alternative, type ChatMessage, CheckAPIUnreachable, CheckResult, type MessageRole, type ModelInfo, NoBudgetMatch, ProviderAdapter, ProviderCallFailed, type ProviderCallOptions, type ProviderConfig, ProviderNotConfigured, ProviderNotInstalled, type ProviderStatus, type RouteConfig, type RouteOptions, RouteResponse, Router, type RouterOptions, Status, StatusAPI, VERSION, aroute, createAdapter, registerAdapterType, route };