@hostwebhook/node-types 1.87.0 → 1.89.0

package/dist/esm/google-contacts-toolkit.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Google Contacts AI Toolkit — las herramientas que un googleContactsAction
+ * expone cuando `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez** (2026-09-24). Vivía dos veces: en
+ * `api/src/mcp-servers/toolkit-specs.ts` y en
+ * `dashboard/components/google-contacts-actions/google-contacts-operations-schemas.ts`,
+ * las dos a mano. Al mudarlas coincidían exactamente —las 15 operaciones, sus
+ * nombres, textos y parámetros—; el `group` del dashboard ya lo lleva el spec
+ * de formulario (`GOOGLE_CONTACTS_OPERATION_SPECS[op].group`).
+ *
+ * Se llama `GOOGLE_CONTACTS_TOOLKIT_SPECS` y no `…_OPERATION_SPECS` porque ese
+ * nombre ya es el del FORMULARIO del nodo en este paquete — la misma pareja que
+ * Discord y Slack.
+ *
+ * ⚠️ El `destructive` ya no se escribe a mano: lo pone `marcarDestructivas` por
+ * el verbo. Cuatro que la copia vieja marcaba dejan de serlo —crear o añadir no
+ * pisa nada—: `create_contact`, `add_contact_to_group`,
+ * `batch_create_contacts` y `create_contact_group`. El gate del AI Node ya las
+ * leía así (por el verbo del nombre); lo que cambia es la etiqueta del panel.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+import type { GoogleContactsOperation } from './google-contacts-operations.js';
+export interface GoogleContactsToolkitParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface GoogleContactsToolkitSpec {
+    operation: GoogleContactsOperation;
+    /** Etiqueta corta de la fila en la lista de herramientas. */
+    label: string;
+    /** Nombre con el que el LLM llama a la herramienta. */
+    toolName: string;
+    /** Descripción (más reglas de uso) que ve el LLM. */
+    description: string;
+    parameters: GoogleContactsToolkitParameter[];
+    /** Pisa o borra. Lo pone `marcarDestructivas` leyendo el verbo del
+     *  nombre (ver `clase-de-herramienta.ts`), no se escribe a mano. */
+    destructive?: boolean;
+}
+export declare const GOOGLE_CONTACTS_TOOLKIT_SPECS: GoogleContactsToolkitSpec[];
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+export declare const GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME: Record<string, GoogleContactsToolkitSpec>;

package/dist/esm/google-contacts-toolkit.js

@@ -0,0 +1,180 @@
+/**
+ * Google Contacts AI Toolkit — las herramientas que un googleContactsAction
+ * expone cuando `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez** (2026-09-24). Vivía dos veces: en
+ * `api/src/mcp-servers/toolkit-specs.ts` y en
+ * `dashboard/components/google-contacts-actions/google-contacts-operations-schemas.ts`,
+ * las dos a mano. Al mudarlas coincidían exactamente —las 15 operaciones, sus
+ * nombres, textos y parámetros—; el `group` del dashboard ya lo lleva el spec
+ * de formulario (`GOOGLE_CONTACTS_OPERATION_SPECS[op].group`).
+ *
+ * Se llama `GOOGLE_CONTACTS_TOOLKIT_SPECS` y no `…_OPERATION_SPECS` porque ese
+ * nombre ya es el del FORMULARIO del nodo en este paquete — la misma pareja que
+ * Discord y Slack.
+ *
+ * ⚠️ El `destructive` ya no se escribe a mano: lo pone `marcarDestructivas` por
+ * el verbo. Cuatro que la copia vieja marcaba dejan de serlo —crear o añadir no
+ * pisa nada—: `create_contact`, `add_contact_to_group`,
+ * `batch_create_contacts` y `create_contact_group`. El gate del AI Node ya las
+ * leía así (por el verbo del nombre); lo que cambia es la etiqueta del panel.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+import { marcarDestructivas } from './clase-de-herramienta.js';
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+export const GOOGLE_CONTACTS_TOOLKIT_SPECS = marcarDestructivas([
+    // ── Read ─────────────────────────────────────────────────────────
+    {
+        operation: 'searchContacts',
+        label: 'Search contacts',
+        toolName: 'search_contacts',
+        description: "Free-text search across the user's contacts. Matches names, emails, phones, and organization. Use this BEFORE updateContact / deleteContact / addContactToGroup when the user references a contact by name or email — never invent a resourceName.",
+        parameters: [
+            p('query', 'Free-text query (name fragment, email, phone, organization).'),
+            p('pageSize', 'Max results (default 30, hard cap 30).', false, 'number'),
+        ],
+    },
+    {
+        operation: 'listContacts',
+        label: 'List contacts',
+        toolName: 'list_contacts',
+        description: 'Paginated list of every contact. Prefer searchContacts for name/email lookup — listContacts returns hundreds of rows even when the user named one.',
+        parameters: [
+            p('pageSize', 'Page size (default 100, max 1000).', false, 'number'),
+            p('pageToken', 'Token returned by previous listContacts. Empty for first page.', false),
+        ],
+    },
+    {
+        operation: 'getContact',
+        label: 'Get contact',
+        toolName: 'get_contact',
+        description: 'Fetch a single contact by resourceName. Use AFTER searchContacts to read the full record before updating.',
+        parameters: [
+            p('resourceName', 'People API id, e.g. "people/c12345". Get from searchContacts results.'),
+        ],
+    },
+    // ── Write ────────────────────────────────────────────────────────
+    {
+        operation: 'createContact',
+        label: 'Create contact',
+        toolName: 'create_contact',
+        description: "Add a new contact to the user's address book. NEVER call this without confirming with the user first — duplicate contacts are messy to clean up. Pass `fullName` and the helper auto-splits given/family. Pass `emailAddresses` and `phoneNumbers` as arrays of strings.",
+        parameters: [
+            p('fullName', 'Full name (e.g. "Ariel Pérez"). Auto-splits to given + family.', false),
+            p('givenName', 'First name. Overrides the fullName split.', false),
+            p('familyName', 'Last name. Overrides the fullName split.', false),
+            p('emailAddresses', 'Array of email addresses. JSON-encode if your tool layer expects a string.', false),
+            p('phoneNumbers', 'Array of phone numbers.', false),
+            p('notes', 'Free-form note attached to the contact.', false),
+        ],
+    },
+    {
+        operation: 'updateContact',
+        label: 'Update contact',
+        toolName: 'update_contact',
+        description: "Change fields on an existing contact. Get the resourceName from searchContacts first. Update mask is auto-derived from the fields you pass — only include fields you want changed (passing `notes` won't blank out the email).",
+        parameters: [
+            p('resourceName', 'People API id, e.g. "people/c12345".'),
+            p('fullName', 'New full name (auto-splits).', false),
+            p('emailAddresses', 'Replace email list. Pass [] to clear.', false),
+            p('phoneNumbers', 'Replace phone list.', false),
+            p('notes', "Replace the contact's note.", false),
+        ],
+    },
+    {
+        operation: 'deleteContact',
+        label: 'Delete contact',
+        toolName: 'delete_contact',
+        description: 'Permanently remove a contact. Irreversible. ALWAYS confirm with the user before calling. Use searchContacts first to verify you have the right resourceName.',
+        parameters: [p('resourceName', 'People API id of the contact to delete.')],
+    },
+    // ── Groups ───────────────────────────────────────────────────────
+    {
+        operation: 'listContactGroups',
+        label: 'List groups',
+        toolName: 'list_contact_groups',
+        description: "List the user's contact groups (labels). Call this BEFORE addContactToGroup / removeContactFromGroup so you have the right groupResourceName.",
+        parameters: [
+            p('pageSize', 'Page size (default 200, max 1000).', false, 'number'),
+        ],
+    },
+    {
+        operation: 'addContactToGroup',
+        label: 'Add to group',
+        toolName: 'add_contact_to_group',
+        description: 'Add a contact to a group (label). Idempotent — no error if the contact is already in the group. Get the groupResourceName from listContactGroups.',
+        parameters: [
+            p('resourceName', 'Contact id, e.g. "people/c12345". Or array of contact ids.'),
+            p('groupResourceName', 'Group id, e.g. "contactGroups/12345".'),
+        ],
+    },
+    {
+        operation: 'removeContactFromGroup',
+        label: 'Remove from group',
+        toolName: 'remove_contact_from_group',
+        description: 'Remove a contact from a group. Idempotent. Does NOT delete the contact, only its membership in that group.',
+        parameters: [
+            p('resourceName', 'Contact id, e.g. "people/c12345".'),
+            p('groupResourceName', 'Group id, e.g. "contactGroups/12345".'),
+        ],
+    },
+    // ── V2 — bulk + group management ─────────────────────────────────
+    {
+        operation: 'batchCreateContacts',
+        label: 'Batch create contacts',
+        toolName: 'batch_create_contacts',
+        description: 'Bulk-create up to 200 contacts in one call. Each contact in the array uses the same shape as createContact (fullName / emailAddresses / phoneNumbers / notes / etc.).',
+        parameters: [
+            p('contacts', 'Array of contact objects. Same shape as createContact.', true),
+        ],
+    },
+    {
+        operation: 'batchUpdateContacts',
+        label: 'Batch update contacts',
+        toolName: 'batch_update_contacts',
+        description: 'Bulk-update up to 200 existing contacts. Each entry must include `resourceName`. Pass `updateMask` (e.g. "names,emailAddresses") to control which fields the API replaces.',
+        parameters: [
+            p('contacts', 'Array of {resourceName, ...fields} objects.', true),
+            p('updateMask', 'Comma-separated People API field paths to replace.'),
+        ],
+    },
+    {
+        operation: 'batchDeleteContacts',
+        label: 'Batch delete contacts',
+        toolName: 'batch_delete_contacts',
+        description: 'Bulk-delete up to 500 contacts by resourceName. Irreversible.',
+        parameters: [
+            p('resourceNames', 'Array of People API ids, each like "people/c12345".'),
+        ],
+    },
+    {
+        operation: 'createContactGroup',
+        label: 'Create group',
+        toolName: 'create_contact_group',
+        description: 'Create a new contact group (label).',
+        parameters: [p('name', 'Group name as displayed in Contacts.')],
+    },
+    {
+        operation: 'updateContactGroup',
+        label: 'Rename group',
+        toolName: 'update_contact_group',
+        description: 'Rename an existing contact group.',
+        parameters: [
+            p('resourceName', 'Group id, e.g. "contactGroups/12345".'),
+            p('name', 'New name for the group.'),
+        ],
+    },
+    {
+        operation: 'deleteContactGroup',
+        label: 'Delete group',
+        toolName: 'delete_contact_group',
+        description: 'Delete a contact group. Pass `deleteContacts: true` to also delete the contacts in the group (otherwise contacts stay, just lose this membership). Irreversible — confirm with the user before calling.',
+        parameters: [
+            p('resourceName', 'Group id, e.g. "contactGroups/12345".'),
+            p('deleteContacts', 'When true, also delete contacts in the group. Default false.', false, 'boolean'),
+        ],
+    },
+]);
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+export const GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(GOOGLE_CONTACTS_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/esm/index.d.ts

@@ -76,8 +76,12 @@ export { POSTGRES_TOOLKIT_SPECS, POSTGRES_TOOLKIT_BY_TOOL_NAME, } from './postgr
 export type { PostgresToolkitSpec, PostgresToolkitParameter, } from './postgres-toolkit.js';
 export { claseDeHerramienta, esHerramientaDestructiva, marcarDestructivas, } from './clase-de-herramienta.js';
 export type { ClaseDeHerramienta } from './clase-de-herramienta.js';
-export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, } from './toolkits.js';
+export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, TIPOS_CON_TOOLKIT, tieneModoToolkit, admiteBloqueo, nombresDeHerramientas, bloqueadasDe, herramientaBloqueadaEn, MENSAJE_SIN_HERRAMIENTA, mensajeDeHerramientaBloqueada, motivoParaNoCorrer, } from './toolkits.js';
+export { GOOGLE_CONTACTS_TOOLKIT_SPECS, GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME, } from './google-contacts-toolkit.js';
+export type { GoogleContactsToolkitSpec, GoogleContactsToolkitParameter, } from './google-contacts-toolkit.js';
 export type { OperacionDeToolkit } from './toolkits.js';
+export { leerSslPostgres, ponerSslPostgres, pistaDeSslPostgres, conPistaDeSslPostgres, CASOS_DE_SSL_POSTGRES, } from './postgres-ssl.js';
+export type { ModoSslPostgres, SslDeLaCadenaPostgres } from './postgres-ssl.js';
 export type { LlmProvider, LlmProviderOption, LlmModelOption, } from './llm-models.js';
 export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models.js';
 export type { ModeloDeOpenRouter, PrecioDeOpenRouter, RespuestaDeModelosDeOpenRouter, } from './openrouter.js';

package/dist/esm/index.js

@@ -57,7 +57,16 @@ export { DOCS_TOOLKIT_SPECS, DOCS_TOOLKIT_BY_TOOL_NAME, DOCS_TOOLKIT_DEFAULTABLE
 export { MONGO_TOOLKIT_SPECS, MONGO_TOOLKIT_BY_TOOL_NAME, } from './mongo-toolkit.js';
 export { POSTGRES_TOOLKIT_SPECS, POSTGRES_TOOLKIT_BY_TOOL_NAME, } from './postgres-toolkit.js';
 export { claseDeHerramienta, esHerramientaDestructiva, marcarDestructivas, } from './clase-de-herramienta.js';
-export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, } from './toolkits.js';
+export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, TIPOS_CON_TOOLKIT, tieneModoToolkit, admiteBloqueo, nombresDeHerramientas, bloqueadasDe, herramientaBloqueadaEn, MENSAJE_SIN_HERRAMIENTA, mensajeDeHerramientaBloqueada, motivoParaNoCorrer, } from './toolkits.js';
+/* Contacts se escribía a mano en la api y en el dashboard; ahora una vez. Se
+   llama `…_TOOLKIT_SPECS` porque `GOOGLE_CONTACTS_OPERATION_SPECS` ya es el
+   formulario del nodo — la misma pareja que Discord y Slack. */
+export { GOOGLE_CONTACTS_TOOLKIT_SPECS, GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME, } from './google-contacts-toolkit.js';
+// ── El SSL de una cadena de Postgres (dashboard, api y hw-nodes) ──
+/* Lo que hará `pg` con el SSL de una cadena, escrito una vez: el panel lo usa
+   para fijar el modo cuando la cadena lo dice, y los servicios para decir qué
+   cambiar cuando falla. El api lo compara con el driver de verdad. */
+export { leerSslPostgres, ponerSslPostgres, pistaDeSslPostgres, conPistaDeSslPostgres, CASOS_DE_SSL_POSTGRES, } from './postgres-ssl.js';
 export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models.js';
 export { URL_DE_MODELOS_DE_OPENROUTER, opcionesDeModelosDeOpenRouter, ventanaDeContextoDeOpenRouter, } from './openrouter.js';
 export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials.js';

package/dist/esm/postgres-ssl.d.ts

@@ -0,0 +1,125 @@
+/**
+ * El SSL de una cadena de conexión de Postgres: qué hará el driver con ella,
+ * y cómo escribir el modo que se elija.
+ *
+ * ## Por qué vive aquí (2026-09-24)
+ *
+ * Ariel conectó un Postgres de Railway eligiendo «Require» y el panel del nodo
+ * dijo `self-signed certificate in certificate chain`. Medido: el servidor
+ * enseña un certificado `CN=localhost` firmado por su propio `root-ca`, y
+ * «Require» escribía `sslmode=require`, que para `pg` 8 es VERIFICAR el
+ * certificado. Y pidió que, si la cadena ya trae el SSL, el panel lo lea y lo
+ * deje fijo; y si no lo trae, que se elija a mano.
+ *
+ * Para fijarlo, el panel tiene que saber lo que hará EL DRIVER, no lo que
+ * parece que dice la cadena — y el driver tiene reglas que no se adivinan:
+ * `sslmode=prefer` también verifica, `ssl=false` ENCIENDE el SSL (queda como
+ * el texto `"false"`, que es verdadero), y `uselibpqcompat=true` le da la
+ * vuelta a `require`. El panel sólo conocía `require` y `no-verify`; lo demás
+ * lo pintaba como «Off».
+ *
+ * Una sola función para el dashboard y para los servicios, y el api la compara
+ * caso a caso con el `pg` que de verdad corre (`el-ssl-de-postgres-es-el-del-
+ * driver.spec.ts`): si una actualización de `pg` cambia sus reglas, ese spec
+ * se pone rojo antes de que el panel enseñe una cosa y el driver haga otra.
+ *
+ * ## Las reglas, copiadas de `pg-connection-string` 2.12 y `pg` 8.20
+ *
+ *   1. Los parámetros salen de `new URL(cadena, 'postgres://base')` (con el
+ *      mismo arreglo de espacios y el mismo host de relleno para `@/`); si una
+ *      clave se repite, gana la ÚLTIMA. Las claves distinguen mayúsculas:
+ *      `SSLMODE` no existe para el driver.
+ *   2. `ssl=true`/`ssl=1` → sí; `ssl=0` → no; cualquier otro texto se queda
+ *      como texto (`ssl=false` → `"false"` → ENCENDIDO).
+ *   3. Si hay `sslmode` (no vacío) o un fichero (`sslcert`, `sslkey`,
+ *      `sslrootcert`), el SSL pasa a ser un objeto y `ssl=` deja de contar.
+ *   4. `sslmode`: `disable` → no; `no-verify` → cifrar sin comprobar; todo lo
+ *      demás (`prefer`, `require`, `verify-ca`, `verify-full`, y cualquier
+ *      valor raro) → cifrar Y comprobar el certificado.
+ *   5. Con `uselibpqcompat=true`, las de libpq: `prefer` y `require` → sin
+ *      comprobar; `verify-full` → comprobando; `verify-ca` sin `sslrootcert`
+ *      → el driver se NIEGA; `no-verify` no existe en libpq → comprobando.
+ *   6. Sin nada de eso, `pg` mira `PGSSLMODE` del entorno; en los servicios no
+ *      está puesta (medido el 2026-09-24), así que es SIN SSL.
+ *
+ * ## Los ficheros (`sslcert`, `sslkey`, `sslrootcert`)
+ *
+ * El driver los LEE DEL DISCO de quien conecta — nuestro servidor, no la
+ * máquina de quien pegó la cadena. Nunca pueden valer: aquí salen como
+ * `problema` y el panel no deja guardarlos.
+ */
+/** Los tres modos del selector. `require` es «cifrar y comprobar el
+ *  certificado» — lo que `pg` 8 hace con `sslmode=require`. */
+export type ModoSslPostgres = 'off' | 'require' | 'no-verify';
+export type SslDeLaCadenaPostgres = 
+/** La cadena no dice nada de SSL: se elige a mano. */
+{
+    dice: false;
+}
+/** La cadena lo decide. `por` es el parámetro que manda (`sslmode=require`). */
+ | {
+    dice: true;
+    modo: ModoSslPostgres;
+    por: string;
+}
+/** La cadena dice algo que no puede funcionar desde nuestros servidores. */
+ | {
+    dice: true;
+    modo: null;
+    por: string;
+    problema: string;
+};
+/**
+ * Qué hará el driver con el SSL de esta cadena.
+ *
+ * `{ dice: false }` cuando la cadena no dice nada: ni `ssl`, ni `sslmode`, ni
+ * ficheros (un `sslmode=` o `ssl=` vacío tampoco dicen nada: el driver los
+ * ignora).
+ */
+export declare function leerSslPostgres(cadena: string): SslDeLaCadenaPostgres;
+/**
+ * Escribe el modo elegido en la cadena, quitando antes `ssl` y `sslmode` (en
+ * una cadena que «no dice nada», los que hubiera están vacíos). No toca el
+ * resto de parámetros, ni los recodifica.
+ *
+ * Lo que escribe, y por qué:
+ *   - `off`       → `sslmode=disable`, explícito: la cadena guardada dice lo
+ *                   que hace sin depender de `PGSSLMODE`.
+ *   - `require`   → `sslmode=verify-full`, no `require`: para `pg` 8 es lo
+ *                   mismo, pero `require` avisa en cada conexión de que en la
+ *                   versión 9 pasará a NO comprobar. `verify-full` significa
+ *                   lo mismo en las dos.
+ *   - `no-verify` → `sslmode=no-verify`; con `uselibpqcompat=true`, que no lo
+ *                   conoce, `sslmode=require` (lo mismo en libpq).
+ *
+ * Una cadena vacía se devuelve tal cual.
+ */
+export declare function ponerSslPostgres(cadena: string, modo: ModoSslPostgres): string;
+/**
+ * La frase que le falta a un error de conexión de SSL: qué cambiar. `null` si
+ * el error no es de SSL.
+ *
+ * Los tres casos que se ven al conectar:
+ *   - el certificado no se puede comprobar (autofirmado, CA privada, nombre
+ *     que no casa): Railway (`CN=localhost` de su `root-ca`) y Supabase (su
+ *     `Supabase Root 2021 CA`) —medidos los dos el 2026-09-24—, Heroku y
+ *     RDS. Neon sí se comprueba (Let's Encrypt);
+ *   - el servidor no acepta SSL;
+ *   - el servidor exige SSL y se conectó sin él.
+ */
+export declare function pistaDeSslPostgres(mensaje: string): string | null;
+/** El mensaje con su pista, si la tiene. Lo que devuelven los servicios. Si el
+ *  error ya pasó por aquí (dos capas que lo envuelven), no la repite. */
+export declare function conPistaDeSslPostgres(mensaje: string): string;
+/**
+ * Los casos con los que se comprueba la regla — aquí y contra el driver de
+ * verdad en el api (`el-ssl-de-postgres-es-el-del-driver.spec.ts`). Uno nuevo
+ * se añade AQUÍ y lo miran los dos.
+ *
+ * `esperado`: el modo, `'nada'` si la cadena no dice nada, `'problema'` si no
+ * puede funcionar.
+ */
+export declare const CASOS_DE_SSL_POSTGRES: ReadonlyArray<{
+    cadena: string;
+    esperado: ModoSslPostgres | 'nada' | 'problema';
+}>;