@hostwebhook/platform-contracts 0.7.0 → 0.8.0

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.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",