@hostwebhook/platform-contracts 0.10.0 → 0.11.0

package/dist/servicios/ejecucion-de-ia.d.ts

@@ -32,14 +32,16 @@
  * Antes la puerta leía `memoryEnabled` del documento para decidir; esa decisión
  * se va con el dato, que es donde puede comprobarse.
  */
+import type { LlmProvider } from '@hostwebhook/node-types';
 /**
- * El nodo conectado, en lo que la puerta lee de él. Siete campos, medidos.
+ * El nodo conectado, en lo que la puerta lee de él. Ocho campos, medidos.
  *
- * Los cuatro primeros son lo que la puerta necesitaba para EJECUTAR. Los tres
+ * Los cuatro primeros son lo que la puerta necesitaba para EJECUTAR. Los cuatro
  * últimos son lo que necesita para PONERLE PRECIO al turno antes de ejecutarlo:
  * el Chat Trigger tiene topes en dólares y reserva por adelantado, y esa reserva
- * no se puede calcular sin saber a qué modelo se va a llamar ni cuánto puede
- * devolver. Sin ellos la estimación caía a sus valores por defecto en silencio.
+ * no se puede calcular sin saber de quién ni a qué modelo se va a llamar, ni
+ * cuánto puede devolver. Sin ellos la estimación caía a sus valores por defecto
+ * en silencio.
  */
 export interface NodoDeIaConectado {
     id: string;
@@ -48,6 +50,24 @@ export interface NodoDeIaConectado {
     workspaceId: string | null;
     /** Si el widget enseña las llamadas a herramientas mientras ocurren. */
     muestraLasHerramientas: boolean;
+    /**
+     * El proveedor configurado en el nodo. Viaja porque el nombre del modelo NO
+     * lo determina, y adivinarlo se rompe de la peor manera: en silencio y con
+     * cara de acierto.
+     *
+     * 🔥 El caso que lo cierra: `openai/gpt-oss-20b` es un id REAL de OpenRouter.
+     * Empieza por `openai/`, así que cualquier heurística sobre el nombre lo da
+     * por OpenAI, le pone la tarifa de OpenAI y reserva el tope equivocado. Y no
+     * es un caso de laboratorio: TODO el catálogo de OpenRouter va prefijado con
+     * el nombre del laboratorio de origen (`anthropic/…`, `google/…`), o sea que
+     * el choque es la norma ahí, no la excepción.
+     *
+     * ⚠️ Es la LlmProvider de `node-types`, la misma que elige el selector, y va
+     * obligatorio: opcional dejaría intacto el camino de adivinar, que es justo
+     * lo que sobra. Quien sirva este contrato lee el campo del nodo; no lo
+     * deduzca del modelo.
+     */
+    provider: LlmProvider;
     /** El modelo configurado en el nodo. Sin el nombre no hay tarifa, y sin
      *  tarifa la reserva del tope EN DÓLARES no se puede calcular: los tokens
      *  estimados no son un precio hasta que alguien dice de qué modelo son. */

package/dist/servicios/ejecucion-de-ia.js

@@ -1,38 +1,4 @@
 "use strict";
-/**
- * Lo que el Chat Trigger necesita del nodo de IA.
- *
- * ## Por qué existe
- *
- * `chat-triggers` vive en el gateway —es uno de los cinco nodos de ORIGEN— y
- * `ai-nodes` se muda a hw-nodes. Era el último cruce de la puerta hacia el
- * ejecutor, y el más difícil de los tres: los otros dos eran filas de base de
- * datos; éste lleva STREAMING.
- *
- * ⚠️ Y no se resolvía con el traspaso del motor. El chat NO pasa por el motor,
- * y está escrito en tres sitios de su propio fichero: «chatTrigger is an
- * ingress, not dispatched in-pipeline».
- *
- * ## 🔥 Lo que NO puede cruzar: el documento mutado
- *
- * El código de antes hacía esto:
- *
- *     const aiNode = await this.aiNodeModel.findOne({…});
- *     if (trigger.systemPromptOverride) an.systemPrompt = trigger.systemPromptOverride;
- *     if (an.memoryEnabled) an.memoryUserId = sessionId;
- *     await this.aiNodesService.executeForEvent(aiNode, payload, {…});
- *
- * O sea: la puerta cargaba el documento del nodo, le PARCHEABA dos campos en
- * memoria y se lo pasaba al ejecutor. Un documento de Mongoose parcheado no
- * cruza una red.
- *
- * Así que la puerta deja de cargar el nodo. Manda el id y los dos ajustes, y
- * quien tiene el nodo los aplica.
- *
- * ⚠️ El `sessionId` viaja SIEMPRE y se aplica sólo si el nodo tiene memoria.
- * Antes la puerta leía `memoryEnabled` del documento para decidir; esa decisión
- * se va con el dato, que es donde puede comprobarse.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EJECUCION_DE_IA = void 0;
 /** ⚠️ Cadena y no `Symbol`. */

package/dist/servicios/trazas-de-llm.d.ts

@@ -16,13 +16,34 @@
  * cliente real, que reenvía lo que conteste el servicio de trazas sin darle
  * forma. Tipar aquí una forma que allí no se garantiza sería inventarla.
  */
+import type { LlmProvider } from '@hostwebhook/node-types';
+/**
+ * El proveedor que atendió la llamada, tal como se apunta en la traza.
+ *
+ * 🔥 Se DERIVA de `LlmProvider` en vez de repetirse, y ése es el arreglo. La
+ * lista escrita a mano que había aquí se quedó en los tres primeros: no tenía
+ * ni `groq` —que es proveedor del catálogo desde hace tiempo— ni `openrouter`,
+ * que se añadió en la 1.68.0 de `node-types`. El síntoma no fue un fallo de
+ * compilación sino su contrario: los llamantes escribían
+ * `provider: entity.provider as any` para poder emitir la traza, y ese `as any`
+ * apagaba de paso cualquier otra comprobación del objeto. Derivando, un
+ * proveedor nuevo en el catálogo entra aquí solo.
+ *
+ * ⚠️ Los cuatro de abajo NO están en `LlmProvider` y se quedan a propósito:
+ * esto describe lo que hay APUNTADO, no lo que se puede elegir hoy. `ollama`
+ * tiene su `llm_ollama` en el registro de credenciales aunque no sea un
+ * `LlmProvider`; `mistral`, `cohere` y `custom` son lo que devuelve
+ * `detectProvider` en `precios/tabla-de-precios.ts`. Quitarlos no arreglaría
+ * nada: dejaría de compilar la lectura de trazas que ya existen.
+ */
+export type ProveedorDeTraza = LlmProvider | 'ollama' | 'mistral' | 'cohere' | 'custom';
 /** Lo que se apunta de una llamada al modelo. */
 export interface TrazaDeLlm {
     traceId?: string;
     spanId?: string;
     startTime: string | Date;
     endTime?: string | Date;
-    provider: 'openai' | 'anthropic' | 'google' | 'ollama' | 'mistral' | 'cohere' | 'custom';
+    provider: ProveedorDeTraza;
     model: string;
     operation?: 'chat' | 'completion' | 'embedding' | 'image' | 'audio';
     inputTokens?: number;
@@ -62,6 +83,14 @@ export interface FiltrosDeTrazas {
     aiNodeId?: string;
     status?: 'success' | 'error' | 'timeout';
     model?: string;
+    /**
+     * ⚠️ `string` y NO `ProveedorDeTraza`, a diferencia del campo de la traza.
+     * No es un descuido: esto es un filtro y llega de la query de una pantalla,
+     * o sea de `req.query.provider`, que es una cadena cualquiera. Estrecharlo
+     * obligaría a castear en el borde exactamente igual que hacía el `as any`
+     * que este cambio viene a quitar, y sin ganar nada: un proveedor que no
+     * exista aquí no rompe nada, simplemente no casa con ninguna traza.
+     */
     provider?: string;
     startAfter?: string;
     startBefore?: string;

package/dist/servicios/trazas-de-llm.js

@@ -1,22 +1,4 @@
 "use strict";
-/**
- * Lo que el AI Node apunta y consulta sobre sus llamadas al modelo.
- *
- * Costura de la Fase 2, del lote de las pequeñas. `LlmTracesClientService` es
- * un CLIENTE HTTP contra `hw-llm-traces`, que ya es un servicio aparte — el
- * coste de los logs no vive en esta api. Aun así el nodo no debe conocer al
- * cliente: arrastra su configuración, su reintento y su autenticación.
- *
- * ## Cómo viaja
- *
- * ⚠️ `emitTrace` devuelve `Promise<void>` y su llamante NO la espera: apuntar
- * una traza no puede retrasar una respuesta del modelo ni tumbarla. Eso hay
- * que conservarlo.
- *
- * Las dos consultas devuelven `unknown` a propósito — es lo que devuelve el
- * cliente real, que reenvía lo que conteste el servicio de trazas sin darle
- * forma. Tipar aquí una forma que allí no se garantiza sería inventarla.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TRAZAS_DE_LLM = void 0;
 /** ⚠️ Cadena y no `Symbol`, igual que el resto de tokens de la Fase 2. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/platform-contracts",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Contratos compartidos entre los servicios de HostWebhook: addons del plan, identidad interna, y las formas que cruzan una frontera de red",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,7 +9,7 @@
   ],
   "scripts": {
     "build": "npm --prefix ../node-types run build && tsc",
-    "test": "vitest run",
+    "test": "npm --prefix ../node-types run build && tsc -p tsconfig.tests.json && vitest run",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -26,6 +26,6 @@
   },
   "peerDependencies": {
     "@nestjs/common": ">=11.0.0 <12",
-    "@hostwebhook/node-types": ">=1.68.0 <2"
+    "@hostwebhook/node-types": ">=1.69.0 <2"
   }
 }