@openrouter/sdk 0.3.12 → 0.3.15

package/esm/sdk/guardrails.d.ts

@@ -0,0 +1,96 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+export declare class Guardrails extends ClientSDK {
+    /**
+     * List guardrails
+     *
+     * @remarks
+     * List all guardrails for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    list(request?: operations.ListGuardrailsRequest | undefined, options?: RequestOptions): Promise<operations.ListGuardrailsResponse>;
+    /**
+     * Create a guardrail
+     *
+     * @remarks
+     * Create a new guardrail for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    create(request: operations.CreateGuardrailRequest, options?: RequestOptions): Promise<operations.CreateGuardrailResponse>;
+    /**
+     * Get a guardrail
+     *
+     * @remarks
+     * Get a single guardrail by ID. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    get(request: operations.GetGuardrailRequest, options?: RequestOptions): Promise<operations.GetGuardrailResponse>;
+    /**
+     * Update a guardrail
+     *
+     * @remarks
+     * Update an existing guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    update(request: operations.UpdateGuardrailRequest, options?: RequestOptions): Promise<operations.UpdateGuardrailResponse>;
+    /**
+     * Delete a guardrail
+     *
+     * @remarks
+     * Delete an existing guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    delete(request: operations.DeleteGuardrailRequest, options?: RequestOptions): Promise<operations.DeleteGuardrailResponse>;
+    /**
+     * List all key assignments
+     *
+     * @remarks
+     * List all API key guardrail assignments for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    listKeyAssignments(request?: operations.ListKeyAssignmentsRequest | undefined, options?: RequestOptions): Promise<operations.ListKeyAssignmentsResponse>;
+    /**
+     * List all member assignments
+     *
+     * @remarks
+     * List all organization member guardrail assignments for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    listMemberAssignments(request?: operations.ListMemberAssignmentsRequest | undefined, options?: RequestOptions): Promise<operations.ListMemberAssignmentsResponse>;
+    /**
+     * List key assignments for a guardrail
+     *
+     * @remarks
+     * List all API key assignments for a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    listGuardrailKeyAssignments(request: operations.ListGuardrailKeyAssignmentsRequest, options?: RequestOptions): Promise<operations.ListGuardrailKeyAssignmentsResponse>;
+    /**
+     * Bulk assign keys to a guardrail
+     *
+     * @remarks
+     * Assign multiple API keys to a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    bulkAssignKeys(request: operations.BulkAssignKeysToGuardrailRequest, options?: RequestOptions): Promise<operations.BulkAssignKeysToGuardrailResponse>;
+    /**
+     * List member assignments for a guardrail
+     *
+     * @remarks
+     * List all organization member assignments for a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    listGuardrailMemberAssignments(request: operations.ListGuardrailMemberAssignmentsRequest, options?: RequestOptions): Promise<operations.ListGuardrailMemberAssignmentsResponse>;
+    /**
+     * Bulk assign members to a guardrail
+     *
+     * @remarks
+     * Assign multiple organization members to a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    bulkAssignMembers(request: operations.BulkAssignMembersToGuardrailRequest, options?: RequestOptions): Promise<operations.BulkAssignMembersToGuardrailResponse>;
+    /**
+     * Bulk unassign keys from a guardrail
+     *
+     * @remarks
+     * Unassign multiple API keys from a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    bulkUnassignKeys(request: operations.BulkUnassignKeysFromGuardrailRequest, options?: RequestOptions): Promise<operations.BulkUnassignKeysFromGuardrailResponse>;
+    /**
+     * Bulk unassign members from a guardrail
+     *
+     * @remarks
+     * Unassign multiple organization members from a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    bulkUnassignMembers(request: operations.BulkUnassignMembersFromGuardrailRequest, options?: RequestOptions): Promise<operations.BulkUnassignMembersFromGuardrailResponse>;
+}
+//# sourceMappingURL=guardrails.d.ts.map

package/esm/sdk/guardrails.js

@@ -0,0 +1,139 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c4e976dbf057
+ */
+import { guardrailsBulkAssignKeys } from "../funcs/guardrailsBulkAssignKeys.js";
+import { guardrailsBulkAssignMembers } from "../funcs/guardrailsBulkAssignMembers.js";
+import { guardrailsBulkUnassignKeys } from "../funcs/guardrailsBulkUnassignKeys.js";
+import { guardrailsBulkUnassignMembers } from "../funcs/guardrailsBulkUnassignMembers.js";
+import { guardrailsCreate } from "../funcs/guardrailsCreate.js";
+import { guardrailsDelete } from "../funcs/guardrailsDelete.js";
+import { guardrailsGet } from "../funcs/guardrailsGet.js";
+import { guardrailsList } from "../funcs/guardrailsList.js";
+import { guardrailsListGuardrailKeyAssignments } from "../funcs/guardrailsListGuardrailKeyAssignments.js";
+import { guardrailsListGuardrailMemberAssignments } from "../funcs/guardrailsListGuardrailMemberAssignments.js";
+import { guardrailsListKeyAssignments } from "../funcs/guardrailsListKeyAssignments.js";
+import { guardrailsListMemberAssignments } from "../funcs/guardrailsListMemberAssignments.js";
+import { guardrailsUpdate } from "../funcs/guardrailsUpdate.js";
+import { ClientSDK } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+export class Guardrails extends ClientSDK {
+    /**
+     * List guardrails
+     *
+     * @remarks
+     * List all guardrails for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async list(request, options) {
+        return unwrapAsync(guardrailsList(this, request, options));
+    }
+    /**
+     * Create a guardrail
+     *
+     * @remarks
+     * Create a new guardrail for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async create(request, options) {
+        return unwrapAsync(guardrailsCreate(this, request, options));
+    }
+    /**
+     * Get a guardrail
+     *
+     * @remarks
+     * Get a single guardrail by ID. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async get(request, options) {
+        return unwrapAsync(guardrailsGet(this, request, options));
+    }
+    /**
+     * Update a guardrail
+     *
+     * @remarks
+     * Update an existing guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async update(request, options) {
+        return unwrapAsync(guardrailsUpdate(this, request, options));
+    }
+    /**
+     * Delete a guardrail
+     *
+     * @remarks
+     * Delete an existing guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async delete(request, options) {
+        return unwrapAsync(guardrailsDelete(this, request, options));
+    }
+    /**
+     * List all key assignments
+     *
+     * @remarks
+     * List all API key guardrail assignments for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async listKeyAssignments(request, options) {
+        return unwrapAsync(guardrailsListKeyAssignments(this, request, options));
+    }
+    /**
+     * List all member assignments
+     *
+     * @remarks
+     * List all organization member guardrail assignments for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async listMemberAssignments(request, options) {
+        return unwrapAsync(guardrailsListMemberAssignments(this, request, options));
+    }
+    /**
+     * List key assignments for a guardrail
+     *
+     * @remarks
+     * List all API key assignments for a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async listGuardrailKeyAssignments(request, options) {
+        return unwrapAsync(guardrailsListGuardrailKeyAssignments(this, request, options));
+    }
+    /**
+     * Bulk assign keys to a guardrail
+     *
+     * @remarks
+     * Assign multiple API keys to a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async bulkAssignKeys(request, options) {
+        return unwrapAsync(guardrailsBulkAssignKeys(this, request, options));
+    }
+    /**
+     * List member assignments for a guardrail
+     *
+     * @remarks
+     * List all organization member assignments for a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async listGuardrailMemberAssignments(request, options) {
+        return unwrapAsync(guardrailsListGuardrailMemberAssignments(this, request, options));
+    }
+    /**
+     * Bulk assign members to a guardrail
+     *
+     * @remarks
+     * Assign multiple organization members to a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async bulkAssignMembers(request, options) {
+        return unwrapAsync(guardrailsBulkAssignMembers(this, request, options));
+    }
+    /**
+     * Bulk unassign keys from a guardrail
+     *
+     * @remarks
+     * Unassign multiple API keys from a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async bulkUnassignKeys(request, options) {
+        return unwrapAsync(guardrailsBulkUnassignKeys(this, request, options));
+    }
+    /**
+     * Bulk unassign members from a guardrail
+     *
+     * @remarks
+     * Unassign multiple organization members from a specific guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+     */
+    async bulkUnassignMembers(request, options) {
+        return unwrapAsync(guardrailsBulkUnassignMembers(this, request, options));
+    }
+}
+//# sourceMappingURL=guardrails.js.map

package/esm/sdk/sdk.d.ts

@@ -8,9 +8,9 @@ import { Credits } from "./credits.js";
 import { Embeddings } from "./embeddings.js";
 import { Endpoints } from "./endpoints.js";
 import { Generations } from "./generations.js";
+import { Guardrails } from "./guardrails.js";
 import { Models } from "./models.js";
 import { OAuth } from "./oauth.js";
-import { ParametersT } from "./parameters.js";
 import { Providers } from "./providers.js";
 import { type CallModelInput } from "../funcs/call-model.js";
 import type { ModelResult } from "../lib/model-result.js";
@@ -32,12 +32,12 @@ export declare class OpenRouter extends ClientSDK {
     get models(): Models;
     private _endpoints?;
     get endpoints(): Endpoints;
-    private _parameters?;
-    get parameters(): ParametersT;
     private _providers?;
     get providers(): Providers;
     private _apiKeys?;
     get apiKeys(): APIKeys;
+    private _guardrails?;
+    get guardrails(): Guardrails;
     private _oAuth?;
     get oAuth(): OAuth;
     private _chat?;

package/esm/sdk/sdk.js

@@ -12,9 +12,9 @@ import { Credits } from "./credits.js";
 import { Embeddings } from "./embeddings.js";
 import { Endpoints } from "./endpoints.js";
 import { Generations } from "./generations.js";
+import { Guardrails } from "./guardrails.js";
 import { Models } from "./models.js";
 import { OAuth } from "./oauth.js";
-import { ParametersT } from "./parameters.js";
 import { Providers } from "./providers.js";
 // #region imports
 import { callModel as callModelFunc, } from "../funcs/call-model.js";
@@ -43,15 +43,15 @@ export class OpenRouter extends ClientSDK {
     get endpoints() {
         return (this._endpoints ?? (this._endpoints = new Endpoints(this._options)));
     }
-    get parameters() {
-        return (this._parameters ?? (this._parameters = new ParametersT(this._options)));
-    }
     get providers() {
         return (this._providers ?? (this._providers = new Providers(this._options)));
     }
     get apiKeys() {
         return (this._apiKeys ?? (this._apiKeys = new APIKeys(this._options)));
     }
+    get guardrails() {
+        return (this._guardrails ?? (this._guardrails = new Guardrails(this._options)));
+    }
     get oAuth() {
         return (this._oAuth ?? (this._oAuth = new OAuth(this._options)));
     }

package/esm/types/index.d.ts

@@ -5,4 +5,6 @@ export type { PageIterator, Paginator } from "./operations.js";
 export { createPageIterator } from "./operations.js";
 export { RFCDate } from "./rfcdate.js";
 export * from "./unrecognized.js";
+export type { ModelId, Variant, StaticVariant, VirtualVariant } from "./models.js";
+export { MODEL_HASH } from "./models.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/types/index.js

@@ -6,4 +6,5 @@ export { blobLikeSchema, isBlobLike } from "./blobs.js";
 export { createPageIterator } from "./operations.js";
 export { RFCDate } from "./rfcdate.js";
 export * from "./unrecognized.js";
+export { MODEL_HASH } from "./models.js";
 //# sourceMappingURL=index.js.map

package/esm/types/models.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Union type of all available model IDs on OpenRouter.
+ * Includes base models and their variants (e.g., ":free", ":nitro").
+ */
+export type ModelId = 'ai21/jamba-large-1.7' | 'ai21/jamba-mini-1.7' | 'aion-labs/aion-1.0' | 'aion-labs/aion-1.0-mini' | 'aion-labs/aion-rp-llama-3.1-8b' | 'alfredpros/codellama-7b-instruct-solidity' | 'alibaba/tongyi-deepresearch-30b-a3b' | 'alibaba/tongyi-deepresearch-30b-a3b:free' | 'allenai/olmo-2-0325-32b-instruct' | 'allenai/olmo-3-32b-think:free' | 'allenai/olmo-3-7b-instruct' | 'allenai/olmo-3-7b-think' | 'allenai/olmo-3.1-32b-think:free' | 'alpindale/goliath-120b' | 'amazon/nova-2-lite-v1' | 'amazon/nova-lite-v1' | 'amazon/nova-micro-v1' | 'amazon/nova-premier-v1' | 'amazon/nova-pro-v1' | 'anthracite-org/magnum-v4-72b' | 'anthropic/claude-3-haiku' | 'anthropic/claude-3-opus' | 'anthropic/claude-3.5-haiku' | 'anthropic/claude-3.5-haiku-20241022' | 'anthropic/claude-3.5-sonnet' | 'anthropic/claude-3.7-sonnet' | 'anthropic/claude-3.7-sonnet:thinking' | 'anthropic/claude-haiku-4.5' | 'anthropic/claude-opus-4' | 'anthropic/claude-opus-4.1' | 'anthropic/claude-opus-4.5' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-sonnet-4.5' | 'arcee-ai/coder-large' | 'arcee-ai/maestro-reasoning' | 'arcee-ai/spotlight' | 'arcee-ai/trinity-mini' | 'arcee-ai/trinity-mini:free' | 'arcee-ai/virtuoso-large' | 'arliai/qwq-32b-arliai-rpr-v1' | 'baidu/ernie-4.5-21b-a3b' | 'baidu/ernie-4.5-21b-a3b-thinking' | 'baidu/ernie-4.5-300b-a47b' | 'baidu/ernie-4.5-vl-28b-a3b' | 'baidu/ernie-4.5-vl-424b-a47b' | 'bytedance/ui-tars-1.5-7b' | 'cognitivecomputations/dolphin-mistral-24b-venice-edition:free' | 'cohere/command-a' | 'cohere/command-r-08-2024' | 'cohere/command-r-plus-08-2024' | 'cohere/command-r7b-12-2024' | 'deepcogito/cogito-v2-preview-llama-109b-moe' | 'deepcogito/cogito-v2-preview-llama-405b' | 'deepcogito/cogito-v2-preview-llama-70b' | 'deepcogito/cogito-v2.1-671b' | 'deepseek/deepseek-chat' | 'deepseek/deepseek-chat-v3-0324' | 'deepseek/deepseek-chat-v3.1' | 'deepseek/deepseek-prover-v2' | 'deepseek/deepseek-r1' | 'deepseek/deepseek-r1-0528' | 'deepseek/deepseek-r1-0528-qwen3-8b' | 'deepseek/deepseek-r1-0528:free' | 'deepseek/deepseek-r1-distill-llama-70b' | 'deepseek/deepseek-r1-distill-qwen-14b' | 'deepseek/deepseek-r1-distill-qwen-32b' | 'deepseek/deepseek-v3.1-terminus' | 'deepseek/deepseek-v3.1-terminus:exacto' | 'deepseek/deepseek-v3.2' | 'deepseek/deepseek-v3.2-exp' | 'deepseek/deepseek-v3.2-speciale' | 'eleutherai/llemma_7b' | 'essentialai/rnj-1-instruct' | 'google/gemini-2.0-flash-001' | 'google/gemini-2.0-flash-exp:free' | 'google/gemini-2.0-flash-lite-001' | 'google/gemini-2.5-flash' | 'google/gemini-2.5-flash-image' | 'google/gemini-2.5-flash-image-preview' | 'google/gemini-2.5-flash-lite' | 'google/gemini-2.5-flash-lite-preview-09-2025' | 'google/gemini-2.5-flash-preview-09-2025' | 'google/gemini-2.5-pro' | 'google/gemini-2.5-pro-preview' | 'google/gemini-2.5-pro-preview-05-06' | 'google/gemini-3-flash-preview' | 'google/gemini-3-pro-image-preview' | 'google/gemini-3-pro-preview' | 'google/gemma-2-27b-it' | 'google/gemma-2-9b-it' | 'google/gemma-3-12b-it' | 'google/gemma-3-12b-it:free' | 'google/gemma-3-27b-it' | 'google/gemma-3-27b-it:free' | 'google/gemma-3-4b-it' | 'google/gemma-3-4b-it:free' | 'google/gemma-3n-e2b-it:free' | 'google/gemma-3n-e4b-it' | 'google/gemma-3n-e4b-it:free' | 'gryphe/mythomax-l2-13b' | 'ibm-granite/granite-4.0-h-micro' | 'inception/mercury' | 'inception/mercury-coder' | 'inflection/inflection-3-pi' | 'inflection/inflection-3-productivity' | 'kwaipilot/kat-coder-pro:free' | 'liquid/lfm-2.2-6b' | 'liquid/lfm2-8b-a1b' | 'mancer/weaver' | 'meituan/longcat-flash-chat' | 'meta-llama/llama-3-70b-instruct' | 'meta-llama/llama-3-8b-instruct' | 'meta-llama/llama-3.1-405b' | 'meta-llama/llama-3.1-405b-instruct' | 'meta-llama/llama-3.1-405b-instruct:free' | 'meta-llama/llama-3.1-70b-instruct' | 'meta-llama/llama-3.1-8b-instruct' | 'meta-llama/llama-3.2-11b-vision-instruct' | 'meta-llama/llama-3.2-1b-instruct' | 'meta-llama/llama-3.2-3b-instruct' | 'meta-llama/llama-3.2-3b-instruct:free' | 'meta-llama/llama-3.2-90b-vision-instruct' | 'meta-llama/llama-3.3-70b-instruct' | 'meta-llama/llama-3.3-70b-instruct:free' | 'meta-llama/llama-4-maverick' | 'meta-llama/llama-4-scout' | 'meta-llama/llama-guard-2-8b' | 'meta-llama/llama-guard-3-8b' | 'meta-llama/llama-guard-4-12b' | 'microsoft/phi-3-medium-128k-instruct' | 'microsoft/phi-3-mini-128k-instruct' | 'microsoft/phi-3.5-mini-128k-instruct' | 'microsoft/phi-4' | 'microsoft/phi-4-multimodal-instruct' | 'microsoft/phi-4-reasoning-plus' | 'microsoft/wizardlm-2-8x22b' | 'minimax/minimax-01' | 'minimax/minimax-m1' | 'minimax/minimax-m2' | 'minimax/minimax-m2.1' | 'mistralai/codestral-2508' | 'mistralai/devstral-2512' | 'mistralai/devstral-2512:free' | 'mistralai/devstral-medium' | 'mistralai/devstral-small' | 'mistralai/devstral-small-2505' | 'mistralai/ministral-14b-2512' | 'mistralai/ministral-3b' | 'mistralai/ministral-3b-2512' | 'mistralai/ministral-8b' | 'mistralai/ministral-8b-2512' | 'mistralai/mistral-7b-instruct' | 'mistralai/mistral-7b-instruct-v0.1' | 'mistralai/mistral-7b-instruct-v0.2' | 'mistralai/mistral-7b-instruct-v0.3' | 'mistralai/mistral-7b-instruct:free' | 'mistralai/mistral-large' | 'mistralai/mistral-large-2407' | 'mistralai/mistral-large-2411' | 'mistralai/mistral-large-2512' | 'mistralai/mistral-medium-3' | 'mistralai/mistral-medium-3.1' | 'mistralai/mistral-nemo' | 'mistralai/mistral-saba' | 'mistralai/mistral-small-24b-instruct-2501' | 'mistralai/mistral-small-3.1-24b-instruct' | 'mistralai/mistral-small-3.1-24b-instruct:free' | 'mistralai/mistral-small-3.2-24b-instruct' | 'mistralai/mistral-small-creative' | 'mistralai/mistral-tiny' | 'mistralai/mixtral-8x22b-instruct' | 'mistralai/mixtral-8x7b-instruct' | 'mistralai/pixtral-12b' | 'mistralai/pixtral-large-2411' | 'mistralai/voxtral-small-24b-2507' | 'moonshotai/kimi-dev-72b' | 'moonshotai/kimi-k2' | 'moonshotai/kimi-k2-0905' | 'moonshotai/kimi-k2-0905:exacto' | 'moonshotai/kimi-k2-thinking' | 'moonshotai/kimi-k2:free' | 'morph/morph-v3-fast' | 'morph/morph-v3-large' | 'neversleep/llama-3.1-lumimaid-8b' | 'neversleep/noromaid-20b' | 'nex-agi/deepseek-v3.1-nex-n1:free' | 'nousresearch/deephermes-3-mistral-24b-preview' | 'nousresearch/hermes-2-pro-llama-3-8b' | 'nousresearch/hermes-3-llama-3.1-405b' | 'nousresearch/hermes-3-llama-3.1-405b:free' | 'nousresearch/hermes-3-llama-3.1-70b' | 'nousresearch/hermes-4-405b' | 'nousresearch/hermes-4-70b' | 'nvidia/llama-3.1-nemotron-70b-instruct' | 'nvidia/llama-3.1-nemotron-ultra-253b-v1' | 'nvidia/llama-3.3-nemotron-super-49b-v1.5' | 'nvidia/nemotron-3-nano-30b-a3b' | 'nvidia/nemotron-3-nano-30b-a3b:free' | 'nvidia/nemotron-nano-12b-v2-vl' | 'nvidia/nemotron-nano-12b-v2-vl:free' | 'nvidia/nemotron-nano-9b-v2' | 'nvidia/nemotron-nano-9b-v2:free' | 'openai/chatgpt-4o-latest' | 'openai/codex-mini' | 'openai/gpt-3.5-turbo' | 'openai/gpt-3.5-turbo-0613' | 'openai/gpt-3.5-turbo-16k' | 'openai/gpt-3.5-turbo-instruct' | 'openai/gpt-4' | 'openai/gpt-4-0314' | 'openai/gpt-4-1106-preview' | 'openai/gpt-4-turbo' | 'openai/gpt-4-turbo-preview' | 'openai/gpt-4.1' | 'openai/gpt-4.1-mini' | 'openai/gpt-4.1-nano' | 'openai/gpt-4o' | 'openai/gpt-4o-2024-05-13' | 'openai/gpt-4o-2024-08-06' | 'openai/gpt-4o-2024-11-20' | 'openai/gpt-4o-audio-preview' | 'openai/gpt-4o-mini' | 'openai/gpt-4o-mini-2024-07-18' | 'openai/gpt-4o-mini-search-preview' | 'openai/gpt-4o-search-preview' | 'openai/gpt-4o:extended' | 'openai/gpt-5' | 'openai/gpt-5-chat' | 'openai/gpt-5-codex' | 'openai/gpt-5-image' | 'openai/gpt-5-image-mini' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | 'openai/gpt-5-pro' | 'openai/gpt-5.1' | 'openai/gpt-5.1-chat' | 'openai/gpt-5.1-codex' | 'openai/gpt-5.1-codex-max' | 'openai/gpt-5.1-codex-mini' | 'openai/gpt-5.2' | 'openai/gpt-5.2-chat' | 'openai/gpt-5.2-pro' | 'openai/gpt-oss-120b' | 'openai/gpt-oss-120b:exacto' | 'openai/gpt-oss-120b:free' | 'openai/gpt-oss-20b' | 'openai/gpt-oss-20b:free' | 'openai/gpt-oss-safeguard-20b' | 'openai/o1' | 'openai/o1-pro' | 'openai/o3' | 'openai/o3-deep-research' | 'openai/o3-mini' | 'openai/o3-mini-high' | 'openai/o3-pro' | 'openai/o4-mini' | 'openai/o4-mini-deep-research' | 'openai/o4-mini-high' | 'opengvlab/internvl3-78b' | 'openrouter/auto' | 'openrouter/bodybuilder' | 'perplexity/sonar' | 'perplexity/sonar-deep-research' | 'perplexity/sonar-pro' | 'perplexity/sonar-pro-search' | 'perplexity/sonar-reasoning' | 'perplexity/sonar-reasoning-pro' | 'prime-intellect/intellect-3' | 'qwen/qwen-2.5-72b-instruct' | 'qwen/qwen-2.5-7b-instruct' | 'qwen/qwen-2.5-coder-32b-instruct' | 'qwen/qwen-2.5-vl-7b-instruct' | 'qwen/qwen-2.5-vl-7b-instruct:free' | 'qwen/qwen-max' | 'qwen/qwen-plus' | 'qwen/qwen-plus-2025-07-28' | 'qwen/qwen-plus-2025-07-28:thinking' | 'qwen/qwen-turbo' | 'qwen/qwen-vl-max' | 'qwen/qwen-vl-plus' | 'qwen/qwen2.5-coder-7b-instruct' | 'qwen/qwen2.5-vl-32b-instruct' | 'qwen/qwen2.5-vl-72b-instruct' | 'qwen/qwen3-14b' | 'qwen/qwen3-235b-a22b' | 'qwen/qwen3-235b-a22b-2507' | 'qwen/qwen3-235b-a22b-thinking-2507' | 'qwen/qwen3-30b-a3b' | 'qwen/qwen3-30b-a3b-instruct-2507' | 'qwen/qwen3-30b-a3b-thinking-2507' | 'qwen/qwen3-32b' | 'qwen/qwen3-4b:free' | 'qwen/qwen3-8b' | 'qwen/qwen3-coder' | 'qwen/qwen3-coder-30b-a3b-instruct' | 'qwen/qwen3-coder-flash' | 'qwen/qwen3-coder-plus' | 'qwen/qwen3-coder:exacto' | 'qwen/qwen3-coder:free' | 'qwen/qwen3-max' | 'qwen/qwen3-next-80b-a3b-instruct' | 'qwen/qwen3-next-80b-a3b-thinking' | 'qwen/qwen3-vl-235b-a22b-instruct' | 'qwen/qwen3-vl-235b-a22b-thinking' | 'qwen/qwen3-vl-30b-a3b-instruct' | 'qwen/qwen3-vl-30b-a3b-thinking' | 'qwen/qwen3-vl-32b-instruct' | 'qwen/qwen3-vl-8b-instruct' | 'qwen/qwen3-vl-8b-thinking' | 'qwen/qwq-32b' | 'raifle/sorcererlm-8x22b' | 'relace/relace-apply-3' | 'relace/relace-search' | 'sao10k/l3-euryale-70b' | 'sao10k/l3-lunaris-8b' | 'sao10k/l3.1-70b-hanami-x1' | 'sao10k/l3.1-euryale-70b' | 'sao10k/l3.3-euryale-70b' | 'stepfun-ai/step3' | 'switchpoint/router' | 'tencent/hunyuan-a13b-instruct' | 'thedrummer/cydonia-24b-v4.1' | 'thedrummer/rocinante-12b' | 'thedrummer/skyfall-36b-v2' | 'thedrummer/unslopnemo-12b' | 'thudm/glm-4.1v-9b-thinking' | 'tngtech/deepseek-r1t-chimera' | 'tngtech/deepseek-r1t-chimera:free' | 'tngtech/deepseek-r1t2-chimera' | 'tngtech/deepseek-r1t2-chimera:free' | 'tngtech/tng-r1t-chimera' | 'tngtech/tng-r1t-chimera:free' | 'undi95/remm-slerp-l2-13b' | 'x-ai/grok-3' | 'x-ai/grok-3-beta' | 'x-ai/grok-3-mini' | 'x-ai/grok-3-mini-beta' | 'x-ai/grok-4' | 'x-ai/grok-4-fast' | 'x-ai/grok-4.1-fast' | 'x-ai/grok-code-fast-1' | 'xiaomi/mimo-v2-flash:free' | 'z-ai/glm-4-32b' | 'z-ai/glm-4.5' | 'z-ai/glm-4.5-air' | 'z-ai/glm-4.5-air:free' | 'z-ai/glm-4.5v' | 'z-ai/glm-4.6' | 'z-ai/glm-4.6:exacto' | 'z-ai/glm-4.6v' | 'z-ai/glm-4.7';
+/**
+ * Static variants that create distinct model IDs.
+ * These are already present in the API response (e.g., "openai/gpt-4:free").
+ */
+export type StaticVariant = 'free' | 'extended' | 'exacto' | 'thinking';
+/**
+ * Virtual variants used for routing hints.
+ * These do not create distinct model IDs but affect routing behavior.
+ */
+export type VirtualVariant = 'all' | 'online' | 'nitro' | 'floor';
+/**
+ * All available variants.
+ */
+export type Variant = StaticVariant | VirtualVariant;
+/**
+ * Hash of model IDs for staleness checking.
+ * Used by postinstall script to detect outdated types.
+ */
+export declare const MODEL_HASH = "986e77d89072f654";
+//# sourceMappingURL=models.d.ts.map

package/esm/types/models.js

@@ -0,0 +1,10 @@
+// Auto-generated by @openrouter/cli types
+// Run `npx @openrouter/cli types` to regenerate
+// Generated: 2025-12-23T14:49:53.976Z
+// Model count: 351
+/**
+ * Hash of model IDs for staleness checking.
+ * Used by postinstall script to detect outdated types.
+ */
+export const MODEL_HASH = '986e77d89072f654';
+//# sourceMappingURL=models.js.map

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.3.12",
+  "version": "0.3.15",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.3.12",
+  "version": "0.3.15",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.",
   "keywords": [
@@ -64,15 +64,17 @@
     "type": "git",
     "url": "https://github.com/OpenRouterTeam/typescript-sdk.git"
   },
-  "scripts": {
-    "lint": "eslint --cache --max-warnings=0 src",
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build",
-    "test": "vitest --run --project unit",
-    "test:e2e": "vitest --run --project e2e",
-    "test:watch": "vitest --watch --project unit"
-  },
+    "scripts": {
+      "lint": "eslint --cache --max-warnings=0 src",
+      "build": "tsc",
+      "typecheck": "tsc --noEmit",
+      "prepublishOnly": "npm run build",
+      "postinstall": "node scripts/check-types.js || true",
+      "test": "vitest --run --project unit",
+      "test:e2e": "vitest --run --project e2e",
+      "test:watch": "vitest --watch --project unit"
+    },
+  "peerDependencies": {},
   "devDependencies": {
     "@eslint/js": "^9.19.0",
     "@types/node": "^22.13.12",

package/scripts/check-types.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * Postinstall script to check if model types are stale.
+ * Similar to update-browserslist-db, this warns users when their
+ * generated types are outdated.
+ *
+ * This script:
+ * 1. Reads the MODEL_HASH from the generated types file
+ * 2. Fetches current models from the OpenRouter API
+ * 3. Computes a hash of the current models
+ * 4. Warns to stderr if the hashes don't match
+ *
+ * Exit codes:
+ * - 0: Types are up to date OR check was skipped
+ * - Does NOT fail on stale types (to avoid breaking installs)
+ */
+
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const TYPES_FILE_PATH = resolve(__dirname, '../src/types/models.ts');
+const API_URL = 'https://openrouter.ai/api/v1/models';
+const TIMEOUT_MS = 5000;
+
+/**
+ * Type guard for Node.js errors with error codes
+ * @param {unknown} error
+ * @returns {error is NodeJS.ErrnoException}
+ */
+function isNodeError(error) {
+  return error instanceof Error && 'code' in error;
+}
+
+/**
+ * Compute SHA-256 hash of sorted model IDs (first 16 chars)
+ * @param {string[]} modelIds
+ * @returns {string}
+ */
+function computeHash(modelIds) {
+  const sorted = [...modelIds].sort();
+  const content = sorted.join('\n');
+  const hash = createHash('sha256').update(content).digest('hex');
+  return hash.substring(0, 16);
+}
+
+/**
+ * Extract MODEL_HASH from types file content
+ * @param {string} content
+ * @returns {string | null}
+ */
+function extractHash(content) {
+  const match = content.match(/export const MODEL_HASH = '([a-f0-9]+)'/);
+  return match ? match[1] : null;
+}
+
+/**
+ * Fetch models from API with timeout
+ * @returns {Promise<string[]>}
+ */
+async function fetchModels() {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+
+  try {
+    const response = await fetch(API_URL, { signal: controller.signal });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    if (!data?.data || !Array.isArray(data.data)) {
+      throw new Error('Invalid API response structure');
+    }
+    return data.data.map((m) => m.id);
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
+async function main() {
+  if (process.env.CI) {
+    return;
+  }
+
+  if (process.env.OPENROUTER_SKIP_TYPE_CHECK) {
+    return;
+  }
+
+  try {
+    /** @type {string | null} */
+    let existingHash;
+    try {
+      const content = await readFile(TYPES_FILE_PATH, 'utf-8');
+      existingHash = extractHash(content);
+    } catch (error) {
+      if (isNodeError(error) && error.code === 'ENOENT') {
+        return;
+      }
+      throw error;
+    }
+
+    if (!existingHash) {
+      return;
+    }
+
+    const modelIds = await fetchModels();
+    const currentHash = computeHash(modelIds);
+
+    if (existingHash !== currentHash) {
+      process.stderr.write(
+        '\n' +
+          '\x1b[33m' +
+          'OpenRouter model types are outdated.\n' +
+          'Run: npx @openrouter/cli types\n' +
+          '\x1b[0m',
+      );
+    }
+  } catch {
+    // Silently ignore errors - we don't want to break installs
+  }
+}
+
+main();

package/esm/models/operations/getparameters.d.ts

@@ -1,87 +0,0 @@
-import * as z from "zod/v4";
-import { OpenEnum } from "../../types/enums.js";
-import { Result as SafeParseResult } from "../../types/fp.js";
-import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-import * as models from "../index.js";
-export type GetParametersSecurity = {
-    bearer: string;
-};
-export type GetParametersRequest = {
-    author: string;
-    slug: string;
-    provider?: models.ProviderName | undefined;
-};
-export declare const SupportedParameter: {
-    readonly Temperature: "temperature";
-    readonly TopP: "top_p";
-    readonly TopK: "top_k";
-    readonly MinP: "min_p";
-    readonly TopA: "top_a";
-    readonly FrequencyPenalty: "frequency_penalty";
-    readonly PresencePenalty: "presence_penalty";
-    readonly RepetitionPenalty: "repetition_penalty";
-    readonly MaxTokens: "max_tokens";
-    readonly LogitBias: "logit_bias";
-    readonly Logprobs: "logprobs";
-    readonly TopLogprobs: "top_logprobs";
-    readonly Seed: "seed";
-    readonly ResponseFormat: "response_format";
-    readonly StructuredOutputs: "structured_outputs";
-    readonly Stop: "stop";
-    readonly Tools: "tools";
-    readonly ToolChoice: "tool_choice";
-    readonly ParallelToolCalls: "parallel_tool_calls";
-    readonly IncludeReasoning: "include_reasoning";
-    readonly Reasoning: "reasoning";
-    readonly ReasoningEffort: "reasoning_effort";
-    readonly WebSearchOptions: "web_search_options";
-    readonly Verbosity: "verbosity";
-};
-export type SupportedParameter = OpenEnum<typeof SupportedParameter>;
-/**
- * Parameter analytics data
- */
-export type GetParametersData = {
-    /**
-     * Model identifier
-     */
-    model: string;
-    /**
-     * List of parameters supported by this model
-     */
-    supportedParameters: Array<SupportedParameter>;
-};
-/**
- * Returns the parameters for the specified model
- */
-export type GetParametersResponse = {
-    /**
-     * Parameter analytics data
-     */
-    data: GetParametersData;
-};
-/** @internal */
-export type GetParametersSecurity$Outbound = {
-    bearer: string;
-};
-/** @internal */
-export declare const GetParametersSecurity$outboundSchema: z.ZodType<GetParametersSecurity$Outbound, GetParametersSecurity>;
-export declare function getParametersSecurityToJSON(getParametersSecurity: GetParametersSecurity): string;
-/** @internal */
-export type GetParametersRequest$Outbound = {
-    author: string;
-    slug: string;
-    provider?: string | undefined;
-};
-/** @internal */
-export declare const GetParametersRequest$outboundSchema: z.ZodType<GetParametersRequest$Outbound, GetParametersRequest>;
-export declare function getParametersRequestToJSON(getParametersRequest: GetParametersRequest): string;
-/** @internal */
-export declare const SupportedParameter$inboundSchema: z.ZodType<SupportedParameter, unknown>;
-/** @internal */
-export declare const GetParametersData$inboundSchema: z.ZodType<GetParametersData, unknown>;
-export declare function getParametersDataFromJSON(jsonString: string): SafeParseResult<GetParametersData, SDKValidationError>;
-/** @internal */
-export declare const GetParametersResponse$inboundSchema: z.ZodType<GetParametersResponse, unknown>;
-export declare function getParametersResponseFromJSON(jsonString: string): SafeParseResult<GetParametersResponse, SDKValidationError>;
-//# sourceMappingURL=getparameters.d.ts.map