modelpedia 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/README.md +100 -0
  2. package/dist/index.cjs +35601 -0
  3. package/dist/index.d.cts +206 -0
  4. package/dist/index.d.mts +206 -0
  5. package/dist/index.mjs +35592 -0
  6. package/package.json +97 -0
package/dist/index.d.cts ADDED
@@ -0,0 +1,206 @@
1
+ //#region src/types.d.ts
2
+ /** Model lifecycle status */
3
+ type ModelStatus = "active" | "deprecated" | "preview";
4
+ /** Data source: "official" (auto-fetched, scripts can overwrite) or "community" (manual, scripts skip) */
5
+ type ModelSource = "official" | "community";
6
+ /** Supported input/output data types */
7
+ type Modality = "text" | "image" | "audio" | "video";
8
+ /**
9
+ * Model capabilities.
10
+ * All fields optional — omit if unknown, present if known.
11
+ */
12
+ interface ModelCapabilities {
13
+ /** Can process image inputs */
14
+ vision?: boolean;
15
+ /** Supports function/tool calling */
16
+ tool_call?: boolean;
17
+ /** Supports structured JSON output (schema-constrained) */
18
+ structured_output?: boolean;
19
+ /** Uses chain-of-thought reasoning (o1/o3-style) */
20
+ reasoning?: boolean;
21
+ /** Supports JSON mode output */
22
+ json_mode?: boolean;
23
+ /** Supports streaming responses */
24
+ streaming?: boolean;
25
+ /** Available for fine-tuning */
26
+ fine_tuning?: boolean;
27
+ /** Supports batch API */
28
+ batch?: boolean;
29
+ }
30
+ /** Input and output modality support */
31
+ interface ModelModalities {
32
+ /** Accepted input types (e.g. ["text", "image"]) */
33
+ input?: Modality[];
34
+ /** Produced output types (e.g. ["text"]) */
35
+ output?: Modality[];
36
+ }
37
+ /**
38
+ * Pricing in USD per 1M tokens.
39
+ * - field omitted = price unknown
40
+ * - null = not supported / not applicable
41
+ * - number = known price
42
+ */
43
+ interface ModelPricing {
44
+ /** Cost per 1M input tokens */
45
+ input?: number | null;
46
+ /** Cost per 1M output tokens */
47
+ output?: number | null;
48
+ /** Cost per 1M cached input tokens (cache read) */
49
+ cached_input?: number | null;
50
+ /** Cost per 1M tokens written to cache (cache write) */
51
+ cache_write?: number | null;
52
+ /** Cost per 1M batch input tokens */
53
+ batch_input?: number | null;
54
+ /** Cost per 1M batch output tokens */
55
+ batch_output?: number | null;
56
+ }
57
+ /**
58
+ * Raw model data as stored in JSON files.
59
+ * Optional fields: omit if unknown, null if not applicable.
60
+ */
61
+ interface ModelData {
62
+ /** Unique model identifier used in API calls (e.g. "gpt-5.4", "anthropic/claude-opus-4.6") */
63
+ id: string;
64
+ /** Human-readable display name (e.g. "GPT-5.4", "Claude Opus 4.6") */
65
+ name: string;
66
+ /** Original model creator (e.g. "openai", "anthropic"). May differ from provider for aggregators. */
67
+ created_by: string;
68
+ /** Data source: "official" (auto-fetched) or "community" (manual contribution) */
69
+ source: ModelSource;
70
+ /** Last data update date (YYYY-MM-DD) */
71
+ last_updated: string;
72
+ /** Model family/series for grouping (e.g. "gpt-5.4", "claude-opus", "gemini-2.5") */
73
+ family?: string;
74
+ /** Short description of the model */
75
+ description?: string;
76
+ /** Current lifecycle status */
77
+ status?: ModelStatus;
78
+ /** Release date (YYYY-MM-DD), null if not applicable */
79
+ release_date?: string | null;
80
+ /** Deprecation date (YYYY-MM-DD), null if not deprecated */
81
+ deprecation_date?: string | null;
82
+ /** Training data cutoff (YYYY-MM or YYYY-MM-DD), null if not disclosed */
83
+ knowledge_cutoff?: string | null;
84
+ /** Default context window in tokens, null if unlimited */
85
+ context_window?: number | null;
86
+ /** Extended context window in tokens (e.g. Max Mode, long-context tier). Omit if same as context_window. */
87
+ max_context_window?: number | null;
88
+ /** Maximum output tokens per request, null if unlimited */
89
+ max_output_tokens?: number | null;
90
+ /** Maximum input tokens per request (if different from context_window), null if same */
91
+ max_input_tokens?: number | null;
92
+ /** Model capabilities */
93
+ capabilities?: ModelCapabilities;
94
+ /** Supported input/output modalities */
95
+ modalities?: ModelModalities;
96
+ /** Pricing per 1M tokens */
97
+ pricing?: ModelPricing;
98
+ /** Model type classification */
99
+ model_type?: "chat" | "reasoning" | "embed" | "rerank" | "image" | "audio" | "code" | "translation" | "other";
100
+ /** Supported tools and integrations (e.g. "function_calling", "web_search", "computer_use", "mcp") */
101
+ tools?: string[];
102
+ /** Supported API endpoints (e.g. "chat_completions", "responses", "batch") */
103
+ endpoints?: string[];
104
+ /** Whether output includes reasoning/thinking tokens (o-series, extended thinking) */
105
+ reasoning_tokens?: boolean;
106
+ /**
107
+ * For alias models: list of snapshot IDs this alias has pointed to.
108
+ * e.g. on "claude-opus-4-6": ["claude-opus-4-6-20260101", "claude-opus-4-6-20260701"]
109
+ * Each snapshot has its own file with its own specs.
110
+ */
111
+ snapshots?: string[];
112
+ /**
113
+ * For snapshot models: the stable alias ID this snapshot belongs to.
114
+ * e.g. on "claude-opus-4-6-20260101": "claude-opus-4-6"
115
+ */
116
+ alias?: string;
117
+ /** Intelligence/performance rating (1-5 scale, provider-defined) */
118
+ performance?: number;
119
+ /** Reasoning capability level (1-5 scale, null if not supported) */
120
+ reasoning?: number;
121
+ /** Speed/latency rating (1-5 scale, 1=slow 5=fast) */
122
+ speed?: number;
123
+ }
124
+ /** Model data with provider context, used at runtime */
125
+ interface Model extends ModelData {
126
+ /** Provider this model belongs to (directory name, e.g. "openai", "openrouter") */
127
+ provider: string;
128
+ }
129
+ /** AI model provider / API service */
130
+ interface Provider {
131
+ /** Unique provider identifier (directory name, e.g. "openai", "openrouter") */
132
+ id: string;
133
+ /** Display name (e.g. "OpenAI", "OpenRouter") */
134
+ name: string;
135
+ /** Headquarters country, ISO 3166-1 alpha-2 (e.g. "US", "CN", "FR") */
136
+ region: string;
137
+ /** General training data cutoff for this provider's latest models (YYYY-MM or YYYY-MM-DD) */
138
+ knowledge_cutoff?: string;
139
+ /** Provider website URL */
140
+ url: string;
141
+ /** API base URL */
142
+ api_url: string;
143
+ /** Documentation URL */
144
+ docs_url: string;
145
+ /** Pricing page URL */
146
+ pricing_url: string;
147
+ /** Inline SVG icon (monochrome, viewBox 0 0 24 24, fill="currentColor"). Auto-read from icon.svg. */
148
+ icon?: string;
149
+ }
150
+ /** Provider with its full model list, used in generated data */
151
+ interface ProviderWithModels extends Provider {
152
+ /** All models under this provider */
153
+ models: ModelData[];
154
+ }
155
+ //#endregion
156
+ //#region src/data.d.ts
157
+ declare const providers: ProviderWithModels[];
158
+ declare const allModels: Model[];
159
+ //#endregion
160
+ //#region src/types/anthropic.d.ts
161
+ /** Anthropic-specific model fields beyond base ModelData */
162
+ interface AnthropicModel extends Model {
163
+ /** Supports extended thinking (chain-of-thought with thinking tokens) */
164
+ extended_thinking?: boolean;
165
+ /** Maximum thinking/reasoning budget tokens */
166
+ max_thinking_tokens?: number;
167
+ /** Supports computer use tool */
168
+ computer_use?: boolean;
169
+ /** Supports prompt caching */
170
+ prompt_caching?: boolean;
171
+ /** Supports citation extraction */
172
+ citations?: boolean;
173
+ /** Supports PDF file input */
174
+ pdf_input?: boolean;
175
+ }
176
+ //#endregion
177
+ //#region src/types/google.d.ts
178
+ /** Google AI-specific model fields beyond base ModelData */
179
+ interface GoogleModel extends Model {
180
+ /** Supports Google Search grounding */
181
+ grounding?: boolean;
182
+ /** Supports code execution sandbox */
183
+ code_execution?: boolean;
184
+ /** Supported generation methods from API */
185
+ generation_methods?: string[];
186
+ }
187
+ //#endregion
188
+ //#region src/types/openai.d.ts
189
+ /** OpenAI-specific model fields beyond base ModelData */
190
+ interface OpenAIModel extends Model {
191
+ /** Supported features (e.g. "streaming", "structured_outputs", "prompt_caching", "predicted_outputs") */
192
+ supported_features?: string[];
193
+ /** Link to OpenAI Playground for this model */
194
+ playground_url?: string;
195
+ }
196
+ //#endregion
197
+ //#region src/utils.d.ts
198
+ declare function getModel(provider: string, id: string): Model | undefined;
199
+ declare function getModelsByProvider(provider: string): Model[];
200
+ declare function getActiveModels(): Model[];
201
+ declare function getModelsByFamily(family: string): Model[];
202
+ declare function getModelsByCreator(creator: string): Model[];
203
+ declare function getProvider(id: string): ProviderWithModels | undefined;
204
+ declare function getAllProviders(): ProviderWithModels[];
205
+ //#endregion
206
+ export { AnthropicModel, GoogleModel, Modality, Model, ModelCapabilities, ModelData, ModelModalities, ModelPricing, ModelSource, ModelStatus, OpenAIModel, Provider, ProviderWithModels, allModels, getActiveModels, getAllProviders, getModel, getModelsByCreator, getModelsByFamily, getModelsByProvider, getProvider, providers };
package/dist/index.d.mts ADDED
@@ -0,0 +1,206 @@
1
+ //#region src/types.d.ts
2
+ /** Model lifecycle status */
3
+ type ModelStatus = "active" | "deprecated" | "preview";
4
+ /** Data source: "official" (auto-fetched, scripts can overwrite) or "community" (manual, scripts skip) */
5
+ type ModelSource = "official" | "community";
6
+ /** Supported input/output data types */
7
+ type Modality = "text" | "image" | "audio" | "video";
8
+ /**
9
+ * Model capabilities.
10
+ * All fields optional — omit if unknown, present if known.
11
+ */
12
+ interface ModelCapabilities {
13
+ /** Can process image inputs */
14
+ vision?: boolean;
15
+ /** Supports function/tool calling */
16
+ tool_call?: boolean;
17
+ /** Supports structured JSON output (schema-constrained) */
18
+ structured_output?: boolean;
19
+ /** Uses chain-of-thought reasoning (o1/o3-style) */
20
+ reasoning?: boolean;
21
+ /** Supports JSON mode output */
22
+ json_mode?: boolean;
23
+ /** Supports streaming responses */
24
+ streaming?: boolean;
25
+ /** Available for fine-tuning */
26
+ fine_tuning?: boolean;
27
+ /** Supports batch API */
28
+ batch?: boolean;
29
+ }
30
+ /** Input and output modality support */
31
+ interface ModelModalities {
32
+ /** Accepted input types (e.g. ["text", "image"]) */
33
+ input?: Modality[];
34
+ /** Produced output types (e.g. ["text"]) */
35
+ output?: Modality[];
36
+ }
37
+ /**
38
+ * Pricing in USD per 1M tokens.
39
+ * - field omitted = price unknown
40
+ * - null = not supported / not applicable
41
+ * - number = known price
42
+ */
43
+ interface ModelPricing {
44
+ /** Cost per 1M input tokens */
45
+ input?: number | null;
46
+ /** Cost per 1M output tokens */
47
+ output?: number | null;
48
+ /** Cost per 1M cached input tokens (cache read) */
49
+ cached_input?: number | null;
50
+ /** Cost per 1M tokens written to cache (cache write) */
51
+ cache_write?: number | null;
52
+ /** Cost per 1M batch input tokens */
53
+ batch_input?: number | null;
54
+ /** Cost per 1M batch output tokens */
55
+ batch_output?: number | null;
56
+ }
57
+ /**
58
+ * Raw model data as stored in JSON files.
59
+ * Optional fields: omit if unknown, null if not applicable.
60
+ */
61
+ interface ModelData {
62
+ /** Unique model identifier used in API calls (e.g. "gpt-5.4", "anthropic/claude-opus-4.6") */
63
+ id: string;
64
+ /** Human-readable display name (e.g. "GPT-5.4", "Claude Opus 4.6") */
65
+ name: string;
66
+ /** Original model creator (e.g. "openai", "anthropic"). May differ from provider for aggregators. */
67
+ created_by: string;
68
+ /** Data source: "official" (auto-fetched) or "community" (manual contribution) */
69
+ source: ModelSource;
70
+ /** Last data update date (YYYY-MM-DD) */
71
+ last_updated: string;
72
+ /** Model family/series for grouping (e.g. "gpt-5.4", "claude-opus", "gemini-2.5") */
73
+ family?: string;
74
+ /** Short description of the model */
75
+ description?: string;
76
+ /** Current lifecycle status */
77
+ status?: ModelStatus;
78
+ /** Release date (YYYY-MM-DD), null if not applicable */
79
+ release_date?: string | null;
80
+ /** Deprecation date (YYYY-MM-DD), null if not deprecated */
81
+ deprecation_date?: string | null;
82
+ /** Training data cutoff (YYYY-MM or YYYY-MM-DD), null if not disclosed */
83
+ knowledge_cutoff?: string | null;
84
+ /** Default context window in tokens, null if unlimited */
85
+ context_window?: number | null;
86
+ /** Extended context window in tokens (e.g. Max Mode, long-context tier). Omit if same as context_window. */
87
+ max_context_window?: number | null;
88
+ /** Maximum output tokens per request, null if unlimited */
89
+ max_output_tokens?: number | null;
90
+ /** Maximum input tokens per request (if different from context_window), null if same */
91
+ max_input_tokens?: number | null;
92
+ /** Model capabilities */
93
+ capabilities?: ModelCapabilities;
94
+ /** Supported input/output modalities */
95
+ modalities?: ModelModalities;
96
+ /** Pricing per 1M tokens */
97
+ pricing?: ModelPricing;
98
+ /** Model type classification */
99
+ model_type?: "chat" | "reasoning" | "embed" | "rerank" | "image" | "audio" | "code" | "translation" | "other";
100
+ /** Supported tools and integrations (e.g. "function_calling", "web_search", "computer_use", "mcp") */
101
+ tools?: string[];
102
+ /** Supported API endpoints (e.g. "chat_completions", "responses", "batch") */
103
+ endpoints?: string[];
104
+ /** Whether output includes reasoning/thinking tokens (o-series, extended thinking) */
105
+ reasoning_tokens?: boolean;
106
+ /**
107
+ * For alias models: list of snapshot IDs this alias has pointed to.
108
+ * e.g. on "claude-opus-4-6": ["claude-opus-4-6-20260101", "claude-opus-4-6-20260701"]
109
+ * Each snapshot has its own file with its own specs.
110
+ */
111
+ snapshots?: string[];
112
+ /**
113
+ * For snapshot models: the stable alias ID this snapshot belongs to.
114
+ * e.g. on "claude-opus-4-6-20260101": "claude-opus-4-6"
115
+ */
116
+ alias?: string;
117
+ /** Intelligence/performance rating (1-5 scale, provider-defined) */
118
+ performance?: number;
119
+ /** Reasoning capability level (1-5 scale, null if not supported) */
120
+ reasoning?: number;
121
+ /** Speed/latency rating (1-5 scale, 1=slow 5=fast) */
122
+ speed?: number;
123
+ }
124
+ /** Model data with provider context, used at runtime */
125
+ interface Model extends ModelData {
126
+ /** Provider this model belongs to (directory name, e.g. "openai", "openrouter") */
127
+ provider: string;
128
+ }
129
+ /** AI model provider / API service */
130
+ interface Provider {
131
+ /** Unique provider identifier (directory name, e.g. "openai", "openrouter") */
132
+ id: string;
133
+ /** Display name (e.g. "OpenAI", "OpenRouter") */
134
+ name: string;
135
+ /** Headquarters country, ISO 3166-1 alpha-2 (e.g. "US", "CN", "FR") */
136
+ region: string;
137
+ /** General training data cutoff for this provider's latest models (YYYY-MM or YYYY-MM-DD) */
138
+ knowledge_cutoff?: string;
139
+ /** Provider website URL */
140
+ url: string;
141
+ /** API base URL */
142
+ api_url: string;
143
+ /** Documentation URL */
144
+ docs_url: string;
145
+ /** Pricing page URL */
146
+ pricing_url: string;
147
+ /** Inline SVG icon (monochrome, viewBox 0 0 24 24, fill="currentColor"). Auto-read from icon.svg. */
148
+ icon?: string;
149
+ }
150
+ /** Provider with its full model list, used in generated data */
151
+ interface ProviderWithModels extends Provider {
152
+ /** All models under this provider */
153
+ models: ModelData[];
154
+ }
155
+ //#endregion
156
+ //#region src/data.d.ts
157
+ declare const providers: ProviderWithModels[];
158
+ declare const allModels: Model[];
159
+ //#endregion
160
+ //#region src/types/anthropic.d.ts
161
+ /** Anthropic-specific model fields beyond base ModelData */
162
+ interface AnthropicModel extends Model {
163
+ /** Supports extended thinking (chain-of-thought with thinking tokens) */
164
+ extended_thinking?: boolean;
165
+ /** Maximum thinking/reasoning budget tokens */
166
+ max_thinking_tokens?: number;
167
+ /** Supports computer use tool */
168
+ computer_use?: boolean;
169
+ /** Supports prompt caching */
170
+ prompt_caching?: boolean;
171
+ /** Supports citation extraction */
172
+ citations?: boolean;
173
+ /** Supports PDF file input */
174
+ pdf_input?: boolean;
175
+ }
176
+ //#endregion
177
+ //#region src/types/google.d.ts
178
+ /** Google AI-specific model fields beyond base ModelData */
179
+ interface GoogleModel extends Model {
180
+ /** Supports Google Search grounding */
181
+ grounding?: boolean;
182
+ /** Supports code execution sandbox */
183
+ code_execution?: boolean;
184
+ /** Supported generation methods from API */
185
+ generation_methods?: string[];
186
+ }
187
+ //#endregion
188
+ //#region src/types/openai.d.ts
189
+ /** OpenAI-specific model fields beyond base ModelData */
190
+ interface OpenAIModel extends Model {
191
+ /** Supported features (e.g. "streaming", "structured_outputs", "prompt_caching", "predicted_outputs") */
192
+ supported_features?: string[];
193
+ /** Link to OpenAI Playground for this model */
194
+ playground_url?: string;
195
+ }
196
+ //#endregion
197
+ //#region src/utils.d.ts
198
+ declare function getModel(provider: string, id: string): Model | undefined;
199
+ declare function getModelsByProvider(provider: string): Model[];
200
+ declare function getActiveModels(): Model[];
201
+ declare function getModelsByFamily(family: string): Model[];
202
+ declare function getModelsByCreator(creator: string): Model[];
203
+ declare function getProvider(id: string): ProviderWithModels | undefined;
204
+ declare function getAllProviders(): ProviderWithModels[];
205
+ //#endregion
206
+ export { AnthropicModel, GoogleModel, Modality, Model, ModelCapabilities, ModelData, ModelModalities, ModelPricing, ModelSource, ModelStatus, OpenAIModel, Provider, ProviderWithModels, allModels, getActiveModels, getAllProviders, getModel, getModelsByCreator, getModelsByFamily, getModelsByProvider, getProvider, providers };