@x12i/ai-tools 1.0.4 → 2.0.0

package/dist/types-BYXnCvKx.d.ts

@@ -1,137 +0,0 @@
-/** OpenRouter Models API — https://openrouter.ai/api/v1/models */
-type OpenRouterOutputModality = "text" | "image" | "audio" | "embeddings" | "video" | "speech" | "transcription" | "all";
-type OpenRouterModelsQuery = {
-    /** Comma-separated or "all" — default on our sync is "all". */
-    output_modalities?: string;
-    supported_parameters?: string;
-};
-type OpenRouterPricingApi = {
-    prompt: string;
-    completion: string;
-    request: string;
-    image: string;
-    web_search?: string;
-    internal_reasoning?: string;
-    input_cache_read?: string;
-    input_cache_write?: string;
-};
-type OpenRouterArchitectureApi = {
-    modality?: string;
-    input_modalities: string[];
-    output_modalities: string[];
-    tokenizer: string;
-    instruct_type: string | null;
-};
-type OpenRouterTopProviderApi = {
-    context_length: number;
-    max_completion_tokens: number | null;
-    is_moderated: boolean;
-};
-type OpenRouterDefaultParametersApi = {
-    temperature?: number | null;
-    top_p?: number | null;
-    top_k?: number | null;
-    frequency_penalty?: number | null;
-    presence_penalty?: number | null;
-    repetition_penalty?: number | null;
-};
-type OpenRouterModelApi = {
-    id: string;
-    canonical_slug: string;
-    hugging_face_id?: string | null;
-    name: string;
-    created: number;
-    description: string;
-    context_length: number;
-    architecture: OpenRouterArchitectureApi;
-    pricing: OpenRouterPricingApi;
-    top_provider: OpenRouterTopProviderApi;
-    per_request_limits: unknown | null;
-    supported_parameters: string[];
-    default_parameters: OpenRouterDefaultParametersApi | null;
-    supported_voices?: unknown | null;
-    knowledge_cutoff?: string | null;
-    expiration_date?: string | null;
-    links?: {
-        details?: string;
-    } | null;
-};
-type OpenRouterModelsResponse = {
-    data: OpenRouterModelApi[];
-};
-
-type AiModelPricing = {
-    promptUsdPerToken: number;
-    completionUsdPerToken: number;
-    imageUsdPerUnit: number;
-    requestUsdPerRequest: number;
-    cacheReadUsdPerToken?: number;
-    cacheWriteUsdPerToken?: number;
-    reasoningUsdPerToken?: number;
-    webSearchUsdPerRequest?: number;
-    openRouterMarkupUsdPerInputToken?: number;
-    openRouterMarkupUsdPerOutputToken?: number;
-    pricedAt: string;
-    source: "openrouter" | "direct" | "manual";
-};
-/**
- * Canonical catalog record — mirrors OpenRouter Models API fields plus normalized pricing.
- * Stored as-is in Catalox `data`; scalar fields duplicated in `indexed` for queries.
- */
-type AiModelRecord = {
-    modelId: string;
-    name: string;
-    providerId: string;
-    canonicalSlug: string;
-    status: "active" | "deprecated" | "unknown";
-    description: string;
-    created: number;
-    expirationDate: string | null;
-    contextLength: number;
-    maxCompletionTokens: number | null;
-    isModerated: boolean;
-    modality: string;
-    inputModalities: string[];
-    outputModalities: string[];
-    tokenizer: string;
-    instructType: string | null;
-    supportedParameters: string[];
-    defaultParameters: OpenRouterDefaultParametersApi | null;
-    perRequestLimits: unknown | null;
-    pricing: AiModelPricing;
-    /** Raw OpenRouter pricing strings (USD per token/request/unit). */
-    openRouterPricing: OpenRouterPricingApi;
-    architecture: OpenRouterArchitectureApi;
-    topProvider: OpenRouterTopProviderApi;
-    /** Full OpenRouter API object — complete mirror for forward compatibility. */
-    openRouter: OpenRouterModelApi;
-    aliases: string[];
-    availableOnOpenRouter: boolean;
-    supportsStreaming: boolean;
-    supportsTools: boolean;
-    /** Exposes reasoning/thinking tokens (OpenRouter `reasoning` param and/or `internal_reasoning` pricing). */
-    supportsReasoning: boolean;
-    primaryOutputModality: string;
-    syncedAt: string;
-    syncSource: "openrouter" | "manual";
-};
-type ModelListFilters = {
-    providerId?: string;
-    status?: AiModelRecord["status"];
-    outputModality?: string;
-    inputModality?: string;
-    supportedParameter?: string;
-    supportsTools?: boolean;
-    supportsReasoning?: boolean;
-    search?: string;
-    limit?: number;
-    offset?: number;
-};
-type ModelListResult = {
-    models: AiModelRecord[];
-    total: number;
-    limit: number;
-    offset: number;
-};
-
-export type { AiModelPricing as A, ModelListFilters as M, OpenRouterArchitectureApi as O, AiModelRecord as a, ModelListResult as b, OpenRouterModelApi as c, OpenRouterModelsQuery as d, OpenRouterModelsResponse as e, OpenRouterOutputModality as f, OpenRouterPricingApi as g, OpenRouterTopProviderApi as h };

package/dist/types-CX6QFNNy.d.cts

@@ -1,144 +0,0 @@
-import { a as AiModelRecord } from './types-BYXnCvKx.cjs';
-
-type AliasEntry = {
-    modelId: string;
-    provider: string;
-    description?: string;
-    tags?: string[];
-    addedAt: string;
-    updatedAt: string;
-};
-type AliasFileSchema = {
-    $schema?: string;
-    version: 1;
-    updatedAt: string;
-    aliases: Record<string, AliasEntry>;
-};
-type ResolvedModelRef = {
-    alias: string;
-    entry: AliasEntry;
-    modelRecord: AiModelRecord | null;
-    modelId: string;
-    provider: string;
-    name: string;
-};
-type AliasValidationReport = {
-    total: number;
-    ok: number;
-    unknown: number;
-    broken: number;
-    entries: Array<{
-        name: string;
-        status: "ok" | "unknown" | "broken";
-        modelId: string;
-        resolvedName?: string;
-        issue?: string;
-    }>;
-};
-
-type AliasRegistryOptions = {
-    aliasesPath?: string;
-};
-declare class AliasRegistry {
-    private readonly aliasesPath;
-    constructor(options?: AliasRegistryOptions);
-    get path(): string;
-    exists(): boolean;
-    init(): void;
-    load(): AliasFileSchema;
-    get(aliasName: string): AliasEntry | null;
-    list(filter?: {
-        tag?: string;
-    }): Array<{
-        name: string;
-    } & AliasEntry>;
-    set(aliasName: string, entry: Omit<AliasEntry, "addedAt" | "updatedAt">): AliasEntry;
-    remove(aliasName: string): boolean;
-    rename(from: string, to: string, options?: {
-        force?: boolean;
-    }): void;
-    private writeFile;
-}
-
-/**
- * Env naming for vendor direct API keys: `{VENDOR}_API_KEY`
- * where VENDOR is the provider id in UPPER_SNAKE (hyphens → underscores).
- *
- * Examples: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `META_LLAMA_API_KEY`, `X_AI_API_KEY`
- */
-declare function providerIdToEnvKeyPrefix(providerId: string): string;
-declare function vendorApiKeyEnvName(providerId: string): string;
-type OpenRouterRoutingConfig = {
-    /** OPENROUTER_API_KEY is set and non-empty */
-    hasOpenRouterKey: boolean;
-    /** USE_OPENROUTER=true or USE_OPENROUTER=1 */
-    useOpenRouterExplicit: boolean;
-    /** Read `{PROVIDER}_API_KEY` for a catalog provider id */
-    getVendorApiKey(providerId: string): string | undefined;
-};
-/**
- * Load routing hints from process env and optional `.env` (via @x12/env).
- */
-declare function loadOpenRouterRoutingEnv(env?: Record<string, string | undefined>): OpenRouterRoutingConfig;
-/**
- * Default route via OpenRouter when:
- * 1. OPENROUTER_API_KEY is set AND USE_OPENROUTER=true|1, or
- * 2. OPENROUTER_API_KEY is set AND the vendor's `{VENDOR}_API_KEY` is missing.
- */
-declare function shouldDefaultRouteViaOpenRouter(providerId: string | undefined, config: OpenRouterRoutingConfig): boolean;
-
-type ModelResolutionInput = {
-    /** Provider hint (openrouter, openai, anthropic, …). May be omitted. */
-    provider?: string;
-    /** Model id, alias, shorthand, or partial name. Required. */
-    model: string;
-};
-type ResolutionStrategy = "alias-registry" | "alias-as-provider-correction" | "exact-match" | "catalog-alias-match" | "canonical-slug-match" | "provider-prefix-injection" | "cross-provider-correction" | "version-suffix-strip" | "date-suffix-strip" | "shorthand-expansion" | "partial-name-match" | "local-provider-passthrough";
-type ModelResolutionSuccess = {
-    found: true;
-    modelId: string;
-    record: AiModelRecord | null;
-    routedViaOpenRouter: boolean;
-    confidence: number;
-    resolvedVia: ResolutionStrategy[];
-    resolvedReason: string;
-    normalisedInput: string;
-};
-type ModelResolutionNotFound = {
-    found: false;
-    modelId: null;
-    record: null;
-    attemptedStrategies: ResolutionStrategy[];
-    bestRejectedCandidate?: {
-        modelId: string;
-        confidence: number;
-        reason: string;
-    };
-    reason: string;
-};
-type ModelResolutionResult = ModelResolutionSuccess | ModelResolutionNotFound;
-type ModelResolverOptions = {
-    confidenceThreshold?: number;
-    aliasRegistry?: AliasRegistry;
-    additionalShorthands?: Record<string, string>;
-    additionalProviderPatterns?: Array<{
-        pattern: RegExp;
-        provider: string;
-    }>;
-    additionalLocalProviders?: string[];
-    /** Env-based OpenRouter vs direct routing. Defaults to loadOpenRouterRoutingEnv(). */
-    routingEnv?: OpenRouterRoutingConfig;
-};
-type CatalogIndexes = {
-    aliasIndex: Map<string, string>;
-    slugIndex: Map<string, string>;
-    providerPrefixesBySize: string[];
-};
-/** @deprecated Use ModelResolutionSuccess via ModelNameResolver */
-type ResolvedModel = {
-    catalogModel: AiModelRecord;
-    matchedAlias: string;
-    routedViaOpenRouter: boolean;
-};
-
-export { type AliasEntry as A, type CatalogIndexes as C, type ModelResolutionInput as M, type OpenRouterRoutingConfig as O, type ResolutionStrategy as R, type AliasFileSchema as a, AliasRegistry as b, type AliasRegistryOptions as c, type AliasValidationReport as d, type ModelResolutionNotFound as e, type ModelResolutionResult as f, type ModelResolutionSuccess as g, type ModelResolverOptions as h, type ResolvedModel as i, type ResolvedModelRef as j, loadOpenRouterRoutingEnv as l, providerIdToEnvKeyPrefix as p, shouldDefaultRouteViaOpenRouter as s, vendorApiKeyEnvName as v };

package/dist/types-CuiPDcVs.d.ts

@@ -1,144 +0,0 @@
-import { a as AiModelRecord } from './types-BYXnCvKx.js';
-
-type AliasEntry = {
-    modelId: string;
-    provider: string;
-    description?: string;
-    tags?: string[];
-    addedAt: string;
-    updatedAt: string;
-};
-type AliasFileSchema = {
-    $schema?: string;
-    version: 1;
-    updatedAt: string;
-    aliases: Record<string, AliasEntry>;
-};
-type ResolvedModelRef = {
-    alias: string;
-    entry: AliasEntry;
-    modelRecord: AiModelRecord | null;
-    modelId: string;
-    provider: string;
-    name: string;
-};
-type AliasValidationReport = {
-    total: number;
-    ok: number;
-    unknown: number;
-    broken: number;
-    entries: Array<{
-        name: string;
-        status: "ok" | "unknown" | "broken";
-        modelId: string;
-        resolvedName?: string;
-        issue?: string;
-    }>;
-};
-
-type AliasRegistryOptions = {
-    aliasesPath?: string;
-};
-declare class AliasRegistry {
-    private readonly aliasesPath;
-    constructor(options?: AliasRegistryOptions);
-    get path(): string;
-    exists(): boolean;
-    init(): void;
-    load(): AliasFileSchema;
-    get(aliasName: string): AliasEntry | null;
-    list(filter?: {
-        tag?: string;
-    }): Array<{
-        name: string;
-    } & AliasEntry>;
-    set(aliasName: string, entry: Omit<AliasEntry, "addedAt" | "updatedAt">): AliasEntry;
-    remove(aliasName: string): boolean;
-    rename(from: string, to: string, options?: {
-        force?: boolean;
-    }): void;
-    private writeFile;
-}
-
-/**
- * Env naming for vendor direct API keys: `{VENDOR}_API_KEY`
- * where VENDOR is the provider id in UPPER_SNAKE (hyphens → underscores).
- *
- * Examples: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `META_LLAMA_API_KEY`, `X_AI_API_KEY`
- */
-declare function providerIdToEnvKeyPrefix(providerId: string): string;
-declare function vendorApiKeyEnvName(providerId: string): string;
-type OpenRouterRoutingConfig = {
-    /** OPENROUTER_API_KEY is set and non-empty */
-    hasOpenRouterKey: boolean;
-    /** USE_OPENROUTER=true or USE_OPENROUTER=1 */
-    useOpenRouterExplicit: boolean;
-    /** Read `{PROVIDER}_API_KEY` for a catalog provider id */
-    getVendorApiKey(providerId: string): string | undefined;
-};
-/**
- * Load routing hints from process env and optional `.env` (via @x12/env).
- */
-declare function loadOpenRouterRoutingEnv(env?: Record<string, string | undefined>): OpenRouterRoutingConfig;
-/**
- * Default route via OpenRouter when:
- * 1. OPENROUTER_API_KEY is set AND USE_OPENROUTER=true|1, or
- * 2. OPENROUTER_API_KEY is set AND the vendor's `{VENDOR}_API_KEY` is missing.
- */
-declare function shouldDefaultRouteViaOpenRouter(providerId: string | undefined, config: OpenRouterRoutingConfig): boolean;
-
-type ModelResolutionInput = {
-    /** Provider hint (openrouter, openai, anthropic, …). May be omitted. */
-    provider?: string;
-    /** Model id, alias, shorthand, or partial name. Required. */
-    model: string;
-};
-type ResolutionStrategy = "alias-registry" | "alias-as-provider-correction" | "exact-match" | "catalog-alias-match" | "canonical-slug-match" | "provider-prefix-injection" | "cross-provider-correction" | "version-suffix-strip" | "date-suffix-strip" | "shorthand-expansion" | "partial-name-match" | "local-provider-passthrough";
-type ModelResolutionSuccess = {
-    found: true;
-    modelId: string;
-    record: AiModelRecord | null;
-    routedViaOpenRouter: boolean;
-    confidence: number;
-    resolvedVia: ResolutionStrategy[];
-    resolvedReason: string;
-    normalisedInput: string;
-};
-type ModelResolutionNotFound = {
-    found: false;
-    modelId: null;
-    record: null;
-    attemptedStrategies: ResolutionStrategy[];
-    bestRejectedCandidate?: {
-        modelId: string;
-        confidence: number;
-        reason: string;
-    };
-    reason: string;
-};
-type ModelResolutionResult = ModelResolutionSuccess | ModelResolutionNotFound;
-type ModelResolverOptions = {
-    confidenceThreshold?: number;
-    aliasRegistry?: AliasRegistry;
-    additionalShorthands?: Record<string, string>;
-    additionalProviderPatterns?: Array<{
-        pattern: RegExp;
-        provider: string;
-    }>;
-    additionalLocalProviders?: string[];
-    /** Env-based OpenRouter vs direct routing. Defaults to loadOpenRouterRoutingEnv(). */
-    routingEnv?: OpenRouterRoutingConfig;
-};
-type CatalogIndexes = {
-    aliasIndex: Map<string, string>;
-    slugIndex: Map<string, string>;
-    providerPrefixesBySize: string[];
-};
-/** @deprecated Use ModelResolutionSuccess via ModelNameResolver */
-type ResolvedModel = {
-    catalogModel: AiModelRecord;
-    matchedAlias: string;
-    routedViaOpenRouter: boolean;
-};
-
-export { type AliasEntry as A, type CatalogIndexes as C, type ModelResolutionInput as M, type OpenRouterRoutingConfig as O, type ResolutionStrategy as R, type AliasFileSchema as a, AliasRegistry as b, type AliasRegistryOptions as c, type AliasValidationReport as d, type ModelResolutionNotFound as e, type ModelResolutionResult as f, type ModelResolutionSuccess as g, type ModelResolverOptions as h, type ResolvedModel as i, type ResolvedModelRef as j, loadOpenRouterRoutingEnv as l, providerIdToEnvKeyPrefix as p, shouldDefaultRouteViaOpenRouter as s, vendorApiKeyEnvName as v };

package/dist/upsertAiModelRecord-C831wOIF.d.ts

@@ -1,35 +0,0 @@
-import { Firestore } from 'firebase-admin/firestore';
-import { CataloxContext } from '@x12i/catalox';
-import { a as AiModelRecord } from './types-BYXnCvKx.js';
-
-/** Firestore rejects `undefined` — strip before write. */
-declare function sanitizeForFirestore<T>(value: T): T;
-type UpsertAiModelRecordOptions = {
-    firestore: Firestore;
-    context: CataloxContext;
-    catalogId: string;
-    record: AiModelRecord;
-};
-/**
- * Upserts one ai-models row via Firestore (safe doc ids for `provider/model` ids).
- */
-declare function upsertAiModelRecord(options: UpsertAiModelRecordOptions): Promise<void>;
-type BatchUpsertProgress = {
-    completed: number;
-    total: number;
-    phase: "loading-existing" | "writing";
-};
-type BatchUpsertAiModelRecordsOptions = {
-    onProgress?: (progress: BatchUpsertProgress) => void;
-    maxChunkRetries?: number;
-};
-type BatchUpsertResult = {
-    upserted: number;
-    failed: Array<{
-        modelId: string;
-        error: string;
-    }>;
-};
-declare function batchUpsertAiModelRecords(firestore: Firestore, catalogId: string, context: CataloxContext, records: AiModelRecord[], batchOptions?: BatchUpsertAiModelRecordsOptions): Promise<BatchUpsertResult>;
-
-export { type BatchUpsertProgress as B, batchUpsertAiModelRecords as b, sanitizeForFirestore as s, upsertAiModelRecord as u };

package/dist/upsertAiModelRecord-CjY-sny0.d.cts

@@ -1,35 +0,0 @@
-import { Firestore } from 'firebase-admin/firestore';
-import { CataloxContext } from '@x12i/catalox';
-import { a as AiModelRecord } from './types-BYXnCvKx.cjs';
-
-/** Firestore rejects `undefined` — strip before write. */
-declare function sanitizeForFirestore<T>(value: T): T;
-type UpsertAiModelRecordOptions = {
-    firestore: Firestore;
-    context: CataloxContext;
-    catalogId: string;
-    record: AiModelRecord;
-};
-/**
- * Upserts one ai-models row via Firestore (safe doc ids for `provider/model` ids).
- */
-declare function upsertAiModelRecord(options: UpsertAiModelRecordOptions): Promise<void>;
-type BatchUpsertProgress = {
-    completed: number;
-    total: number;
-    phase: "loading-existing" | "writing";
-};
-type BatchUpsertAiModelRecordsOptions = {
-    onProgress?: (progress: BatchUpsertProgress) => void;
-    maxChunkRetries?: number;
-};
-type BatchUpsertResult = {
-    upserted: number;
-    failed: Array<{
-        modelId: string;
-        error: string;
-    }>;
-};
-declare function batchUpsertAiModelRecords(firestore: Firestore, catalogId: string, context: CataloxContext, records: AiModelRecord[], batchOptions?: BatchUpsertAiModelRecordsOptions): Promise<BatchUpsertResult>;
-
-export { type BatchUpsertProgress as B, batchUpsertAiModelRecords as b, sanitizeForFirestore as s, upsertAiModelRecord as u };