@hostwebhook/platform-contracts 0.7.0 → 0.8.1

package/dist/precios/tabla-de-precios.js

@@ -75,6 +75,9 @@ exports.getSuggestedAlternative = getSuggestedAlternative;
 exports.MODEL_PRICING = {
     // OpenAI — GPT series
     'gpt-5.6-sol': { input: 4.00, output: 20.00 },
+    // `gpt-5.6` a secas es el alias documentado de Sol, y sin esta entrada caia
+    // por prefijo en `gpt-5` — otro modelo y otro precio.
+    'gpt-5.6': { input: 4.00, output: 20.00 },
     'gpt-5.6-terra': { input: 2.00, output: 12.00 },
     'gpt-5.6-luna': { input: 0.20, output: 1.20 },
     'gpt-5.5-pro': { input: 30.00, output: 180.00 },
@@ -132,6 +135,30 @@ exports.MODEL_PRICING = {
     'claude-sonnet-4': { input: 3.00, output: 15.00 },
     'claude-sonnet-4-20250514': { input: 3.00, output: 15.00 },
     'claude-haiku-4-5-20251001': { input: 1.00, output: 5.00 },
+    // (!) Sin apellido de fecha, y NO es redundante: la clave fechada es mas
+    // LARGA, asi que la regla de prefijo nunca alcanzaba a `claude-haiku-4-5`.
+    // Y ese es `getDefaultModel('anthropic')` —con el nace todo nodo de IA— y
+    // tambien `PLATFORM_LLM_CHEAP_MODEL`. Mientras falto, cada nodo nuevo salia
+    // a coste CERO y su tope de gasto en dolares no podia saltar jamas.
+    'claude-haiku-4-5': { input: 1.00, output: 5.00 },
+    // ── Groq ────────────────────────────────────────────────────────────────
+    // (!) Estas tres NO estan verificadas contra una pagina oficial de Groq:
+    // console.groq.com/docs/pricing da 404 y groq.com/pricing es marketing. Salen
+    // de agregadores de terceros coincidentes entre si (agosto 2026). Reverificar
+    // en cuanto Groq publique una pagina consultable.
+    //
+    // Aun asi entran: sin ellas el coste sale CERO, y cero no es "barato", es
+    // "un tope de gasto que no salta". Una cifra aproximada de la fuente correcta
+    // protege; la ausencia no protege nada.
+    'openai/gpt-oss-20b': { input: 0.075, output: 0.30 },
+    'openai/gpt-oss-120b': { input: 0.15, output: 0.60 },
+    'qwen/qwen3.6-27b': { input: 0.60, output: 3.00 },
+    //
+    // `groq/compound` y `groq/compound-mini` NO se ponen, y no por falta de dato:
+    // es que NO TIENEN tarifa plana por token. Son sistemas agenticos que
+    // repercuten el modelo subyacente MAS el coste de las herramientas que usan,
+    // asi que no hay un numero unico que sea correcto. Inventar uno seria peor que
+    // el hueco. Quedan en la lista de excepciones del test, con este motivo.
     'claude-3-7-sonnet-20250219': { input: 3.00, output: 15.00 },
     'claude-3-5-sonnet-20241022': { input: 3.00, output: 15.00 },
     'claude-3-5-haiku-20241022': { input: 0.80, output: 4.00 },

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

@@ -32,7 +32,15 @@
  * Antes la puerta leía `memoryEnabled` del documento para decidir; esa decisión
  * se va con el dato, que es donde puede comprobarse.
  */
-/** El nodo conectado, en lo que la puerta lee de él. Cuatro campos, medidos. */
+/**
+ * El nodo conectado, en lo que la puerta lee de él. Siete campos, medidos.
+ *
+ * Los cuatro primeros son lo que la puerta necesitaba para EJECUTAR. Los tres
+ * ú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.
+ */
 export interface NodoDeIaConectado {
     id: string;
     /** Para el paso del historial y para decirle al widget con quién habla. */
@@ -40,6 +48,35 @@ export interface NodoDeIaConectado {
     workspaceId: string | null;
     /** Si el widget enseña las llamadas a herramientas mientras ocurren. */
     muestraLasHerramientas: boolean;
+    /** 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. */
+    model: string;
+    /** El tope de salida del nodo. Es el techo de lo que puede devolver, y la
+     *  estimación es deliberadamente PESIMISTA: reserva el techo entero. */
+    maxTokens: number;
+    /**
+     * La LONGITUD del system prompt del nodo, no el prompt.
+     *
+     * ⚠️ Un `number` y no la cadena, por dos motivos, y los dos importan:
+     *
+     * 1. No hace falta más. La estimación sólo hace `.length`: suma ese largo a
+     *    los caracteres del turno y divide entre tres. El número da exactamente
+     *    el mismo resultado que la cadena, así que mandar la cadena sería mandar
+     *    algo que nadie va a leer.
+     *
+     * 2. Esto CRUZA UNA FRONTERA DE SERVICIO —es el motivo de existir de este
+     *    fichero, y está en su cabecera—, y el `systemPrompt` es contenido del
+     *    cliente. Mandarlo entero lo filtraría a un servicio que no lo necesita.
+     *    Mismo criterio que ya aplica `ChunkingStrategy` en `formas-compartidas`:
+     *    «sólo cruza la ESTRATEGIA, no la configuración entera».
+     *
+     * ⚠️ Y se llama `largoDelSystemPrompt` y no `largoDelPrompt` porque en el
+     * consumidor conviven DOS prompts: el del nodo y el `systemPromptOverride`
+     * del trigger, que lo pisa. El nombre dice cuál se midió — éste es el del
+     * nodo, y quien tenga override medirá el suyo y no usará éste.
+     */
+    largoDelSystemPrompt: number;
 }
 export interface EjecucionDeIa {
     /** El nodo conectado a ese chat, o `null` si ya no existe. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/platform-contracts",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "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",