@hostwebhook/node-types 1.67.0 → 1.69.0

package/dist/credentials.d.ts

@@ -36,7 +36,89 @@ export interface CredentialTypeRegistration {
  * Registry — order matters for fallthrough behavior in pickers (most
  * common types first), but not for correctness.
  */
-export declare const CREDENTIAL_TYPES: readonly CredentialTypeRegistration[];
+export declare const CREDENTIAL_TYPES: readonly [{
+    readonly type: "google_service_account";
+}, {
+    readonly type: "oauth2_google";
+}, {
+    readonly type: "oauth2_atlassian";
+}, {
+    readonly type: "mongodb";
+    readonly ssrfValidated: true;
+    readonly tunnelable: true;
+}, {
+    readonly type: "postgres";
+    readonly ssrfValidated: true;
+    readonly tunnelable: true;
+}, {
+    readonly type: "slack_webhook";
+}, {
+    readonly type: "slack_oauth";
+}, {
+    readonly type: "discord_webhook";
+}, {
+    readonly type: "llm_anthropic";
+}, {
+    readonly type: "llm_openai";
+}, {
+    readonly type: "llm_google";
+}, {
+    readonly type: "llm_groq";
+}, {
+    readonly type: "llm_openrouter";
+}, {
+    readonly type: "llm_ollama";
+}, {
+    readonly type: "firecrawl";
+}, {
+    readonly type: "http_auth";
+}, {
+    readonly type: "aws_s3";
+}, {
+    readonly type: "memory_contextwindow";
+}, {
+    readonly type: "memory_mongodb";
+    readonly ssrfValidated: true;
+    readonly tunnelable: true;
+}, {
+    readonly type: "mcp_server";
+}, {
+    readonly type: "voice_agent";
+}, {
+    readonly type: "telegram_bot";
+}, {
+    readonly type: "whatsapp_business";
+}, {
+    readonly type: "discord_bot";
+}, {
+    readonly type: "discord_oauth";
+}, {
+    readonly type: "bluesky_app_password";
+}, {
+    readonly type: "twitter_oauth2";
+}, {
+    readonly type: "mastodon_oauth2";
+}, {
+    readonly type: "linkedin_oauth2";
+}, {
+    readonly type: "threads_oauth2";
+}, {
+    readonly type: "instagram_oauth2";
+}, {
+    readonly type: "facebook_oauth2";
+}, {
+    readonly type: "notion_internal";
+}, {
+    readonly type: "notion_oauth";
+}, {
+    readonly type: "mailchimp_oauth2";
+}, {
+    readonly type: "shopify_oauth2";
+}, {
+    readonly type: "github_app";
+}, {
+    readonly type: "github_pat";
+}];
 /**
  * Plain string array — what the Mongoose `enum` field and the
  * class-validator `@IsIn(...)` decorator both consume. Keep it as a
@@ -51,7 +133,12 @@ export declare const credentialTypeValues: () => string[];
  * Discriminated union of every supported type. Use as the field type
  * on entities + DTOs so a typo at the call site fails at compile
  * time, not at runtime via a Mongoose validation error.
+ *
+ * ⚠️ Y ahora ES una unión. Hasta la 1.69.0 esto valía `string` —la anotación
+ * de `CREDENTIAL_TYPES` ensanchaba los literales— así que la frase de arriba
+ * describía una protección que no existía. Ver el comentario del `satisfies`
+ * al final del registro.
  */
-export type CredentialType = typeof CREDENTIAL_TYPES[number]['type'];
+export type CredentialType = (typeof CREDENTIAL_TYPES)[number]['type'];
 export declare function getCredentialType(type: string): CredentialTypeRegistration | undefined;
 export declare function isCredentialType(type: string): type is CredentialType;

package/dist/credentials.js

@@ -19,6 +19,40 @@ exports.CREDENTIAL_TYPES = [
     { type: 'llm_anthropic' },
     { type: 'llm_openai' },
     { type: 'llm_google' },
+    // La clave de API de Groq (`gsk_…`), que el usuario saca de
+    // https://console.groq.com/keys y pega. Un secreto suyo, sin OAuth de por
+    // medio, igual que los tres de arriba y que `llm_openrouter` de abajo.
+    //
+    // El sufijo es `groq` por la misma regla que explica el bloque de
+    // OpenRouter: de aquí salen `getModelsFor`/`getDefaultModel` quitando el
+    // prefijo `llm_`, así que lo que quede detrás tiene que ser LITERALMENTE el
+    // `LlmProvider`, y ése es `'groq'`.
+    //
+    // 🔥 Llega TARDE, y el agujero que tapa no era teórico: `groq` es un
+    // `LlmProvider` de pleno derecho desde hace tiempo —está en `LLM_PROVIDERS`,
+    // con sus cinco modelos en `LLM_MODELS.groq`— pero no tenía tipo de
+    // credencial. O sea que el proveedor se podía ELEGIR en el selector y no
+    // había dónde guardar su clave: una rama del catálogo inalcanzable, sin un
+    // solo error que lo dijera. El resto de la lista se anota antes de que la
+    // api exista precisamente para no llegar a esto.
+    { type: 'llm_groq' },
+    // La clave de API de OpenRouter (`sk-or-v1-…`). Un secreto pegado por el
+    // usuario, igual que los tres de arriba: no hay OAuth de por medio.
+    //
+    // El sufijo es `openrouter` y no `open_router` porque de aquí sale
+    // `getModelsFor`/`getDefaultModel` quitando el prefijo `llm_` — el resto
+    // tiene que ser LITERALMENTE el `LlmProvider`, y ése es `'openrouter'`.
+    //
+    // ⚠️ Se anota aquí ANTES de que exista nada en la api, por lo que cuenta el
+    // bloque de Mailchimp más abajo: de esta lista salen el `enum` de Mongoose y
+    // el validador del DTO, y un tipo que falte ahí no rompe al compilar — mata
+    // el `create` de la credencial en runtime, con el usuario delante.
+    //
+    // ⚠️ El vecino que faltaba y que este bloque dejó escrito —`groq` sin su
+    // `llm_groq`— ya está arriba. Lo que queda de aquel aviso es la regla que lo
+    // hizo posible, y por eso la cubre ahora un test: cada `LlmProvider` de
+    // `LLM_PROVIDERS` tiene que tener su `llm_*` en esta lista.
+    { type: 'llm_openrouter' },
     { type: 'llm_ollama' },
     { type: 'firecrawl' },
     { type: 'http_auth' },
@@ -141,6 +175,16 @@ exports.CREDENTIAL_TYPES = [
     // que cambia es de dónde sale la lista de repositorios del formulario: los
     // del usuario, en vez de los que abarca una instalación.
     { type: 'github_pat' },
+    /* ⚠️ `as const satisfies …` y no `: readonly CredentialTypeRegistration[]`.
+       Los dos comprueban lo mismo —que cada entrada tenga la forma del registro—,
+       pero la ANOTACIÓN además ENSANCHA lo que se guarda: con ella cada `type` se
+       recuerda como `string`, y entonces `CredentialType` de más abajo es
+       literalmente `string`. O sea que la promesa de su comentario («un typo al
+       asignar falla al compilar») era falsa desde el primer día: `const t:
+       CredentialType = 'llm_openroutr'` compilaba sin rechistar.
+  
+       `satisfies` comprueba y NO ensancha, así que los literales sobreviven y la
+       unión es de verdad. El control está en `tipos-de-credencial.test.ts`. */
 ];
 /**
  * Plain string array — what the Mongoose `enum` field and the

package/dist/index.d.ts

@@ -60,5 +60,7 @@ export { DOCS_TOOLKIT_SPECS, DOCS_TOOLKIT_BY_TOOL_NAME, DOCS_TOOLKIT_DEFAULTABLE
 export type { DocsToolkitSpec, DocsToolkitParameter, } from './docs-toolkit';
 export type { LlmProvider, LlmProviderOption, LlmModelOption, } from './llm-models';
 export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models';
+export type { ModeloDeOpenRouter, PrecioDeOpenRouter, RespuestaDeModelosDeOpenRouter, } from './openrouter';
+export { URL_DE_MODELOS_DE_OPENROUTER, opcionesDeModelosDeOpenRouter, ventanaDeContextoDeOpenRouter, } from './openrouter';
 export type { CredentialTypeRegistration, CredentialType } from './credentials';
 export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials';

package/dist/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DRIVE_OPERATION_SPECS = exports.DRIVE_OPERATIONS = exports.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CALENDAR_TOOLKIT_SPECS = exports.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATION_SPECS = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.resolveGmailSendFields = exports.GMAIL_SEND_LEGACY_FIELDS = exports.NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME = exports.GMAIL_TOOLKIT_BY_TOOL_NAME = exports.NATIVE_EMAIL_TOOLKIT_SPECS = exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = exports.GMAIL_ALL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_OPERATIONS = exports.GMAIL_DROPDOWN_OPERATIONS = exports.GMAIL_OPERATION_GROUPS = exports.GMAIL_OPERATION_SPECS = exports.GMAIL_OPERATIONS = exports.versionCatalogErrors = exports.fieldsLost = exports.fieldsLostBetween = exports.currentVersion = exports.versionSpec = exports.versionsOf = exports.isVersioned = exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.getNodeRegistryEntry = exports.NODE_REGISTRY = exports.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.resolveNodeId = exports.PREFIX_TO_TYPE = exports.NODE_UI = exports.ALL_NODE_TYPES = exports.isNodeType = exports.isTerminal = exports.canSendToNodes = exports.canReceiveFromNodes = exports.canReceiveFrom = exports.NODE_CONNECTIONS = exports.iterableMeta = exports.singleMeta = void 0;
 exports.SLACK_TOOLKIT_SPECS = exports.isSlackOperation = exports.camposDeSlackNoDisponibles = exports.slackPuedeEjecutar = exports.operacionesDeSlackPara = exports.SLACK_CAPACIDADES_POR_CREDENCIAL = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isJiraOperation = exports.JIRA_ITERABLE_OPERATIONS = exports.JIRA_DROPDOWN_OPERATIONS = exports.JIRA_OPERATION_SPECS = exports.JIRA_OPERATIONS = exports.isGithubOperation = exports.GITHUB_ITERABLE_OPERATIONS = exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATION_SPECS = exports.GITHUB_OPERATIONS = exports.isShopifyOperation = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SPECS = exports.SHOPIFY_OPERATIONS = exports.isMailchimpOperation = exports.MAILCHIMP_CONTACT_STATUSES = exports.MAILCHIMP_OPERATION_SPECS = exports.MAILCHIMP_OPERATIONS = exports.herramientasDeDiscordPara = exports.DISCORD_TOOLKIT_BY_TOOL_NAME = exports.DISCORD_TOOLKIT_SPECS = exports.isDiscordOperation = exports.camposDeDiscordNoDisponibles = exports.discordPuedeEjecutar = exports.operacionesDeDiscordPara = exports.DISCORD_CAPACIDADES_POR_CREDENCIAL = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.camposNoDisponiblesPara = exports.puedeEjecutar = exports.operacionesPara = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = void 0;
-exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.getModelLabel = exports.getDefaultModel = exports.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = exports.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isNotionOperation = exports.NOTION_DROPDOWN_OPERATIONS = exports.NOTION_OPERATION_SPECS = exports.NOTION_OPERATIONS = exports.isGoogleAnalyticsOperation = exports.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = exports.GOOGLE_ANALYTICS_OPERATION_SPECS = exports.GOOGLE_ANALYTICS_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.herramientasDeSlackPara = exports.SLACK_TOOLKIT_BY_TOOL_NAME = void 0;
+exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.ventanaDeContextoDeOpenRouter = exports.opcionesDeModelosDeOpenRouter = exports.URL_DE_MODELOS_DE_OPENROUTER = exports.getModelLabel = exports.getDefaultModel = exports.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = exports.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isNotionOperation = exports.NOTION_DROPDOWN_OPERATIONS = exports.NOTION_OPERATION_SPECS = exports.NOTION_OPERATIONS = exports.isGoogleAnalyticsOperation = exports.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = exports.GOOGLE_ANALYTICS_OPERATION_SPECS = exports.GOOGLE_ANALYTICS_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.herramientasDeSlackPara = exports.SLACK_TOOLKIT_BY_TOOL_NAME = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_1.iterableMeta; } });
@@ -193,6 +193,10 @@ Object.defineProperty(exports, "MODEL_CONTEXT_WINDOWS", { enumerable: true, get:
 Object.defineProperty(exports, "getModelsFor", { enumerable: true, get: function () { return llm_models_1.getModelsFor; } });
 Object.defineProperty(exports, "getDefaultModel", { enumerable: true, get: function () { return llm_models_1.getDefaultModel; } });
 Object.defineProperty(exports, "getModelLabel", { enumerable: true, get: function () { return llm_models_1.getModelLabel; } });
+var openrouter_1 = require("./openrouter");
+Object.defineProperty(exports, "URL_DE_MODELOS_DE_OPENROUTER", { enumerable: true, get: function () { return openrouter_1.URL_DE_MODELOS_DE_OPENROUTER; } });
+Object.defineProperty(exports, "opcionesDeModelosDeOpenRouter", { enumerable: true, get: function () { return openrouter_1.opcionesDeModelosDeOpenRouter; } });
+Object.defineProperty(exports, "ventanaDeContextoDeOpenRouter", { enumerable: true, get: function () { return openrouter_1.ventanaDeContextoDeOpenRouter; } });
 var credentials_1 = require("./credentials");
 Object.defineProperty(exports, "CREDENTIAL_TYPES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPES; } });
 Object.defineProperty(exports, "CREDENTIAL_TYPE_VALUES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPE_VALUES; } });

package/dist/llm-models.d.ts

@@ -25,8 +25,18 @@
  *  - OpenAI: https://developers.openai.com/api/docs/models
  *  - Google: https://ai.google.dev/gemini-api/docs/models
  *  - Groq: https://console.groq.com/docs/models
+ *
+ * NOT verified against docs, and on purpose: OpenRouter. Its catalog is not a
+ * list anybody types — see `LLM_MODELS.openrouter` and `openrouter.ts`.
+ */
+export type LlmProvider = 'anthropic' | 'openai' | 'google' | 'groq'
+/**
+ * A router, not a lab: OpenRouter resells ~425 models from everybody else
+ * behind one key. That is why it is the first provider here whose catalog
+ * is EMPTY below and fetched live instead — the shape of the entry is in
+ * `openrouter.ts`, and the price of each model travels with the model.
  */
-export type LlmProvider = 'anthropic' | 'openai' | 'google' | 'groq';
+ | 'openrouter';
 export interface LlmProviderOption {
     value: LlmProvider;
     label: string;
@@ -58,6 +68,13 @@ export declare const LLM_MODELS: Record<LlmProvider, ReadonlyArray<LlmModelOptio
  *
  * Includes ids the pickers no longer offer: the AI node's model field is
  * a free-text datalist, so a node may hold one by hand.
+ *
+ * ⚠️ NOT here: OpenRouter's ids. Same reason its models are not in
+ * `LLM_MODELS` — its API publishes `context_length` per model, so the number
+ * travels with the model instead of being copied 425 times into this table.
+ * Whoever chunks for an OpenRouter model reads it from the fetched entry
+ * (`ModeloDeOpenRouter.context_length`); a lookup here misses and falls back
+ * to the conservative 32k, which still summarizes, just in more calls.
  */
 export declare const MODEL_CONTEXT_WINDOWS: Record<string, number>;
 /**
@@ -71,6 +88,13 @@ export declare function getModelsFor(provider: string): ReadonlyArray<LlmModelOp
  * The suggested default model for a provider, or `''` for one we do not
  * catalog (Ollama runs whatever the user pulled, so it has no entry —
  * callers fall back to the node's own model there).
+ *
+ * ⚠️ `'openrouter'` is the second `''`, and unlike Ollama it IS a provider in
+ * `LLM_PROVIDERS`, so callers that assumed "every provider in the list has a
+ * default" now have a case to handle. It is deliberate: its catalog is live
+ * (see `LLM_MODELS.openrouter`) and no static pick would survive. Treat `''`
+ * as "the user must choose", not as "fall back to something" — a node born
+ * with an empty model must not be sent to the API as-is.
  */
 export declare function getDefaultModel(provider: string): string;
 /** The friendly label for a model value, or the value itself. */

package/dist/llm-models.js

@@ -26,6 +26,9 @@
  *  - OpenAI: https://developers.openai.com/api/docs/models
  *  - Google: https://ai.google.dev/gemini-api/docs/models
  *  - Groq: https://console.groq.com/docs/models
+ *
+ * NOT verified against docs, and on purpose: OpenRouter. Its catalog is not a
+ * list anybody types — see `LLM_MODELS.openrouter` and `openrouter.ts`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = void 0;
@@ -37,6 +40,7 @@ exports.LLM_PROVIDERS = [
     { value: 'openai', label: 'OpenAI' },
     { value: 'google', label: 'Google' },
     { value: 'groq', label: 'Groq' },
+    { value: 'openrouter', label: 'OpenRouter' },
 ];
 exports.LLM_MODELS = {
     // ── Anthropic ──────────────────────────────────────────────────────────
@@ -106,6 +110,38 @@ exports.LLM_MODELS = {
         { value: 'groq/compound-mini', label: 'Compound Mini' },
         { value: 'qwen/qwen3.6-27b', label: 'Qwen 3.6 27B (preview)' },
     ],
+    // ── OpenRouter ─────────────────────────────────────────────────────────
+    // EMPTY ON PURPOSE. Not a gap, not a TODO — read this before filling it.
+    //
+    // Every other provider above is a lab with a dozen models, each with a
+    // price we look up in `MODEL_PRICING` over in platform-contracts. OpenRouter
+    // is a router: ~425 models from everybody else, and the set moves on its own
+    // — models appear, get deprecated and change price without anyone here
+    // touching a file. Typing them out has three separate costs:
+    //
+    //   1. It goes stale silently. That is the exact failure this whole file
+    //      exists to kill (the picker offering a model the api had retired),
+    //      only this time with 425 chances to happen instead of eight.
+    //   2. The price would have to be hand-copied into `MODEL_PRICING` too —
+    //      425 rows of a number the API already hands us with each model. A
+    //      wrong row there does not fail loudly: it makes a dollar spending cap
+    //      cut in the wrong place, or never.
+    //   3. Nobody wants a 425-entry dropdown anyway. The dashboard has to
+    //      search/filter it live regardless of what we ship here.
+    //
+    // So the catalog is FETCHED: `GET https://openrouter.ai/api/v1/models` is
+    // open, needs no key, and each entry carries id, name, context_length AND
+    // its own pricing. `openrouter.ts` types that payload and maps it to the
+    // very same `LlmModelOption` the pickers already render; the pricing half
+    // is `tarifaDeOpenRouter` in `@hostwebhook/platform-contracts`, which turns
+    // it into a `ModelPricing` you hand to `calculateCost(..., tarifa)`.
+    //
+    // Consequence, stated out loud because it is the surprising part:
+    // `getDefaultModel('openrouter')` is `''`. There is no honest default among
+    // 425 models we do not curate — any pick here would be a guess that can be
+    // deprecated out from under us — so choosing a model is REQUIRED when the
+    // provider is OpenRouter. See `getDefaultModel` below.
+    openrouter: [],
 };
 /**
  * Effective context window per model, in TOKENS. The api sizes
@@ -116,6 +152,13 @@ exports.LLM_MODELS = {
  *
  * Includes ids the pickers no longer offer: the AI node's model field is
  * a free-text datalist, so a node may hold one by hand.
+ *
+ * ⚠️ NOT here: OpenRouter's ids. Same reason its models are not in
+ * `LLM_MODELS` — its API publishes `context_length` per model, so the number
+ * travels with the model instead of being copied 425 times into this table.
+ * Whoever chunks for an OpenRouter model reads it from the fetched entry
+ * (`ModeloDeOpenRouter.context_length`); a lookup here misses and falls back
+ * to the conservative 32k, which still summarizes, just in more calls.
  */
 exports.MODEL_CONTEXT_WINDOWS = {
     // Anthropic — the 4.6 generation onward is 1M; Haiku and the 4.5 line
@@ -169,6 +212,13 @@ function getModelsFor(provider) {
  * The suggested default model for a provider, or `''` for one we do not
  * catalog (Ollama runs whatever the user pulled, so it has no entry —
  * callers fall back to the node's own model there).
+ *
+ * ⚠️ `'openrouter'` is the second `''`, and unlike Ollama it IS a provider in
+ * `LLM_PROVIDERS`, so callers that assumed "every provider in the list has a
+ * default" now have a case to handle. It is deliberate: its catalog is live
+ * (see `LLM_MODELS.openrouter`) and no static pick would survive. Treat `''`
+ * as "the user must choose", not as "fall back to something" — a node born
+ * with an empty model must not be sent to the API as-is.
  */
 function getDefaultModel(provider) {
     const models = getModelsFor(provider);

package/dist/openrouter.d.ts

@@ -0,0 +1,142 @@
+/**
+ * El catálogo VIVO de OpenRouter: la forma de lo que devuelve su API y cómo se
+ * convierte en las mismas opciones que ya pintan los desplegables.
+ *
+ * ## Por qué este proveedor no tiene lista en `llm-models.ts`
+ *
+ * Porque no es un laboratorio, es un router: revende ~425 modelos de otros
+ * detrás de una sola clave, y el conjunto se mueve solo. La lista entera está
+ * en `GET https://openrouter.ai/api/v1/models`, que es **abierto y sin clave**
+ * —se puede pedir antes de que el usuario haya pegado ninguna— y cada entrada
+ * trae su `context_length` y **su propio precio**. Copiar eso a mano a
+ * `LLM_MODELS` y a `MODEL_PRICING` sería mantener a mano lo que la API ya da,
+ * con 425 oportunidades de que se quede viejo en silencio.
+ *
+ * ## El reparto, que es lo que hay que entender antes de tocar esto
+ *
+ * De la MISMA respuesta salen dos cosas, y viven en paquetes distintos porque
+ * son de dueños distintos:
+ *
+ *   - **el catálogo** (id, nombre, ventana de contexto) → aquí, porque el
+ *     catálogo de modelos es de este fichero desde siempre;
+ *   - **la tarifa** (`pricing`) → `tarifaDeOpenRouter` en
+ *     `@hostwebhook/platform-contracts`, porque el precio de un token es de
+ *     ese paquete y no de éste.
+ *
+ * Y no al revés: este paquete NO puede importar `ModelPricing`
+ * —`platform-contracts` depende de éste, no al contrario—, así que el tipo que
+ * cruza es el crudo `ModeloDeOpenRouter`. Quien pinte el selector hace UN solo
+ * fetch y pasa cada entrada por las dos funciones.
+ *
+ * ## ⚠️ Esto es una respuesta de red, no un fichero nuestro
+ *
+ * Todo lo que no sea `id` va opcional a propósito. No porque OpenRouter lo
+ * omita hoy, sino porque nada nuestro impide que lo omita mañana, y un campo
+ * declarado obligatorio que llega `undefined` no falla al parsear —TypeScript
+ * no valida en runtime—: falla más tarde y más lejos, leyendo una propiedad de
+ * algo que no está. `id` es la única excepción porque sin él la entrada no
+ * identifica a ningún modelo y no hay nada que ofrecer.
+ *
+ * Verificado contra la respuesta real el 2026-08-31: 425 modelos, los 425 con
+ * `pricing.prompt` y `pricing.completion`, y algunos con un
+ * `top_provider.context_length` MENOR que su `context_length` anunciado.
+ */
+import type { LlmModelOption } from './llm-models';
+/** El endpoint del catálogo. Abierto: no lleva `Authorization`. */
+export declare const URL_DE_MODELOS_DE_OPENROUTER = "https://openrouter.ai/api/v1/models";
+/**
+ * El bloque `pricing` de un modelo.
+ *
+ * ⚠️ Dos trampas, las dos verificadas contra la respuesta real:
+ *
+ *   1. Los valores son **cadenas**, no números: `"0.0000001"`.
+ *   2. Son **por token**, no por millón. `"0.0000001"` = $0,10 por millón.
+ *
+ * O sea que ninguno de estos números se puede meter en un `ModelPricing` sin
+ * pasar por `tarifaDeOpenRouter`, que hace las dos conversiones.
+ *
+ * Se tipa como índice abierto porque OpenRouter publica más claves de las que
+ * usamos (`request`, `image`, `web_search`, `internal_reasoning`, y las de
+ * caché) y añade más sin avisar.
+ */
+export interface PrecioDeOpenRouter {
+    /** USD por token de ENTRADA, como cadena. */
+    prompt?: string | null;
+    /** USD por token de SALIDA, como cadena. */
+    completion?: string | null;
+    /** USD por token leído de caché. Hoy no se usa: ver `tarifaDeOpenRouter`. */
+    input_cache_read?: string | null;
+    /** USD por token escrito en caché. Hoy no se usa. */
+    input_cache_write?: string | null;
+    /** Caché de una hora, cuando el modelo la ofrece. Hoy no se usa. */
+    input_cache_write_1h?: string | null;
+    [otras: string]: unknown;
+}
+/** Una entrada del catálogo de OpenRouter. */
+export interface ModeloDeOpenRouter {
+    /**
+     * Lo que se le manda a la API como `model`, con el laboratorio delante:
+     * `"anthropic/claude-sonnet-5"`, `"openai/gpt-5.6-luna"`.
+     *
+     * ⚠️ Ese prefijo es parte del id y NO se quita. Un `"anthropic/..."`
+     * recortado a `"claude-sonnet-5"` cobraría la tarifa de la tabla estática
+     * —la de comprarle a Anthropic directamente— y OpenRouter no cobra eso.
+     */
+    id: string;
+    /** El id sin el sufijo de variante (`:free`, `:nitro`, `:floor`). */
+    canonical_slug?: string;
+    /** Nombre para humanos: `"Anthropic: Claude Sonnet 5"`. */
+    name?: string;
+    /** Ventana efectiva en TOKENS, tal y como la publica el proveedor. */
+    context_length?: number | null;
+    pricing?: PrecioDeOpenRouter | null;
+    architecture?: {
+        input_modalities?: string[];
+        output_modalities?: string[];
+        tokenizer?: string;
+        [otras: string]: unknown;
+    } | null;
+    top_provider?: {
+        context_length?: number | null;
+        max_completion_tokens?: number | null;
+        is_moderated?: boolean;
+        [otras: string]: unknown;
+    } | null;
+    /** Qué parámetros acepta: `"tools"`, `"reasoning"`, `"structured_outputs"`… */
+    supported_parameters?: string[] | null;
+    [otras: string]: unknown;
+}
+/** El sobre: `{ data: [...] }`. */
+export interface RespuestaDeModelosDeOpenRouter {
+    data?: ModeloDeOpenRouter[] | null;
+}
+/**
+ * Las opciones del desplegable a partir de la respuesta cruda.
+ *
+ * Devuelve `LlmModelOption`, el MISMO tipo que `LLM_MODELS`, para que el
+ * selector no tenga dos formas de modelo según el proveedor: la única
+ * diferencia entre un catálogo y el otro es de dónde salió la lista.
+ *
+ * ⚠️ Ninguna opción sale `recommended`. En los catálogos estáticos esa marca
+ * la pone una persona que ha mirado los precios; aquí no hay nadie mirando, y
+ * una recomendación automática —«el primero», «el más barato»— sería una
+ * decisión de producto tomada por accidente. Sin `recommended`,
+ * `getDefaultModel('openrouter')` sigue siendo `''` y elegir es del usuario.
+ *
+ * Acepta el sobre entero o el array suelto porque quien llama a veces ya lo ha
+ * desenvuelto, y tolera basura (`null`, entradas sin `id`) devolviendo lo que
+ * sí sirve: un catálogo a medias es utilizable, una excepción a media pantalla
+ * no.
+ */
+export declare function opcionesDeModelosDeOpenRouter(respuesta: RespuestaDeModelosDeOpenRouter | ModeloDeOpenRouter[] | null | undefined): LlmModelOption[];
+/**
+ * La ventana de contexto de un modelo de OpenRouter, en tokens, o `undefined`.
+ *
+ * Aparte y con nombre propio porque hay DOS sitios donde viene y no siempre
+ * coinciden: `context_length` es lo que anuncia el modelo, y
+ * `top_provider.context_length` lo que sirve de verdad el proveedor que
+ * OpenRouter va a usar. Gana el más PEQUEÑO de los dos: quien trocea para
+ * resumir prefiere quedarse corto —más llamadas— a que el proveedor le
+ * rechace la petición por pasarse.
+ */
+export declare function ventanaDeContextoDeOpenRouter(modelo: ModeloDeOpenRouter | null | undefined): number | undefined;

package/dist/openrouter.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * El catálogo VIVO de OpenRouter: la forma de lo que devuelve su API y cómo se
+ * convierte en las mismas opciones que ya pintan los desplegables.
+ *
+ * ## Por qué este proveedor no tiene lista en `llm-models.ts`
+ *
+ * Porque no es un laboratorio, es un router: revende ~425 modelos de otros
+ * detrás de una sola clave, y el conjunto se mueve solo. La lista entera está
+ * en `GET https://openrouter.ai/api/v1/models`, que es **abierto y sin clave**
+ * —se puede pedir antes de que el usuario haya pegado ninguna— y cada entrada
+ * trae su `context_length` y **su propio precio**. Copiar eso a mano a
+ * `LLM_MODELS` y a `MODEL_PRICING` sería mantener a mano lo que la API ya da,
+ * con 425 oportunidades de que se quede viejo en silencio.
+ *
+ * ## El reparto, que es lo que hay que entender antes de tocar esto
+ *
+ * De la MISMA respuesta salen dos cosas, y viven en paquetes distintos porque
+ * son de dueños distintos:
+ *
+ *   - **el catálogo** (id, nombre, ventana de contexto) → aquí, porque el
+ *     catálogo de modelos es de este fichero desde siempre;
+ *   - **la tarifa** (`pricing`) → `tarifaDeOpenRouter` en
+ *     `@hostwebhook/platform-contracts`, porque el precio de un token es de
+ *     ese paquete y no de éste.
+ *
+ * Y no al revés: este paquete NO puede importar `ModelPricing`
+ * —`platform-contracts` depende de éste, no al contrario—, así que el tipo que
+ * cruza es el crudo `ModeloDeOpenRouter`. Quien pinte el selector hace UN solo
+ * fetch y pasa cada entrada por las dos funciones.
+ *
+ * ## ⚠️ Esto es una respuesta de red, no un fichero nuestro
+ *
+ * Todo lo que no sea `id` va opcional a propósito. No porque OpenRouter lo
+ * omita hoy, sino porque nada nuestro impide que lo omita mañana, y un campo
+ * declarado obligatorio que llega `undefined` no falla al parsear —TypeScript
+ * no valida en runtime—: falla más tarde y más lejos, leyendo una propiedad de
+ * algo que no está. `id` es la única excepción porque sin él la entrada no
+ * identifica a ningún modelo y no hay nada que ofrecer.
+ *
+ * Verificado contra la respuesta real el 2026-08-31: 425 modelos, los 425 con
+ * `pricing.prompt` y `pricing.completion`, y algunos con un
+ * `top_provider.context_length` MENOR que su `context_length` anunciado.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.URL_DE_MODELOS_DE_OPENROUTER = void 0;
+exports.opcionesDeModelosDeOpenRouter = opcionesDeModelosDeOpenRouter;
+exports.ventanaDeContextoDeOpenRouter = ventanaDeContextoDeOpenRouter;
+/** El endpoint del catálogo. Abierto: no lleva `Authorization`. */
+exports.URL_DE_MODELOS_DE_OPENROUTER = 'https://openrouter.ai/api/v1/models';
+/**
+ * Las opciones del desplegable a partir de la respuesta cruda.
+ *
+ * Devuelve `LlmModelOption`, el MISMO tipo que `LLM_MODELS`, para que el
+ * selector no tenga dos formas de modelo según el proveedor: la única
+ * diferencia entre un catálogo y el otro es de dónde salió la lista.
+ *
+ * ⚠️ Ninguna opción sale `recommended`. En los catálogos estáticos esa marca
+ * la pone una persona que ha mirado los precios; aquí no hay nadie mirando, y
+ * una recomendación automática —«el primero», «el más barato»— sería una
+ * decisión de producto tomada por accidente. Sin `recommended`,
+ * `getDefaultModel('openrouter')` sigue siendo `''` y elegir es del usuario.
+ *
+ * Acepta el sobre entero o el array suelto porque quien llama a veces ya lo ha
+ * desenvuelto, y tolera basura (`null`, entradas sin `id`) devolviendo lo que
+ * sí sirve: un catálogo a medias es utilizable, una excepción a media pantalla
+ * no.
+ */
+function opcionesDeModelosDeOpenRouter(respuesta) {
+    const modelos = Array.isArray(respuesta) ? respuesta : respuesta?.data;
+    if (!Array.isArray(modelos))
+        return [];
+    const opciones = [];
+    for (const modelo of modelos) {
+        if (!modelo || typeof modelo.id !== 'string' || modelo.id === '')
+            continue;
+        opciones.push({
+            value: modelo.id,
+            label: typeof modelo.name === 'string' && modelo.name !== ''
+                ? modelo.name
+                : modelo.id,
+        });
+    }
+    return opciones;
+}
+/**
+ * La ventana de contexto de un modelo de OpenRouter, en tokens, o `undefined`.
+ *
+ * Aparte y con nombre propio porque hay DOS sitios donde viene y no siempre
+ * coinciden: `context_length` es lo que anuncia el modelo, y
+ * `top_provider.context_length` lo que sirve de verdad el proveedor que
+ * OpenRouter va a usar. Gana el más PEQUEÑO de los dos: quien trocea para
+ * resumir prefiere quedarse corto —más llamadas— a que el proveedor le
+ * rechace la petición por pasarse.
+ */
+function ventanaDeContextoDeOpenRouter(modelo) {
+    const candidatas = [
+        modelo?.context_length,
+        modelo?.top_provider?.context_length,
+    ].filter((n) => typeof n === 'number' && Number.isFinite(n) && n > 0);
+    if (candidatas.length === 0)
+        return undefined;
+    return Math.min(...candidatas);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-types",
-  "version": "1.67.0",
+  "version": "1.69.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,7 +9,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "test": "vitest run",
+    "test": "tsc -p tsconfig.tests.json && vitest run",
     "prepublishOnly": "npm run build"
   },
   "keywords": [