language-models 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-export * from './parser';
-export * from './aliases';
-export * from './providers';
-import type { Model } from './types';
-export * from './types';
-export declare const models: Model[];
-export declare const modelPattern: RegExp;
+/**
+ * language-models - Model listing and resolution
+ *
+ * Lists all available models and resolves aliases to full model IDs.
+ *
+ * @packageDocumentation
+ */
+export { resolve, resolveWithProvider, list, get, search, DIRECT_PROVIDERS, type ModelInfo, type ProviderEndpoint, type ResolvedModel, type DirectProvider } from './models.js';
+export { ALIASES } from './aliases.js';
+//# 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;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -1,7 +1,10 @@
-export * from './parser';
-export * from './aliases';
-export * from './providers';
-import allModels from './models';
-export * from './types';
-export const models = allModels.models;
-export const modelPattern = /^(?:[\w-]+\/)?[\w\.-]+(?:@[\w-]+(?::[\w-]+)?)?(?<!@)\([^()]*(?:\([^()]*\)[^()]*)*\)$/;
+/**
+ * language-models - Model listing and resolution
+ *
+ * Lists all available models and resolves aliases to full model IDs.
+ *
+ * @packageDocumentation
+ */
+export { resolve, resolveWithProvider, list, get, search, DIRECT_PROVIDERS } from './models.js';
+export { ALIASES } from './aliases.js';
+//# 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;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,gBAAgB,EAKjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/models.d.ts

@@ -1,170 +1,97 @@
-// --- Reusable Base Interfaces ---
-
-interface Icon {
-  url: string
-  invertRequired?: boolean
+/**
+ * Model listing and resolution
+ */
+/**
+ * Provider endpoint information for direct API access
+ */
+export interface ProviderEndpoint {
+    /** Provider's API base URL (e.g., https://api.anthropic.com/v1) */
+    baseUrl: string;
+    /** Provider's model ID (e.g., claude-opus-4-5-20251101) */
+    modelId: string;
 }
-
-interface DataPolicy {
-  termsOfServiceUrl?: string // Optional based on examples
-  privacyPolicyUrl?: string // Optional based on examples
-  training: boolean
-  loggingRetentionDays?: number // Optional based on examples
-  requiresUserIds?: boolean // Optional based on examples
+export interface ModelInfo {
+    id: string;
+    name: string;
+    description?: string;
+    context_length: number;
+    pricing: {
+        prompt: string;
+        completion: string;
+    };
+    architecture?: {
+        modality: string;
+        input_modalities: string[];
+        output_modalities: string[];
+    };
+    /** Provider slug (e.g., 'anthropic', 'openai', 'google') */
+    provider?: string;
+    /** Provider's native model ID for direct API calls */
+    provider_model_id?: string;
+    /** Provider endpoint info for direct routing */
+    endpoint?: ProviderEndpoint;
 }
-
-// Base pricing structure, allowing for optional cache fields
-interface Pricing {
-  prompt: string
-  completion: string
-  image: string
-  request: string
-  webSearch: string
-  internalReasoning: string
-  discount: number
-  inputCacheRead?: string // Optional based on examples
-  inputCacheWrite?: string // Optional based on examples
+/**
+ * List all available models
+ */
+export declare function list(): ModelInfo[];
+/**
+ * Get a model by exact ID
+ */
+export declare function get(id: string): ModelInfo | undefined;
+/**
+ * Search models by query string
+ * Searches in id and name fields
+ */
+export declare function search(query: string): ModelInfo[];
+/**
+ * Resolve a model alias or partial name to a full model ID
+ *
+ * Resolution order:
+ * 1. Check aliases (e.g., 'opus' -> 'anthropic/claude-opus-4.5')
+ * 2. Check if it's already a full ID (contains '/')
+ * 3. Search for first matching model
+ *
+ * @example
+ * resolve('opus')           // 'anthropic/claude-opus-4.5'
+ * resolve('gpt-4o')         // 'openai/gpt-4o'
+ * resolve('claude-sonnet')  // 'anthropic/claude-sonnet-4.5'
+ * resolve('llama-70b')      // 'meta-llama/llama-3.3-70b-instruct'
+ */
+export declare function resolve(input: string): string;
+/**
+ * Providers that support direct SDK access (not via OpenRouter)
+ * These providers have special capabilities like MCP, extended thinking, etc.
+ */
+export declare const DIRECT_PROVIDERS: readonly ["openai", "anthropic", "google"];
+export type DirectProvider = typeof DIRECT_PROVIDERS[number];
+/**
+ * Result of resolving a model with provider routing info
+ */
+export interface ResolvedModel {
+    /** OpenRouter-style model ID (e.g., 'anthropic/claude-opus-4.5') */
+    id: string;
+    /** Provider slug (e.g., 'anthropic', 'openai', 'google') */
+    provider: string;
+    /** Provider's native model ID (e.g., 'claude-opus-4-5-20251101') */
+    providerModelId?: string;
+    /** Whether this provider supports direct SDK routing */
+    supportsDirectRouting: boolean;
+    /** Full model info if available */
+    model?: ModelInfo;
 }
-
-interface ReasoningConfig {
-  startToken: string
-  endToken: string
-}
-
-interface Sorting {
-  topWeekly: number
-  newest: number
-  throughputHighToLow: number
-  latencyLowToHigh: number
-  pricingLowToHigh: number
-  pricingHighToLow: number
-}
-
-interface ProviderInfo {
-  name: string
-  displayName: string
-  baseUrl: string
-  dataPolicy: DataPolicy
-  headquarters?: string // Optional based on examples
-  hasChatCompletions: boolean
-  hasCompletions: boolean
-  isAbortable: boolean
-  moderationRequired: boolean
-  group: string
-  editors: never[] // Assuming these are always empty based on examples
-  owners: never[] // Assuming these are always empty based on examples
-  isMultipartSupported: boolean
-  statusPageUrl: string | null
-  byokEnabled: boolean
-  isPrimaryProvider: boolean
-  icon: Icon
-}
-
-// Represents an entry in the 'providers' array within a Model
-interface ModelProvider {
-  name: string
-  slug: string
-  quantization: string | null
-  context: number
-  maxCompletionTokens: number | null // Can be null in examples
-  pricing: Pricing // Use the common Pricing type
-  supportedParameters: string[]
-  inputCost: number
-  outputCost: number
-  throughput?: number // Optional based on examples
-  latency?: number // Optional based on examples
-}
-
-// Represents the nested 'features.supportedParameters' object
-interface SupportedParametersFeatures {
-  responseFormat?: boolean
-  structuredOutputs?: boolean
-}
-
-// Base Model structure (common fields without nested endpoint/providers)
-// This helps avoid circular type definitions initially
-interface ModelBase {
-  slug: string
-  hfSlug: string | null
-  updatedAt: string
-  createdAt: string
-  hfUpdatedAt: string | null // Assuming string like others, though only null seen
-  name: string
-  shortName: string
-  author: string
-  description: string
-  modelVersionGroupId: string | null
-  contextLength: number
-  inputModalities: string[]
-  outputModalities: string[]
-  hasTextOutput: boolean
-  group: string
-  instructType: string | null
-  defaultSystem: string | null // Assuming string, though only null seen
-  defaultStops: string[] // Use string[] as it can contain values
-  hidden: boolean
-  router: string | null // Assuming string, though only null seen
-  warningMessage: string | null
-  permaslug: string
-  reasoningConfig: ReasoningConfig | null
-}
-
-// Define Endpoint structure, referencing ModelBase for its 'model' property
-interface Endpoint {
-  id: string
-  name: string
-  contextLength: number
-  model: ModelBase // Reference the base model structure
-  modelVariantSlug: string
-  modelVariantPermaslug: string
-  providerName: string
-  providerInfo: ProviderInfo
-  providerDisplayName: string
-  providerModelId: string
-  providerGroup: string
-  isCloaked: boolean
-  quantization: string | null
-  variant: string
-  isSelfHosted: boolean
-  canAbort: boolean
-  maxPromptTokens: number | null
-  maxCompletionTokens: number | null // Endpoint might have different limits
-  maxPromptImages: number | null
-  maxTokensPerImage: number | null
-  supportedParameters: string[]
-  isByok: boolean
-  moderationRequired: boolean
-  dataPolicy: DataPolicy // Data policy specific to the endpoint variant
-  pricing: Pricing // Pricing specific to the endpoint variant
-  isHidden: boolean
-  isDeranked: boolean
-  isDisabled: boolean
-  supportsToolParameters: boolean
-  supportsReasoning: boolean
-  supportsMultipart: boolean
-  limitRpm: number | null
-  limitRpd: number | null
-  hasCompletions: boolean
-  hasChatCompletions: boolean
-  features: {
-    supportedParameters?: SupportedParametersFeatures
-  }
-  providerRegion: string | null // Assuming string, though only null seen
-}
-
-// --- Final Composed Model Interface ---
-
-// Extend ModelBase and add the nested structures
-interface Model extends ModelBase {
-  endpoint: Endpoint | null // Endpoint can be null
-  sorting: Sorting
-  providers: ModelProvider[] // Array can be empty
-}
-
-// --- The Default Export ---
-
-declare const _default: {
-  models: Model[]
-}
-
-export default _default
+/**
+ * Resolve a model alias and get full routing information
+ *
+ * @example
+ * const info = resolveWithProvider('opus')
+ * // {
+ * //   id: 'anthropic/claude-opus-4.5',
+ * //   provider: 'anthropic',
+ * //   providerModelId: 'claude-opus-4-5-20251101',
+ * //   supportsDirectRouting: true,
+ * //   model: { ... }
+ * // }
+ */
+export declare function resolveWithProvider(input: string): ResolvedModel;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,EAAE,CAAA;QAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAA;KAC5B,CAAA;IACD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAeD;;GAEG;AACH,wBAAgB,IAAI,IAAI,SAAS,EAAE,CAElC;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAErD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAMjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB7C;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,4CAA6C,CAAA;AAC1E,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAA;IACV,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,qBAAqB,EAAE,OAAO,CAAA;IAC9B,mCAAmC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAiBhE"}