@hostwebhook/node-types 1.84.0 → 1.86.0

package/dist/calendly-operations.d.ts

@@ -39,16 +39,21 @@ export declare function isCalendlyOperation(value: unknown): value is CalendlyOp
  */
 export declare const CALENDLY_ITERABLE_OPERATIONS: ReadonlyArray<CalendlyOperation>;
 /**
- * Tipos de parámetro. Los seis primeros son los de Apify. Los dos nuevos:
+ * Tipos de parámetro. Los seis primeros son los de Apify. Los tres nuevos:
  *
- * - `datetime`: una fecha con hora, ISO 8601, en la zona horaria del
- *   usuario; el dashboard la pinta con el selector de Calendar y admite
- *   plantilla (`{{payload.startTime}}`).
+ * - `datetime`: una fecha con hora de PARED (`2026-09-20T10:00:00`, sin
+ *   desfase), que el nodo sitúa en la zona del parámetro `timezone` de esa
+ *   operación —o en la del workspace si no se eligió—, igual que hace el
+ *   nodo de Google Calendar. Con desfase (`Z`, `+02:00`) manda el desfase.
+ *   El dashboard la pinta con el mismo calendario que Calendar y admite
+ *   plantilla (`{{payload.from}}`).
+ * - `timezone`: la zona en la que se leen las fechas de pared de la
+ *   operación. Sin elegir, la del workspace.
  * - `eventType`: un desplegable que lista los tipos de evento de la
  *   credencial (`GET /calendly-actions/event-types`); el valor es la URI del
  *   tipo. Admite plantilla para cuando viene del payload.
  */
-export type CalendlyParamType = "template" | "textarea" | "json" | "select" | "number" | "booleanSelect" | "datetime" | "eventType";
+export type CalendlyParamType = "template" | "textarea" | "json" | "select" | "number" | "booleanSelect" | "datetime" | "timezone" | "eventType";
 export interface CalendlyParamSpec {
     name: string;
     label: string;

package/dist/calendly-operations.js

@@ -88,6 +88,16 @@ const eventType = () => ({
     required: true,
     description: "One of the event types on the connected account (e.g. “30 min intro call”).",
 });
+/* La zona en la que se leen las fechas de pared de la operación. Sin elegir,
+   la del workspace: el dashboard lo dice debajo del selector y el nodo la lee
+   al ejecutar, como Calendar. */
+const timezone = () => ({
+    name: "timezone",
+    label: "Time zone",
+    type: "timezone",
+    advanced: true,
+    description: "The zone the dates above are read in when they carry no offset. Empty = the workspace's time zone.",
+});
 const pageLimit = (max, fallback) => ({
     name: "limit",
     label: "Max results",
@@ -131,6 +141,7 @@ exports.CALENDLY_OPERATION_SPECS = {
                 placeholder: "{{payload.to}}",
                 description: "Only events that start before this moment. Empty = no upper bound.",
             },
+            timezone(),
             {
                 name: "inviteeEmail",
                 label: "Invitee email",
@@ -278,6 +289,7 @@ exports.CALENDLY_OPERATION_SPECS = {
                 placeholder: "{{payload.to}}",
                 description: "End of the window — at most 7 days after From. A longer window is cut to 7 days.",
             },
+            timezone(),
         ],
     },
     createSchedulingLink: {

package/dist/esm/calendly-operations.d.ts

@@ -39,16 +39,21 @@ export declare function isCalendlyOperation(value: unknown): value is CalendlyOp
  */
 export declare const CALENDLY_ITERABLE_OPERATIONS: ReadonlyArray<CalendlyOperation>;
 /**
- * Tipos de parámetro. Los seis primeros son los de Apify. Los dos nuevos:
+ * Tipos de parámetro. Los seis primeros son los de Apify. Los tres nuevos:
  *
- * - `datetime`: una fecha con hora, ISO 8601, en la zona horaria del
- *   usuario; el dashboard la pinta con el selector de Calendar y admite
- *   plantilla (`{{payload.startTime}}`).
+ * - `datetime`: una fecha con hora de PARED (`2026-09-20T10:00:00`, sin
+ *   desfase), que el nodo sitúa en la zona del parámetro `timezone` de esa
+ *   operación —o en la del workspace si no se eligió—, igual que hace el
+ *   nodo de Google Calendar. Con desfase (`Z`, `+02:00`) manda el desfase.
+ *   El dashboard la pinta con el mismo calendario que Calendar y admite
+ *   plantilla (`{{payload.from}}`).
+ * - `timezone`: la zona en la que se leen las fechas de pared de la
+ *   operación. Sin elegir, la del workspace.
  * - `eventType`: un desplegable que lista los tipos de evento de la
  *   credencial (`GET /calendly-actions/event-types`); el valor es la URI del
  *   tipo. Admite plantilla para cuando viene del payload.
  */
-export type CalendlyParamType = "template" | "textarea" | "json" | "select" | "number" | "booleanSelect" | "datetime" | "eventType";
+export type CalendlyParamType = "template" | "textarea" | "json" | "select" | "number" | "booleanSelect" | "datetime" | "timezone" | "eventType";
 export interface CalendlyParamSpec {
     name: string;
     label: string;

package/dist/esm/calendly-operations.js

@@ -84,6 +84,16 @@ const eventType = () => ({
     required: true,
     description: "One of the event types on the connected account (e.g. “30 min intro call”).",
 });
+/* La zona en la que se leen las fechas de pared de la operación. Sin elegir,
+   la del workspace: el dashboard lo dice debajo del selector y el nodo la lee
+   al ejecutar, como Calendar. */
+const timezone = () => ({
+    name: "timezone",
+    label: "Time zone",
+    type: "timezone",
+    advanced: true,
+    description: "The zone the dates above are read in when they carry no offset. Empty = the workspace's time zone.",
+});
 const pageLimit = (max, fallback) => ({
     name: "limit",
     label: "Max results",
@@ -127,6 +137,7 @@ export const CALENDLY_OPERATION_SPECS = {
                 placeholder: "{{payload.to}}",
                 description: "Only events that start before this moment. Empty = no upper bound.",
             },
+            timezone(),
             {
                 name: "inviteeEmail",
                 label: "Invitee email",
@@ -274,6 +285,7 @@ export const CALENDLY_OPERATION_SPECS = {
                 placeholder: "{{payload.to}}",
                 description: "End of the window — at most 7 days after From. A longer window is cut to 7 days.",
             },
+            timezone(),
         ],
     },
     createSchedulingLink: {

package/dist/esm/index.d.ts

@@ -2,6 +2,10 @@ export type { NodeType, NodeRole, HandlePosition, NodeConnectionConfig, NodeUICo
 export { singleMeta, iterableMeta } from './types.js';
 export { NODE_CONNECTIONS, canReceiveFrom, canReceiveFromNodes, canSendToNodes, isTerminal, isNodeType, ALL_NODE_TYPES, } from './connections.js';
 export { NODE_UI, PREFIX_TO_TYPE, resolveNodeId, } from './ui.js';
+export { SENTIMENT_LABELS, SENTIMENT_UNCLEAR, SENTIMENT_PORTS, SENTIMENT_PORT_LABEL, SENTIMENT_PORT_SUMMARY, esEtiquetaDeSentimiento, } from './sentiment.js';
+export type { SentimentLabel, SentimentPort } from './sentiment.js';
+export { outputGroupsFor, todosLosOutputGroups } from './types.js';
+export type { OutputGroupsConfig } from './types.js';
 export { NODE_DISPATCH, getAllNodeCollections, getNodeDispatchConfig, pasaLoQueRecibe, } from './dispatch.js';
 export type { NodeRegistryEntry, NodeGroup, NodeVersionSpec, VersionCatalog, } from './registry.js';
 export { NODE_REGISTRY, getNodeRegistryEntry, NODE_DETAIL_PATHS, NODE_COLORS, NODE_STATE_KEYS, PREFIX_TO_NODE_TYPE, NODE_TYPE_TO_PREFIX, } from './registry.js';

package/dist/esm/index.js

@@ -3,6 +3,8 @@ export { singleMeta, iterableMeta } from './types.js';
 export { NODE_CONNECTIONS, canReceiveFrom, canReceiveFromNodes, canSendToNodes, isTerminal, isNodeType, ALL_NODE_TYPES, } from './connections.js';
 // ── UI config (Dashboard only) ──
 export { NODE_UI, PREFIX_TO_TYPE, resolveNodeId, } from './ui.js';
+export { SENTIMENT_LABELS, SENTIMENT_UNCLEAR, SENTIMENT_PORTS, SENTIMENT_PORT_LABEL, SENTIMENT_PORT_SUMMARY, esEtiquetaDeSentimiento, } from './sentiment.js';
+export { outputGroupsFor, todosLosOutputGroups } from './types.js';
 // ── Dispatch config ──
 /* Ya no es «API only»: `downstreamPayload` lo lee tambien el panel, que sin el
    ensenaba como entrada de un nodo la salida del que pasa de largo. */

package/dist/esm/sentiment.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Sentiment analysis en el AI Node — las etiquetas, los puertos y el orden.
+ *
+ * ## Por qué vive aquí y no en cada repo
+ *
+ * Las tres etiquetas son a la vez TRES cosas: el `enum` del esquema que se le
+ * da al modelo, el nombre de los puertos por los que el nodo despacha, y las
+ * pastillas de la tarjeta del lienzo. Si el api, hw-nodes y el dashboard
+ * escriben su propia lista, la primera que alguien reordene o rebautice deja
+ * una arista apuntando a un puerto que ya no existe — y eso no lo dice ningún
+ * compilador. Es el mismo motivo por el que las operaciones de cada nodo
+ * viven en este paquete.
+ *
+ * ## Por qué `unclear` no es una etiqueta más
+ *
+ * El modelo elige entre las TRES de `SENTIMENT_LABELS`; `unclear` no se le
+ * ofrece nunca. Es lo que hace el NODO cuando la confianza queda por debajo
+ * del umbral (`sentimentThreshold`) o cuando la respuesta no se puede leer.
+ * Ofrecérsela al modelo sería darle una salida cómoda para no mojarse, que es
+ * justo lo contrario de lo que se busca al poner un umbral.
+ *
+ * A diferencia del `other` del clasificador, `unclear` SÍ tiene puerto: el
+ * caso de uso es mandar a revisión humana lo que el modelo no ve claro, y sin
+ * puerto eso obligaba a adivinar por qué un item no salió por ninguna rama.
+ */
+/** Lo que el modelo puede contestar, en orden de peor a mejor. */
+export declare const SENTIMENT_LABELS: readonly ["negative", "neutral", "positive"];
+export type SentimentLabel = (typeof SENTIMENT_LABELS)[number];
+/** La salida del nodo cuando no hay etiqueta fiable. No se le ofrece al modelo. */
+export declare const SENTIMENT_UNCLEAR = "unclear";
+/** Los cuatro puertos del modo sentiment, en el orden en que se pintan. */
+export declare const SENTIMENT_PORTS: readonly ["negative", "neutral", "positive", "unclear"];
+export type SentimentPort = (typeof SENTIMENT_PORTS)[number];
+/** El nombre que ve la persona, por puerto. */
+export declare const SENTIMENT_PORT_LABEL: Record<SentimentPort, string>;
+/** Qué significa cada puerto, para el modal de conexión y la doc. */
+export declare const SENTIMENT_PORT_SUMMARY: Record<SentimentPort, string>;
+/** ¿Es una de las tres que el modelo puede contestar? */
+export declare function esEtiquetaDeSentimiento(v: unknown): v is SentimentLabel;

package/dist/esm/sentiment.js

@@ -0,0 +1,53 @@
+/**
+ * Sentiment analysis en el AI Node — las etiquetas, los puertos y el orden.
+ *
+ * ## Por qué vive aquí y no en cada repo
+ *
+ * Las tres etiquetas son a la vez TRES cosas: el `enum` del esquema que se le
+ * da al modelo, el nombre de los puertos por los que el nodo despacha, y las
+ * pastillas de la tarjeta del lienzo. Si el api, hw-nodes y el dashboard
+ * escriben su propia lista, la primera que alguien reordene o rebautice deja
+ * una arista apuntando a un puerto que ya no existe — y eso no lo dice ningún
+ * compilador. Es el mismo motivo por el que las operaciones de cada nodo
+ * viven en este paquete.
+ *
+ * ## Por qué `unclear` no es una etiqueta más
+ *
+ * El modelo elige entre las TRES de `SENTIMENT_LABELS`; `unclear` no se le
+ * ofrece nunca. Es lo que hace el NODO cuando la confianza queda por debajo
+ * del umbral (`sentimentThreshold`) o cuando la respuesta no se puede leer.
+ * Ofrecérsela al modelo sería darle una salida cómoda para no mojarse, que es
+ * justo lo contrario de lo que se busca al poner un umbral.
+ *
+ * A diferencia del `other` del clasificador, `unclear` SÍ tiene puerto: el
+ * caso de uso es mandar a revisión humana lo que el modelo no ve claro, y sin
+ * puerto eso obligaba a adivinar por qué un item no salió por ninguna rama.
+ */
+/** Lo que el modelo puede contestar, en orden de peor a mejor. */
+export const SENTIMENT_LABELS = ['negative', 'neutral', 'positive'];
+/** La salida del nodo cuando no hay etiqueta fiable. No se le ofrece al modelo. */
+export const SENTIMENT_UNCLEAR = 'unclear';
+/** Los cuatro puertos del modo sentiment, en el orden en que se pintan. */
+export const SENTIMENT_PORTS = [
+    ...SENTIMENT_LABELS,
+    SENTIMENT_UNCLEAR,
+];
+/** El nombre que ve la persona, por puerto. */
+export const SENTIMENT_PORT_LABEL = {
+    negative: 'Negative',
+    neutral: 'Neutral',
+    positive: 'Positive',
+    unclear: 'Unclear',
+};
+/** Qué significa cada puerto, para el modal de conexión y la doc. */
+export const SENTIMENT_PORT_SUMMARY = {
+    negative: 'Complaints, frustration, criticism',
+    neutral: 'Factual, mixed, or no clear feeling',
+    positive: 'Praise, satisfaction, enthusiasm',
+    unclear: 'Below the confidence floor, or unreadable',
+};
+/** ¿Es una de las tres que el modelo puede contestar? */
+export function esEtiquetaDeSentimiento(v) {
+    return (typeof v === 'string' &&
+        SENTIMENT_LABELS.includes(v));
+}

package/dist/esm/types.d.ts

@@ -54,83 +54,15 @@ export interface NodeUIConfig {
         connectModal?: 'branch' | 'output-group';
         routerTargetLabel?: string;
         /**
-         * Generic named output groups — used by connectModal: 'output-group'.
-         * The modal reads entity[outputGroupsField] as an array of groups,
-         * each with a name (outputGroupNameField), a summary (outputGroupSummaryField),
-         * and its own outputNodes[].
-         * Works for Split (outputs[]), Conditional (branches[]), or any future branching node.
+         * Los juegos de salidas de un nodo que ramifica: UNO, o VARIOS con su
+         * `gate` cada uno [2026-09-22]. Con varios, quien pregunta se queda con
+         * el PRIMERO cuya puerta pasa — ver `outputGroupsFor`. El AI Node los
+         * necesita porque ramifica de dos maneras según el modo: por las
+         * categorías que escribe el usuario (`classifier`) o por los cuatro
+         * puertos fijos del análisis de sentimiento (`sentiment`). La forma
+         * vieja (un objeto suelto) sigue valiendo y significa «sin alternativas».
          */
-        outputGroups?: {
-            /** Entity field containing the array of groups (e.g. 'outputs', 'branches') */
-            field?: string;
-            /** Field within each group for display name (e.g. 'name') */
-            nameField?: string;
-            /** Field within each group for summary/description (e.g. 'field', 'filterMode') */
-            summaryField?: string;
-            /**
-             * Varios campos del grupo, unidos por espacios, cuando el resumen que
-             * de verdad identifica al grupo no cabe en uno solo.
-             *
-             * Existe por las reglas del router: su condición son TRES campos
-             * (`field`, `operator`, `value`) y el modal a medida que se retiró las
-             * pintaba juntas — «status eq active». Con un único `summaryField` una
-             * regla sin `label` quedaba en «rule 1» y «status», que no dice a qué
-             * se está conectando uno.
-             *
-             * Los campos vacíos se saltan, para que una regla con operador
-             * `exists` no salga con un espacio colgando al final.
-             */
-            summaryFields?: string[];
-            /** Label shown in the modal (e.g. 'output', 'branch') */
-            label: string;
-            /** Entity field for the fallback/else path (e.g. 'elseOutputNodes') */
-            elseField?: string;
-            /**
-             * Fixed output groups — for nodes with a static set of outputs (e.g. approval: approve/reject).
-             * Each entry maps to a top-level entity field that holds outputNodes[].
-             * When set, `field`/`nameField` are ignored — modal shows these fixed options.
-             */
-            fixedGroups?: Array<{
-                name: string;
-                field: string;
-            }>;
-            /**
-             * Optional content-aware gate — the output-group modal only opens
-             * when `entity[gate.field] === gate.value`. Lets a node opt into
-             * multi-branch routing only in some modes (e.g. AI Node in
-             * classifier mode) without trapping every connection in the
-             * picker the rest of the time. When the gate fails, the
-             * FlowCanvas falls through to the universal
-             * `entity.outputNodes` connect path.
-             */
-            gate?: {
-                field: string;
-                value: unknown;
-            };
-            /**
-             * Qué es el puerto `main` de este nodo MIENTRAS su contenedor está
-             * vacío. Sin esto, conectar a un nodo que ramifica y todavía no tiene
-             * ninguna salida escribía una arista en `main` **en silencio**, y el
-             * usuario no tenía forma de saber qué había pasado con ella.
-             *
-             * No hay una respuesta única, y por eso es un dato y no una regla.
-             * Medido en `api/src/common/pipeline-run.service.ts`:
-             *
-             *   'passthrough'       — router sin reglas: `rules.length === 0
-             *                         ? refsForPort(entity, MAIN_PORT) : []`. La
-             *                         arista SÍ dispara... hasta que se cree la
-             *                         primera regla, y entonces deja de hacerlo
-             *                         sin avisar.
-             *   'never-dispatched'  — split: no tiene salida `main`, y el propio
-             *                         despachador registra un warning por cada
-             *                         arista que se quedó en ese puerto.
-             *
-             * Se declara sólo donde se ha medido. Sin declarar, el lienzo se
-             * comporta como siempre: conecta por el camino universal y no dice
-             * nada, que es lo que hacía antes de existir este campo.
-             */
-            emptyContainerMain?: 'passthrough' | 'never-dispatched';
-        };
+        outputGroups?: OutputGroupsConfig | OutputGroupsConfig[];
         /**
          * Maps output fields to alternate payload fields on the source entity.
          * When a downstream node is connected via a specific output field,
@@ -224,3 +156,106 @@ export interface PrefixMapping {
     /** Canvas node type used in React Flow nodeTypes map (e.g. "cache-node", "email-action") */
     canvasType: string;
 }
+/**
+ * Un juego de salidas de un nodo que ramifica.
+ *
+ * Vivía dentro de `NodeUIConfig.special` como un objeto anónimo; sale aquí
+ * [2026-09-22] para poder declarar varios por nodo y para que quien los lea
+ * nombre el tipo en vez de repetir su forma.
+ */
+export interface OutputGroupsConfig {
+    /** Entity field containing the array of groups (e.g. 'outputs', 'branches') */
+    field?: string;
+    /** Field within each group for display name (e.g. 'name') */
+    nameField?: string;
+    /** Field within each group for summary/description (e.g. 'field', 'filterMode') */
+    summaryField?: string;
+    /**
+     * Varios campos del grupo, unidos por espacios, cuando el resumen que
+     * de verdad identifica al grupo no cabe en uno solo.
+     *
+     * Existe por las reglas del router: su condición son TRES campos
+     * (`field`, `operator`, `value`) y el modal a medida que se retiró las
+     * pintaba juntas — «status eq active». Con un único `summaryField` una
+     * regla sin `label` quedaba en «rule 1» y «status», que no dice a qué
+     * se está conectando uno.
+     *
+     * Los campos vacíos se saltan, para que una regla con operador
+     * `exists` no salga con un espacio colgando al final.
+     */
+    summaryFields?: string[];
+    /** Label shown in the modal (e.g. 'output', 'branch') */
+    label: string;
+    /** Entity field for the fallback/else path (e.g. 'elseOutputNodes') */
+    elseField?: string;
+    /**
+     * Fixed output groups — for nodes with a static set of outputs (e.g. approval: approve/reject).
+     * When set, `field`/`nameField` are ignored — modal shows these fixed options.
+     *
+     * Cada entrada nombra su puerto de una de dos formas, y sólo una:
+     *   · `field` — un campo de primer nivel de los de ANTES de que los puertos
+     *     existieran (`rejectionOutputNodes` → puerto `rejected`); se traduce
+     *     con el mapa de campos heredados.
+     *   · `port`  — el puerto, tal cual. Es lo que usan las salidas nacidas ya
+     *     con puertos (las cuatro de sentiment): inventarles un campo heredado
+     *     que nunca existió sería mentir en el registro.
+     */
+    fixedGroups?: Array<{
+        name: string;
+        field?: string;
+        port?: string;
+        /** Una línea de qué entrega ese puerto, para el modal de conexión. */
+        summary?: string;
+    }>;
+    /**
+     * Optional content-aware gate — the output-group modal only opens
+     * when `entity[gate.field] === gate.value`. Lets a node opt into
+     * multi-branch routing only in some modes (e.g. AI Node in
+     * classifier mode) without trapping every connection in the
+     * picker the rest of the time. When the gate fails, the
+     * FlowCanvas falls through to the universal
+     * `entity.outputNodes` connect path.
+     */
+    gate?: {
+        field: string;
+        value: unknown;
+    };
+    /**
+     * Qué es el puerto `main` de este nodo MIENTRAS su contenedor está
+     * vacío. Sin esto, conectar a un nodo que ramifica y todavía no tiene
+     * ninguna salida escribía una arista en `main` **en silencio**, y el
+     * usuario no tenía forma de saber qué había pasado con ella.
+     *
+     * No hay una respuesta única, y por eso es un dato y no una regla.
+     * Medido en `api/src/common/pipeline-run.service.ts`:
+     *
+     *   'passthrough'       — router sin reglas: `rules.length === 0
+     *                         ? refsForPort(entity, MAIN_PORT) : []`. La
+     *                         arista SÍ dispara... hasta que se cree la
+     *                         primera regla, y entonces deja de hacerlo
+     *                         sin avisar.
+     *   'never-dispatched'  — split: no tiene salida `main`, y el propio
+     *                         despachador registra un warning por cada
+     *                         arista que se quedó en ese puerto.
+     *
+     * Se declara sólo donde se ha medido. Sin declarar, el lienzo se
+     * comporta como siempre: conecta por el camino universal y no dice
+     * nada, que es lo que hacía antes de existir este campo.
+     */
+    emptyContainerMain?: 'passthrough' | 'never-dispatched';
+}
+/**
+ * El juego de salidas que aplica AHORA a esta entidad, o `undefined` si el
+ * nodo no ramifica en este momento.
+ *
+ * Es la única lectura de `special.outputGroups` que entiende las dos formas
+ * (uno o varios) y las dos puertas (con `gate` o sin ella). Todo el que
+ * pregunte tiene que pasar por aquí: el lienzo, el modal de conexión y el
+ * despachador. Escribirlo cada uno a su manera es como el router acabó con un
+ * camino propio que nadie arregló al arreglar el de los demás.
+ */
+export declare function outputGroupsFor(config: NodeUIConfig | undefined | null, entity: Record<string, unknown> | undefined | null): OutputGroupsConfig | undefined;
+/** Todos los juegos declarados, pasen o no su puerta. Para quien necesita el
+ *  UNIVERSO de puertos que un tipo puede emitir (la auditoría de puertos),
+ *  no el de ahora mismo. */
+export declare function todosLosOutputGroups(config: NodeUIConfig | undefined | null): OutputGroupsConfig[];

package/dist/esm/types.js

@@ -6,3 +6,29 @@ export function singleMeta() {
 export function iterableMeta(field, count) {
     return { iterable: true, iterateField: field, count };
 }
+/**
+ * El juego de salidas que aplica AHORA a esta entidad, o `undefined` si el
+ * nodo no ramifica en este momento.
+ *
+ * Es la única lectura de `special.outputGroups` que entiende las dos formas
+ * (uno o varios) y las dos puertas (con `gate` o sin ella). Todo el que
+ * pregunte tiene que pasar por aquí: el lienzo, el modal de conexión y el
+ * despachador. Escribirlo cada uno a su manera es como el router acabó con un
+ * camino propio que nadie arregló al arreglar el de los demás.
+ */
+export function outputGroupsFor(config, entity) {
+    const declarado = config?.special?.outputGroups;
+    if (!declarado)
+        return undefined;
+    const lista = Array.isArray(declarado) ? declarado : [declarado];
+    return lista.find((c) => !c.gate || entity?.[c.gate.field] === c.gate.value);
+}
+/** Todos los juegos declarados, pasen o no su puerta. Para quien necesita el
+ *  UNIVERSO de puertos que un tipo puede emitir (la auditoría de puertos),
+ *  no el de ahora mismo. */
+export function todosLosOutputGroups(config) {
+    const declarado = config?.special?.outputGroups;
+    if (!declarado)
+        return [];
+    return Array.isArray(declarado) ? declarado : [declarado];
+}

package/dist/esm/ui.js

@@ -2,6 +2,7 @@
  * Dashboard UI config — handle positions, dot visibility, canvas prefixes.
  * Only imported by the Dashboard. Broker and API don't need this.
  */
+import { SENTIMENT_PORTS, SENTIMENT_PORT_LABEL, SENTIMENT_PORT_SUMMARY, } from './sentiment.js';
 export const NODE_UI = {
     // ── Source nodes ──
     // Una fuente arranca el flujo: `fromNodes: false` significa que nada puede
@@ -45,7 +46,15 @@ export const NODE_UI = {
     // no handle and no route. In any other outputMode the node falls back to
     // the single right-out handle NodeShell renders when no dynamic outputs
     // materialize.
-    ai: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { loopBackAllowed: true, connectModal: 'output-group', outputGroups: { field: 'categories', nameField: 'name', summaryField: 'description', label: 'category', gate: { field: 'outputMode', value: 'classifier' } } } },
+    // En modo `sentiment` (2026-09-22) el abanico son CUATRO puertos fijos
+    // —negative / neutral / positive / unclear— y no un contenedor del usuario:
+    // el modelo elige entre las tres primeras y el nodo manda a `unclear` lo que
+    // no llega al umbral de confianza. Por eso el AI Node declara DOS juegos de
+    // salidas, uno por modo; `outputGroupsFor` elige el que toca.
+    ai: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { loopBackAllowed: true, connectModal: 'output-group', outputGroups: [
+                { field: 'categories', nameField: 'name', summaryField: 'description', label: 'category', gate: { field: 'outputMode', value: 'classifier' } },
+                { label: 'sentiment', gate: { field: 'outputMode', value: 'sentiment' }, fixedGroups: SENTIMENT_PORTS.map((p) => ({ name: SENTIMENT_PORT_LABEL[p], port: p, summary: SENTIMENT_PORT_SUMMARY[p] })) },
+            ] } },
     markdown: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },
     fileTransform: { fromNodes: true, toNodes: true },
     limit: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },

package/dist/index.d.ts

@@ -2,6 +2,10 @@ export type { NodeType, NodeRole, HandlePosition, NodeConnectionConfig, NodeUICo
 export { singleMeta, iterableMeta } from './types.js';
 export { NODE_CONNECTIONS, canReceiveFrom, canReceiveFromNodes, canSendToNodes, isTerminal, isNodeType, ALL_NODE_TYPES, } from './connections.js';
 export { NODE_UI, PREFIX_TO_TYPE, resolveNodeId, } from './ui.js';
+export { SENTIMENT_LABELS, SENTIMENT_UNCLEAR, SENTIMENT_PORTS, SENTIMENT_PORT_LABEL, SENTIMENT_PORT_SUMMARY, esEtiquetaDeSentimiento, } from './sentiment.js';
+export type { SentimentLabel, SentimentPort } from './sentiment.js';
+export { outputGroupsFor, todosLosOutputGroups } from './types.js';
+export type { OutputGroupsConfig } from './types.js';
 export { NODE_DISPATCH, getAllNodeCollections, getNodeDispatchConfig, pasaLoQueRecibe, } from './dispatch.js';
 export type { NodeRegistryEntry, NodeGroup, NodeVersionSpec, VersionCatalog, } from './registry.js';
 export { NODE_REGISTRY, getNodeRegistryEntry, NODE_DETAIL_PATHS, NODE_COLORS, NODE_STATE_KEYS, PREFIX_TO_NODE_TYPE, NODE_TYPE_TO_PREFIX, } from './registry.js';

package/dist/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.pasaLoQueRecibe = 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.BUCKET_ITERABLE_OPERATIONS = exports.BUCKET_OPERATION_SPECS = exports.BUCKET_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.scopesQueFaltanEnShopify = exports.isShopifyOperation = exports.SHOPIFY_PRODUCT_STATUSES = exports.SHOPIFY_CANCEL_REASONS = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SCOPES = 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 = exports.DRIVE_OPERATION_SPECS = void 0;
-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 = 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.isAirtableOperation = exports.AIRTABLE_ITERABLE_OPERATIONS = exports.AIRTABLE_OPERATION_SPECS = exports.AIRTABLE_OPERATIONS = exports.isCalendlyOperation = exports.CALENDLY_ITERABLE_OPERATIONS = exports.CALENDLY_OPERATION_SPECS = exports.CALENDLY_OPERATIONS = exports.isApifyOperation = exports.APIFY_ITERABLE_OPERATIONS = exports.APIFY_OPERATION_SPECS = exports.APIFY_OPERATIONS = exports.isBucketOperation = void 0;
-exports.armarRespuestaDelSync = exports.RESPUESTA_DEL_SYNC_POR_DEFECTO = exports.TOPE_DE_ESPERA_DEL_SYNC = exports.TOPES_DE_ESTADO = exports.SOBRES_DE_RESPUESTA = exports.MODOS_DE_PAYLOAD = exports.NIVELES_DE_DETALLE = exports.RESULTADOS_DEL_VALIDADOR = exports.contestaEnSync = exports.NODOS_QUE_CONTESTAN_EN_SYNC = 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 = void 0;
+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.pasaLoQueRecibe = exports.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.todosLosOutputGroups = exports.outputGroupsFor = exports.esEtiquetaDeSentimiento = exports.SENTIMENT_PORT_SUMMARY = exports.SENTIMENT_PORT_LABEL = exports.SENTIMENT_PORTS = exports.SENTIMENT_UNCLEAR = exports.SENTIMENT_LABELS = 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.isGithubOperation = exports.GITHUB_ITERABLE_OPERATIONS = exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATION_SPECS = exports.GITHUB_OPERATIONS = exports.scopesQueFaltanEnShopify = exports.isShopifyOperation = exports.SHOPIFY_PRODUCT_STATUSES = exports.SHOPIFY_CANCEL_REASONS = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SCOPES = 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 = 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 = void 0;
+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 = 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.isAirtableOperation = exports.AIRTABLE_ITERABLE_OPERATIONS = exports.AIRTABLE_OPERATION_SPECS = exports.AIRTABLE_OPERATIONS = exports.isCalendlyOperation = exports.CALENDLY_ITERABLE_OPERATIONS = exports.CALENDLY_OPERATION_SPECS = exports.CALENDLY_OPERATIONS = exports.isApifyOperation = exports.APIFY_ITERABLE_OPERATIONS = exports.APIFY_OPERATION_SPECS = exports.APIFY_OPERATIONS = exports.isBucketOperation = exports.BUCKET_ITERABLE_OPERATIONS = exports.BUCKET_OPERATION_SPECS = exports.BUCKET_OPERATIONS = exports.isJiraOperation = exports.JIRA_ITERABLE_OPERATIONS = exports.JIRA_DROPDOWN_OPERATIONS = exports.JIRA_OPERATION_SPECS = exports.JIRA_OPERATIONS = void 0;
+exports.armarRespuestaDelSync = exports.RESPUESTA_DEL_SYNC_POR_DEFECTO = exports.TOPE_DE_ESPERA_DEL_SYNC = exports.TOPES_DE_ESTADO = exports.SOBRES_DE_RESPUESTA = exports.MODOS_DE_PAYLOAD = exports.NIVELES_DE_DETALLE = exports.RESULTADOS_DEL_VALIDADOR = exports.contestaEnSync = exports.NODOS_QUE_CONTESTAN_EN_SYNC = 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 = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_js_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_js_1.iterableMeta; } });
@@ -21,6 +21,16 @@ var ui_js_1 = require("./ui.js");
 Object.defineProperty(exports, "NODE_UI", { enumerable: true, get: function () { return ui_js_1.NODE_UI; } });
 Object.defineProperty(exports, "PREFIX_TO_TYPE", { enumerable: true, get: function () { return ui_js_1.PREFIX_TO_TYPE; } });
 Object.defineProperty(exports, "resolveNodeId", { enumerable: true, get: function () { return ui_js_1.resolveNodeId; } });
+var sentiment_js_1 = require("./sentiment.js");
+Object.defineProperty(exports, "SENTIMENT_LABELS", { enumerable: true, get: function () { return sentiment_js_1.SENTIMENT_LABELS; } });
+Object.defineProperty(exports, "SENTIMENT_UNCLEAR", { enumerable: true, get: function () { return sentiment_js_1.SENTIMENT_UNCLEAR; } });
+Object.defineProperty(exports, "SENTIMENT_PORTS", { enumerable: true, get: function () { return sentiment_js_1.SENTIMENT_PORTS; } });
+Object.defineProperty(exports, "SENTIMENT_PORT_LABEL", { enumerable: true, get: function () { return sentiment_js_1.SENTIMENT_PORT_LABEL; } });
+Object.defineProperty(exports, "SENTIMENT_PORT_SUMMARY", { enumerable: true, get: function () { return sentiment_js_1.SENTIMENT_PORT_SUMMARY; } });
+Object.defineProperty(exports, "esEtiquetaDeSentimiento", { enumerable: true, get: function () { return sentiment_js_1.esEtiquetaDeSentimiento; } });
+var types_js_2 = require("./types.js");
+Object.defineProperty(exports, "outputGroupsFor", { enumerable: true, get: function () { return types_js_2.outputGroupsFor; } });
+Object.defineProperty(exports, "todosLosOutputGroups", { enumerable: true, get: function () { return types_js_2.todosLosOutputGroups; } });
 // ── Dispatch config ──
 /* Ya no es «API only»: `downstreamPayload` lo lee tambien el panel, que sin el
    ensenaba como entrada de un nodo la salida del que pasa de largo. */

package/dist/sentiment.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Sentiment analysis en el AI Node — las etiquetas, los puertos y el orden.
+ *
+ * ## Por qué vive aquí y no en cada repo
+ *
+ * Las tres etiquetas son a la vez TRES cosas: el `enum` del esquema que se le
+ * da al modelo, el nombre de los puertos por los que el nodo despacha, y las
+ * pastillas de la tarjeta del lienzo. Si el api, hw-nodes y el dashboard
+ * escriben su propia lista, la primera que alguien reordene o rebautice deja
+ * una arista apuntando a un puerto que ya no existe — y eso no lo dice ningún
+ * compilador. Es el mismo motivo por el que las operaciones de cada nodo
+ * viven en este paquete.
+ *
+ * ## Por qué `unclear` no es una etiqueta más
+ *
+ * El modelo elige entre las TRES de `SENTIMENT_LABELS`; `unclear` no se le
+ * ofrece nunca. Es lo que hace el NODO cuando la confianza queda por debajo
+ * del umbral (`sentimentThreshold`) o cuando la respuesta no se puede leer.
+ * Ofrecérsela al modelo sería darle una salida cómoda para no mojarse, que es
+ * justo lo contrario de lo que se busca al poner un umbral.
+ *
+ * A diferencia del `other` del clasificador, `unclear` SÍ tiene puerto: el
+ * caso de uso es mandar a revisión humana lo que el modelo no ve claro, y sin
+ * puerto eso obligaba a adivinar por qué un item no salió por ninguna rama.
+ */
+/** Lo que el modelo puede contestar, en orden de peor a mejor. */
+export declare const SENTIMENT_LABELS: readonly ["negative", "neutral", "positive"];
+export type SentimentLabel = (typeof SENTIMENT_LABELS)[number];
+/** La salida del nodo cuando no hay etiqueta fiable. No se le ofrece al modelo. */
+export declare const SENTIMENT_UNCLEAR = "unclear";
+/** Los cuatro puertos del modo sentiment, en el orden en que se pintan. */
+export declare const SENTIMENT_PORTS: readonly ["negative", "neutral", "positive", "unclear"];
+export type SentimentPort = (typeof SENTIMENT_PORTS)[number];
+/** El nombre que ve la persona, por puerto. */
+export declare const SENTIMENT_PORT_LABEL: Record<SentimentPort, string>;
+/** Qué significa cada puerto, para el modal de conexión y la doc. */
+export declare const SENTIMENT_PORT_SUMMARY: Record<SentimentPort, string>;
+/** ¿Es una de las tres que el modelo puede contestar? */
+export declare function esEtiquetaDeSentimiento(v: unknown): v is SentimentLabel;

package/dist/sentiment.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Sentiment analysis en el AI Node — las etiquetas, los puertos y el orden.
+ *
+ * ## Por qué vive aquí y no en cada repo
+ *
+ * Las tres etiquetas son a la vez TRES cosas: el `enum` del esquema que se le
+ * da al modelo, el nombre de los puertos por los que el nodo despacha, y las
+ * pastillas de la tarjeta del lienzo. Si el api, hw-nodes y el dashboard
+ * escriben su propia lista, la primera que alguien reordene o rebautice deja
+ * una arista apuntando a un puerto que ya no existe — y eso no lo dice ningún
+ * compilador. Es el mismo motivo por el que las operaciones de cada nodo
+ * viven en este paquete.
+ *
+ * ## Por qué `unclear` no es una etiqueta más
+ *
+ * El modelo elige entre las TRES de `SENTIMENT_LABELS`; `unclear` no se le
+ * ofrece nunca. Es lo que hace el NODO cuando la confianza queda por debajo
+ * del umbral (`sentimentThreshold`) o cuando la respuesta no se puede leer.
+ * Ofrecérsela al modelo sería darle una salida cómoda para no mojarse, que es
+ * justo lo contrario de lo que se busca al poner un umbral.
+ *
+ * A diferencia del `other` del clasificador, `unclear` SÍ tiene puerto: el
+ * caso de uso es mandar a revisión humana lo que el modelo no ve claro, y sin
+ * puerto eso obligaba a adivinar por qué un item no salió por ninguna rama.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SENTIMENT_PORT_SUMMARY = exports.SENTIMENT_PORT_LABEL = exports.SENTIMENT_PORTS = exports.SENTIMENT_UNCLEAR = exports.SENTIMENT_LABELS = void 0;
+exports.esEtiquetaDeSentimiento = esEtiquetaDeSentimiento;
+/** Lo que el modelo puede contestar, en orden de peor a mejor. */
+exports.SENTIMENT_LABELS = ['negative', 'neutral', 'positive'];
+/** La salida del nodo cuando no hay etiqueta fiable. No se le ofrece al modelo. */
+exports.SENTIMENT_UNCLEAR = 'unclear';
+/** Los cuatro puertos del modo sentiment, en el orden en que se pintan. */
+exports.SENTIMENT_PORTS = [
+    ...exports.SENTIMENT_LABELS,
+    exports.SENTIMENT_UNCLEAR,
+];
+/** El nombre que ve la persona, por puerto. */
+exports.SENTIMENT_PORT_LABEL = {
+    negative: 'Negative',
+    neutral: 'Neutral',
+    positive: 'Positive',
+    unclear: 'Unclear',
+};
+/** Qué significa cada puerto, para el modal de conexión y la doc. */
+exports.SENTIMENT_PORT_SUMMARY = {
+    negative: 'Complaints, frustration, criticism',
+    neutral: 'Factual, mixed, or no clear feeling',
+    positive: 'Praise, satisfaction, enthusiasm',
+    unclear: 'Below the confidence floor, or unreadable',
+};
+/** ¿Es una de las tres que el modelo puede contestar? */
+function esEtiquetaDeSentimiento(v) {
+    return (typeof v === 'string' &&
+        exports.SENTIMENT_LABELS.includes(v));
+}

package/dist/types.d.ts

@@ -54,83 +54,15 @@ export interface NodeUIConfig {
         connectModal?: 'branch' | 'output-group';
         routerTargetLabel?: string;
         /**
-         * Generic named output groups — used by connectModal: 'output-group'.
-         * The modal reads entity[outputGroupsField] as an array of groups,
-         * each with a name (outputGroupNameField), a summary (outputGroupSummaryField),
-         * and its own outputNodes[].
-         * Works for Split (outputs[]), Conditional (branches[]), or any future branching node.
+         * Los juegos de salidas de un nodo que ramifica: UNO, o VARIOS con su
+         * `gate` cada uno [2026-09-22]. Con varios, quien pregunta se queda con
+         * el PRIMERO cuya puerta pasa — ver `outputGroupsFor`. El AI Node los
+         * necesita porque ramifica de dos maneras según el modo: por las
+         * categorías que escribe el usuario (`classifier`) o por los cuatro
+         * puertos fijos del análisis de sentimiento (`sentiment`). La forma
+         * vieja (un objeto suelto) sigue valiendo y significa «sin alternativas».
          */
-        outputGroups?: {
-            /** Entity field containing the array of groups (e.g. 'outputs', 'branches') */
-            field?: string;
-            /** Field within each group for display name (e.g. 'name') */
-            nameField?: string;
-            /** Field within each group for summary/description (e.g. 'field', 'filterMode') */
-            summaryField?: string;
-            /**
-             * Varios campos del grupo, unidos por espacios, cuando el resumen que
-             * de verdad identifica al grupo no cabe en uno solo.
-             *
-             * Existe por las reglas del router: su condición son TRES campos
-             * (`field`, `operator`, `value`) y el modal a medida que se retiró las
-             * pintaba juntas — «status eq active». Con un único `summaryField` una
-             * regla sin `label` quedaba en «rule 1» y «status», que no dice a qué
-             * se está conectando uno.
-             *
-             * Los campos vacíos se saltan, para que una regla con operador
-             * `exists` no salga con un espacio colgando al final.
-             */
-            summaryFields?: string[];
-            /** Label shown in the modal (e.g. 'output', 'branch') */
-            label: string;
-            /** Entity field for the fallback/else path (e.g. 'elseOutputNodes') */
-            elseField?: string;
-            /**
-             * Fixed output groups — for nodes with a static set of outputs (e.g. approval: approve/reject).
-             * Each entry maps to a top-level entity field that holds outputNodes[].
-             * When set, `field`/`nameField` are ignored — modal shows these fixed options.
-             */
-            fixedGroups?: Array<{
-                name: string;
-                field: string;
-            }>;
-            /**
-             * Optional content-aware gate — the output-group modal only opens
-             * when `entity[gate.field] === gate.value`. Lets a node opt into
-             * multi-branch routing only in some modes (e.g. AI Node in
-             * classifier mode) without trapping every connection in the
-             * picker the rest of the time. When the gate fails, the
-             * FlowCanvas falls through to the universal
-             * `entity.outputNodes` connect path.
-             */
-            gate?: {
-                field: string;
-                value: unknown;
-            };
-            /**
-             * Qué es el puerto `main` de este nodo MIENTRAS su contenedor está
-             * vacío. Sin esto, conectar a un nodo que ramifica y todavía no tiene
-             * ninguna salida escribía una arista en `main` **en silencio**, y el
-             * usuario no tenía forma de saber qué había pasado con ella.
-             *
-             * No hay una respuesta única, y por eso es un dato y no una regla.
-             * Medido en `api/src/common/pipeline-run.service.ts`:
-             *
-             *   'passthrough'       — router sin reglas: `rules.length === 0
-             *                         ? refsForPort(entity, MAIN_PORT) : []`. La
-             *                         arista SÍ dispara... hasta que se cree la
-             *                         primera regla, y entonces deja de hacerlo
-             *                         sin avisar.
-             *   'never-dispatched'  — split: no tiene salida `main`, y el propio
-             *                         despachador registra un warning por cada
-             *                         arista que se quedó en ese puerto.
-             *
-             * Se declara sólo donde se ha medido. Sin declarar, el lienzo se
-             * comporta como siempre: conecta por el camino universal y no dice
-             * nada, que es lo que hacía antes de existir este campo.
-             */
-            emptyContainerMain?: 'passthrough' | 'never-dispatched';
-        };
+        outputGroups?: OutputGroupsConfig | OutputGroupsConfig[];
         /**
          * Maps output fields to alternate payload fields on the source entity.
          * When a downstream node is connected via a specific output field,
@@ -224,3 +156,106 @@ export interface PrefixMapping {
     /** Canvas node type used in React Flow nodeTypes map (e.g. "cache-node", "email-action") */
     canvasType: string;
 }
+/**
+ * Un juego de salidas de un nodo que ramifica.
+ *
+ * Vivía dentro de `NodeUIConfig.special` como un objeto anónimo; sale aquí
+ * [2026-09-22] para poder declarar varios por nodo y para que quien los lea
+ * nombre el tipo en vez de repetir su forma.
+ */
+export interface OutputGroupsConfig {
+    /** Entity field containing the array of groups (e.g. 'outputs', 'branches') */
+    field?: string;
+    /** Field within each group for display name (e.g. 'name') */
+    nameField?: string;
+    /** Field within each group for summary/description (e.g. 'field', 'filterMode') */
+    summaryField?: string;
+    /**
+     * Varios campos del grupo, unidos por espacios, cuando el resumen que
+     * de verdad identifica al grupo no cabe en uno solo.
+     *
+     * Existe por las reglas del router: su condición son TRES campos
+     * (`field`, `operator`, `value`) y el modal a medida que se retiró las
+     * pintaba juntas — «status eq active». Con un único `summaryField` una
+     * regla sin `label` quedaba en «rule 1» y «status», que no dice a qué
+     * se está conectando uno.
+     *
+     * Los campos vacíos se saltan, para que una regla con operador
+     * `exists` no salga con un espacio colgando al final.
+     */
+    summaryFields?: string[];
+    /** Label shown in the modal (e.g. 'output', 'branch') */
+    label: string;
+    /** Entity field for the fallback/else path (e.g. 'elseOutputNodes') */
+    elseField?: string;
+    /**
+     * Fixed output groups — for nodes with a static set of outputs (e.g. approval: approve/reject).
+     * When set, `field`/`nameField` are ignored — modal shows these fixed options.
+     *
+     * Cada entrada nombra su puerto de una de dos formas, y sólo una:
+     *   · `field` — un campo de primer nivel de los de ANTES de que los puertos
+     *     existieran (`rejectionOutputNodes` → puerto `rejected`); se traduce
+     *     con el mapa de campos heredados.
+     *   · `port`  — el puerto, tal cual. Es lo que usan las salidas nacidas ya
+     *     con puertos (las cuatro de sentiment): inventarles un campo heredado
+     *     que nunca existió sería mentir en el registro.
+     */
+    fixedGroups?: Array<{
+        name: string;
+        field?: string;
+        port?: string;
+        /** Una línea de qué entrega ese puerto, para el modal de conexión. */
+        summary?: string;
+    }>;
+    /**
+     * Optional content-aware gate — the output-group modal only opens
+     * when `entity[gate.field] === gate.value`. Lets a node opt into
+     * multi-branch routing only in some modes (e.g. AI Node in
+     * classifier mode) without trapping every connection in the
+     * picker the rest of the time. When the gate fails, the
+     * FlowCanvas falls through to the universal
+     * `entity.outputNodes` connect path.
+     */
+    gate?: {
+        field: string;
+        value: unknown;
+    };
+    /**
+     * Qué es el puerto `main` de este nodo MIENTRAS su contenedor está
+     * vacío. Sin esto, conectar a un nodo que ramifica y todavía no tiene
+     * ninguna salida escribía una arista en `main` **en silencio**, y el
+     * usuario no tenía forma de saber qué había pasado con ella.
+     *
+     * No hay una respuesta única, y por eso es un dato y no una regla.
+     * Medido en `api/src/common/pipeline-run.service.ts`:
+     *
+     *   'passthrough'       — router sin reglas: `rules.length === 0
+     *                         ? refsForPort(entity, MAIN_PORT) : []`. La
+     *                         arista SÍ dispara... hasta que se cree la
+     *                         primera regla, y entonces deja de hacerlo
+     *                         sin avisar.
+     *   'never-dispatched'  — split: no tiene salida `main`, y el propio
+     *                         despachador registra un warning por cada
+     *                         arista que se quedó en ese puerto.
+     *
+     * Se declara sólo donde se ha medido. Sin declarar, el lienzo se
+     * comporta como siempre: conecta por el camino universal y no dice
+     * nada, que es lo que hacía antes de existir este campo.
+     */
+    emptyContainerMain?: 'passthrough' | 'never-dispatched';
+}
+/**
+ * El juego de salidas que aplica AHORA a esta entidad, o `undefined` si el
+ * nodo no ramifica en este momento.
+ *
+ * Es la única lectura de `special.outputGroups` que entiende las dos formas
+ * (uno o varios) y las dos puertas (con `gate` o sin ella). Todo el que
+ * pregunte tiene que pasar por aquí: el lienzo, el modal de conexión y el
+ * despachador. Escribirlo cada uno a su manera es como el router acabó con un
+ * camino propio que nadie arregló al arreglar el de los demás.
+ */
+export declare function outputGroupsFor(config: NodeUIConfig | undefined | null, entity: Record<string, unknown> | undefined | null): OutputGroupsConfig | undefined;
+/** Todos los juegos declarados, pasen o no su puerta. Para quien necesita el
+ *  UNIVERSO de puertos que un tipo puede emitir (la auditoría de puertos),
+ *  no el de ahora mismo. */
+export declare function todosLosOutputGroups(config: NodeUIConfig | undefined | null): OutputGroupsConfig[];

package/dist/types.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.singleMeta = singleMeta;
 exports.iterableMeta = iterableMeta;
+exports.outputGroupsFor = outputGroupsFor;
+exports.todosLosOutputGroups = todosLosOutputGroups;
 /** Helper to create _meta for single-object outputs */
 function singleMeta() {
     return { iterable: false, count: 1 };
@@ -10,3 +12,29 @@ function singleMeta() {
 function iterableMeta(field, count) {
     return { iterable: true, iterateField: field, count };
 }
+/**
+ * El juego de salidas que aplica AHORA a esta entidad, o `undefined` si el
+ * nodo no ramifica en este momento.
+ *
+ * Es la única lectura de `special.outputGroups` que entiende las dos formas
+ * (uno o varios) y las dos puertas (con `gate` o sin ella). Todo el que
+ * pregunte tiene que pasar por aquí: el lienzo, el modal de conexión y el
+ * despachador. Escribirlo cada uno a su manera es como el router acabó con un
+ * camino propio que nadie arregló al arreglar el de los demás.
+ */
+function outputGroupsFor(config, entity) {
+    const declarado = config?.special?.outputGroups;
+    if (!declarado)
+        return undefined;
+    const lista = Array.isArray(declarado) ? declarado : [declarado];
+    return lista.find((c) => !c.gate || entity?.[c.gate.field] === c.gate.value);
+}
+/** Todos los juegos declarados, pasen o no su puerta. Para quien necesita el
+ *  UNIVERSO de puertos que un tipo puede emitir (la auditoría de puertos),
+ *  no el de ahora mismo. */
+function todosLosOutputGroups(config) {
+    const declarado = config?.special?.outputGroups;
+    if (!declarado)
+        return [];
+    return Array.isArray(declarado) ? declarado : [declarado];
+}

package/dist/ui.js

@@ -6,6 +6,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PREFIX_TO_TYPE = exports.NODE_UI = void 0;
 exports.resolveNodeId = resolveNodeId;
+const sentiment_js_1 = require("./sentiment.js");
 exports.NODE_UI = {
     // ── Source nodes ──
     // Una fuente arranca el flujo: `fromNodes: false` significa que nada puede
@@ -49,7 +50,15 @@ exports.NODE_UI = {
     // no handle and no route. In any other outputMode the node falls back to
     // the single right-out handle NodeShell renders when no dynamic outputs
     // materialize.
-    ai: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { loopBackAllowed: true, connectModal: 'output-group', outputGroups: { field: 'categories', nameField: 'name', summaryField: 'description', label: 'category', gate: { field: 'outputMode', value: 'classifier' } } } },
+    // En modo `sentiment` (2026-09-22) el abanico son CUATRO puertos fijos
+    // —negative / neutral / positive / unclear— y no un contenedor del usuario:
+    // el modelo elige entre las tres primeras y el nodo manda a `unclear` lo que
+    // no llega al umbral de confianza. Por eso el AI Node declara DOS juegos de
+    // salidas, uno por modo; `outputGroupsFor` elige el que toca.
+    ai: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { loopBackAllowed: true, connectModal: 'output-group', outputGroups: [
+                { field: 'categories', nameField: 'name', summaryField: 'description', label: 'category', gate: { field: 'outputMode', value: 'classifier' } },
+                { label: 'sentiment', gate: { field: 'outputMode', value: 'sentiment' }, fixedGroups: sentiment_js_1.SENTIMENT_PORTS.map((p) => ({ name: sentiment_js_1.SENTIMENT_PORT_LABEL[p], port: p, summary: sentiment_js_1.SENTIMENT_PORT_SUMMARY[p] })) },
+            ] } },
     markdown: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },
     fileTransform: { fromNodes: true, toNodes: true },
     limit: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-types",
-  "version": "1.84.0",
+  "version": "1.86.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",