@hostwebhook/node-types 1.52.13 → 1.52.15

package/dist/calendar-operations.d.ts

@@ -16,3 +16,52 @@ export declare const GOOGLE_CALENDAR_OPERATIONS: readonly ["createEvent", "updat
 export type GoogleCalendarOperation = (typeof GOOGLE_CALENDAR_OPERATIONS)[number];
 /** Type guard — useful when validating untrusted input (DTOs, tool calls). */
 export declare function isGoogleCalendarOperation(value: unknown): value is GoogleCalendarOperation;
+export type GoogleCalendarParamTarget = 'eventConfig' | 'listConfig' | 'root';
+export type GoogleCalendarParamType = 
+/** Campo de texto con autocompletado de `{{payload.*}}`. */
+'template' | 'number' | 'select'
+/** El `TimezonePicker` que ya existe en el dashboard. */
+ | 'timezone';
+export interface GoogleCalendarParamSpec {
+    /** La clave DENTRO de `target`. Es la del cable, no un nombre de UI. */
+    name: string;
+    /** Dónde vive en la entidad. */
+    target: GoogleCalendarParamTarget;
+    label: string;
+    type: GoogleCalendarParamType;
+    required?: boolean;
+    /** Texto de ayuda. Llano: el paquete no lleva React. */
+    description?: string;
+    placeholder?: string;
+    default?: string | number;
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+    min?: number;
+    max?: number;
+    /**
+     * Cómo se llama esta misma cosa en el `config` que espera el ejecutor
+     * compartido (`google-calendar-operations.service.ts`). El ejecutor está
+     * escrito para la ruta del toolkit, donde el LLM manda los nombres **sin**
+     * sufijo, así que `summaryTemplate` viaja como `summary`. Sólo lo llevan los
+     * params de las operaciones que van por ese despachador.
+     */
+    execKey?: string;
+}
+export interface GoogleCalendarOperationSpec {
+    /** Etiqueta del desplegable, y la misma que pinta el lienzo y el panel. */
+    label: string;
+    /** Sub-línea del desplegable. */
+    description: string;
+    /** Método de la API de Google al que corresponde. */
+    apiMethod: string;
+    /**
+     * Si se ejecuta por el despachador genérico (`calendarOps.run`) en vez de por
+     * un `case` escrito a mano. Son las cuatro que se abrieron el 2026-08-11.
+     */
+    viaExecutor?: boolean;
+    /** Orden de pantalla. */
+    params: GoogleCalendarParamSpec[];
+}
+export declare const GOOGLE_CALENDAR_OPERATION_SPECS: Record<GoogleCalendarOperation, GoogleCalendarOperationSpec>;

package/dist/calendar-operations.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GOOGLE_CALENDAR_OPERATIONS = void 0;
+exports.GOOGLE_CALENDAR_OPERATION_SPECS = exports.GOOGLE_CALENDAR_OPERATIONS = void 0;
 exports.isGoogleCalendarOperation = isGoogleCalendarOperation;
 /**
  * Google Calendar operation enum — single source of truth across the API,
@@ -41,3 +41,140 @@ function isGoogleCalendarOperation(value) {
     return (typeof value === 'string' &&
         exports.GOOGLE_CALENDAR_OPERATIONS.includes(value));
 }
+/* Fábricas de los campos que se repiten entre operaciones. */
+const eventIdParam = (label, description) => ({
+    name: 'eventIdTemplate',
+    target: 'root',
+    label,
+    type: 'template',
+    required: true,
+    placeholder: '{{payload.eventId}}',
+    description,
+    execKey: 'eventId',
+});
+/** Los siete de `eventConfig`, que comparten `createEvent`, `updateEvent` y
+    `proposeEvent`. */
+const eventConfigParams = () => [
+    { name: 'summaryTemplate', target: 'eventConfig', label: 'Summary', type: 'template', placeholder: '{{payload.title}}', execKey: 'summary' },
+    { name: 'descriptionTemplate', target: 'eventConfig', label: 'Description', type: 'template', placeholder: 'Event description... (supports {{templates}})', execKey: 'description' },
+    { name: 'locationTemplate', target: 'eventConfig', label: 'Location', type: 'template', placeholder: '{{payload.location}}', execKey: 'location' },
+    { name: 'startTemplate', target: 'eventConfig', label: 'Start Date', type: 'template', placeholder: '{{payload.startTime}}', execKey: 'start' },
+    { name: 'endTemplate', target: 'eventConfig', label: 'End Date', type: 'template', placeholder: '{{payload.endTime}}', execKey: 'end' },
+    {
+        name: 'attendeesTemplate',
+        target: 'eventConfig',
+        label: 'Attendees (comma-separated emails)',
+        type: 'template',
+        placeholder: '{{payload.attendees}}',
+        description: 'e.g. user@example.com, other@example.com',
+        execKey: 'attendees',
+    },
+    { name: 'timeZone', target: 'eventConfig', label: 'Time Zone', type: 'timezone', execKey: 'timeZone' },
+];
+exports.GOOGLE_CALENDAR_OPERATION_SPECS = {
+    createEvent: {
+        label: 'Create Event',
+        description: 'Create a new calendar event',
+        apiMethod: 'events.insert',
+        params: eventConfigParams(),
+    },
+    updateEvent: {
+        label: 'Update Event',
+        description: 'Update an existing event by ID',
+        apiMethod: 'events.patch',
+        params: [
+            eventIdParam('Event ID', 'Template to resolve the Google Calendar event ID'),
+            ...eventConfigParams(),
+        ],
+    },
+    deleteEvent: {
+        label: 'Delete Event',
+        description: 'Delete an event by ID',
+        apiMethod: 'events.delete',
+        params: [eventIdParam('Event ID', 'Template to resolve the Google Calendar event ID')],
+    },
+    listEvents: {
+        label: 'List Events',
+        description: 'List events in a date range',
+        apiMethod: 'events.list',
+        params: [
+            { name: 'timeMinTemplate', target: 'listConfig', label: 'Start Date', type: 'template', placeholder: '{{payload.from}}', execKey: 'timeMin' },
+            { name: 'timeMaxTemplate', target: 'listConfig', label: 'End Date', type: 'template', placeholder: '{{payload.to}}', execKey: 'timeMax' },
+            { name: 'maxResults', target: 'listConfig', label: 'Max Results', type: 'number', min: 1, max: 2500, default: 10 },
+            { name: 'query', target: 'listConfig', label: 'Search Query', type: 'template', placeholder: 'meeting' },
+        ],
+    },
+    getEvent: {
+        label: 'Get Event',
+        description: 'Get a single event by ID',
+        apiMethod: 'events.get',
+        params: [eventIdParam('Event ID', 'Template to resolve the Google Calendar event ID')],
+    },
+    /* ── Las cuatro que se abrieron al modo directo el 2026-08-11 ── */
+    listCalendars: {
+        label: 'List Calendars',
+        description: 'List the calendars you can write to (iterable output)',
+        apiMethod: 'calendarList.list',
+        viaExecutor: true,
+        /* Sin campos: no toma nada. Es de descubrimiento, así que en un pipeline
+           determinista aporta poco; está por completitud del enum. */
+        params: [],
+    },
+    findFreeSlots: {
+        label: 'Find Free Slots',
+        description: 'Find open windows in a date range (iterable output)',
+        apiMethod: 'freebusy.query',
+        viaExecutor: true,
+        params: [
+            { name: 'timeMinTemplate', target: 'listConfig', label: 'Window Start', type: 'template', required: true, placeholder: '{{payload.from}}', description: 'ISO 8601. Start of the window to search.', execKey: 'timeMin' },
+            { name: 'timeMaxTemplate', target: 'listConfig', label: 'Window End', type: 'template', required: true, placeholder: '{{payload.to}}', description: 'ISO 8601. End of the window to search.', execKey: 'timeMax' },
+            { name: 'durationMinutes', target: 'listConfig', label: 'Slot Length (minutes)', type: 'number', min: 15, max: 480, default: 30, description: 'Only windows at least this long are returned.', execKey: 'durationMinutes' },
+            { name: 'calendarIds', target: 'listConfig', label: 'Extra Calendars (comma-separated ids)', type: 'template', placeholder: 'primary, team@example.com', description: 'Combine availability across these. Empty = just the calendar configured above.', execKey: 'calendarIds' },
+            { name: 'timeZone', target: 'listConfig', label: 'Time Zone', type: 'timezone', description: 'IANA zone used to read the window bounds.', execKey: 'timeZone' },
+        ],
+    },
+    proposeEvent: {
+        label: 'Propose Event (tentative)',
+        description: 'Create a tentative event — no invites sent',
+        apiMethod: 'events.insert (status: tentative)',
+        viaExecutor: true,
+        params: [
+            ...eventConfigParams(),
+            /* `recurrence` sólo entra aquí, que va por el ejecutor. `createEvent` y
+               `updateEvent` siguen sin él porque su ruta es el `buildEventBody`
+               escrito a mano del servicio: es una asimetría entre modos que ya
+               existía y que esto no crea ni arregla. */
+            {
+                name: 'recurrenceTemplate',
+                target: 'eventConfig',
+                label: 'Recurrence (RRULE)',
+                type: 'template',
+                placeholder: 'RRULE:FREQ=WEEKLY;BYDAY=MO',
+                description: 'One RFC 5545 rule. Empty = a one-off event.',
+                execKey: 'recurrence',
+            },
+        ],
+    },
+    confirmEvent: {
+        label: 'Confirm Proposed Event',
+        description: 'Promote a tentative event and send invites',
+        apiMethod: 'events.patch (status: confirmed)',
+        viaExecutor: true,
+        params: [
+            eventIdParam('Proposal ID', 'The proposalId a Propose Event run returned. Normally {{payload.proposalId}} from an upstream node — this op is meant to sit downstream of a Propose Event.'),
+            {
+                name: 'sendUpdates',
+                target: 'root',
+                label: 'Invite Policy',
+                type: 'select',
+                default: 'all',
+                options: [
+                    { value: 'all', label: 'All attendees' },
+                    { value: 'externalOnly', label: 'External attendees only' },
+                    { value: 'none', label: "Don't send invites" },
+                ],
+                execKey: 'sendUpdates',
+            },
+        ],
+    },
+};

package/dist/calendar-toolkit.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Calendar AI Toolkit — las nueve herramientas que un calendarAction expone
+ * cuando `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez.** Antes vivía dos veces —aquí y en
+ * `api/src/mcp-servers/toolkit-specs.ts`— y las dos copias YA habían derivado:
+ * las **siete** operaciones que aceptan `calendarId` describían el parámetro de
+ * dos maneras distintas. Gana la de la api, que es la única que dice cuál es el
+ * defecto:
+ *
+ *     api        "Optional calendar id. Defaults to the configured calendar
+ *                 (usually 'primary'). Use list_my_calendars to discover ids."
+ *     dashboard  "Optional override of the configured calendar. Use
+ *                 list_my_calendars first to discover ids when the user
+ *                 mentions a non-default calendar."
+ *
+ * Esa deriva estaba en la descripción de un PARÁMETRO, así que el conteo de la
+ * auditoría del 2026-08-10 no la veía y daba Calendar por limpio. Con las
+ * descripciones de parámetro incluidas, la deriva real de los ocho toolkits
+ * duplicados eran 32 y no 18.
+ *
+ * Dos cosas que **no** se añaden, a propósito:
+ *   - `group`: Calendar nunca tuvo cabeceras de grupo en su lista, y meterlas
+ *     es estructura visible nueva.
+ *   - `destructive` en `delete_calendar_event`: cambiaría el comportamiento de
+ *     `requireConfirmationForDestructive`. Mismo criterio que en Telegram.
+ *
+ * El array se generó desde la copia de la api para que las descripciones largas
+ * salieran idénticas, no tecleadas.
+ */
+import type { GoogleCalendarOperation } from './calendar-operations';
+export interface GoogleCalendarToolkitParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface GoogleCalendarToolkitSpec {
+    operation: GoogleCalendarOperation;
+    /** Etiqueta corta de la fila en la lista de herramientas. */
+    label: string;
+    /** El nombre con el que el LLM llama a la herramienta. */
+    toolName: string;
+    /** Descripción y reglas de uso que ve el LLM. */
+    description: string;
+    parameters: GoogleCalendarToolkitParameter[];
+}
+export declare const GOOGLE_CALENDAR_TOOLKIT_SPECS: GoogleCalendarToolkitSpec[];
+/** Índice por nombre de herramienta, para enrutar un `tools/call` sin recorrer. */
+export declare const GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME: Record<string, GoogleCalendarToolkitSpec>;

package/dist/calendar-toolkit.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * Calendar AI Toolkit — las nueve herramientas que un calendarAction expone
+ * cuando `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez.** Antes vivía dos veces —aquí y en
+ * `api/src/mcp-servers/toolkit-specs.ts`— y las dos copias YA habían derivado:
+ * las **siete** operaciones que aceptan `calendarId` describían el parámetro de
+ * dos maneras distintas. Gana la de la api, que es la única que dice cuál es el
+ * defecto:
+ *
+ *     api        "Optional calendar id. Defaults to the configured calendar
+ *                 (usually 'primary'). Use list_my_calendars to discover ids."
+ *     dashboard  "Optional override of the configured calendar. Use
+ *                 list_my_calendars first to discover ids when the user
+ *                 mentions a non-default calendar."
+ *
+ * Esa deriva estaba en la descripción de un PARÁMETRO, así que el conteo de la
+ * auditoría del 2026-08-10 no la veía y daba Calendar por limpio. Con las
+ * descripciones de parámetro incluidas, la deriva real de los ocho toolkits
+ * duplicados eran 32 y no 18.
+ *
+ * Dos cosas que **no** se añaden, a propósito:
+ *   - `group`: Calendar nunca tuvo cabeceras de grupo en su lista, y meterlas
+ *     es estructura visible nueva.
+ *   - `destructive` en `delete_calendar_event`: cambiaría el comportamiento de
+ *     `requireConfirmationForDestructive`. Mismo criterio que en Telegram.
+ *
+ * El array se generó desde la copia de la api para que las descripciones largas
+ * salieran idénticas, no tecleadas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CALENDAR_TOOLKIT_SPECS = void 0;
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+exports.GOOGLE_CALENDAR_TOOLKIT_SPECS = [
+    {
+        operation: "createEvent",
+        label: "Create event",
+        toolName: "create_calendar_event",
+        description: "Create a new event on the user's calendar. USAGE RULES: (1) Always include start AND end (ISO 8601 datetime or YYYY-MM-DD for all-day). (2) For ALL-DAY events the `end` date is EXCLUSIVE — to cover Apr 19+20 send start=2026-04-19 end=2026-04-21. A single-day all-day event needs end = start + 1 day. (3) Confirm date + time + timezone in your reply (the user lives in Mexico City UTC-6 unless told otherwise). (4) Compose the summary fresh from the user's CURRENT request — never reuse content recalled from memory unless the user explicitly references it. (5) For events with external attendees or significant impact, prefer propose_calendar_event (tentative, no invites) so the user can preview before invites go out.",
+        parameters: [
+            p("summary", "Short event title.", true),
+            p("start", "Event start. ISO 8601 datetime (e.g. 2026-04-19T15:00:00) or date (YYYY-MM-DD) for all-day.", true),
+            p("end", "Event end. Same format as start. For all-day events this is EXCLUSIVE: an event that covers Apr 19+20 needs end=2026-04-21.", true),
+            p("description", "Optional longer description.", false),
+            p("location", "Optional physical or virtual location.", false),
+            p("attendees", "Comma-separated emails to invite.", false),
+            p("timeZone", "IANA timezone (e.g. America/Mexico_City). Defaults to UTC.", false),
+            p("recurrence", "Optional RFC 5545 RRULE string for repeating events (e.g. \"RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=10\"). Daily=\"RRULE:FREQ=DAILY\"; weekly Mon=\"RRULE:FREQ=WEEKLY;BYDAY=MO\"; monthly first=\"RRULE:FREQ=MONTHLY;BYDAY=1MO\". Confirm the recurrence pattern in your reply.", false),
+            p("calendarId", "Optional calendar id. Defaults to the configured calendar (usually 'primary'). Use list_my_calendars to discover ids.", false),
+        ],
+    },
+    {
+        operation: "updateEvent",
+        label: "Update event",
+        toolName: "update_calendar_event",
+        description: "Update an existing event by id. Only fields you provide are changed (PATCH semantics). USAGE RULES: (1) Use eventId from a getEvent / listEvents call earlier in THIS conversation, never from memory. (2) When changing time, confirm the new time + timezone in your reply. (3) EXTENDING an all-day event across more days: send the new `end` as the day AFTER the last day (Google's all-day end is EXCLUSIVE). To make an event cover Apr 19+20, set end=2026-04-21. (4) When you change one of start/end on an all-day event, send BOTH so the new range is unambiguous (otherwise PATCH may leave a stale boundary).",
+        parameters: [
+            p("eventId", "Event id from listEvents / getEvent in THIS conversation.", true),
+            p("summary", "Optional new title.", false),
+            p("start", "Optional new start. For all-day events use YYYY-MM-DD.", false),
+            p("end", "Optional new end. For all-day events this is EXCLUSIVE: to cover through Apr 20 send end=2026-04-21.", false),
+            p("description", "Optional new description.", false),
+            p("location", "Optional new location.", false),
+            p("attendees", "Optional new attendee list (REPLACES existing).", false),
+            p("timeZone", "Optional timezone.", false),
+            p("recurrence", "Optional RFC 5545 RRULE string for repeating events (e.g. \"RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=10\"). Daily=\"RRULE:FREQ=DAILY\"; weekly Mon=\"RRULE:FREQ=WEEKLY;BYDAY=MO\"; monthly first=\"RRULE:FREQ=MONTHLY;BYDAY=1MO\". Confirm the recurrence pattern in your reply.", false),
+            p("calendarId", "Optional calendar id. Defaults to the configured calendar (usually 'primary'). Use list_my_calendars to discover ids.", false),
+        ],
+    },
+    {
+        operation: "deleteEvent",
+        label: "Delete event",
+        toolName: "delete_calendar_event",
+        description: "Permanently delete an event. USAGE RULES: (1) ALWAYS confirm with the user before calling this — calendar deletes are silent and irreversible. (2) Use eventId from a tool call earlier in THIS conversation.",
+        parameters: [
+            p("eventId", "Event id to delete.", true),
+            p("calendarId", "Optional calendar id. Defaults to the configured calendar (usually 'primary'). Use list_my_calendars to discover ids.", false),
+        ],
+    },
+    {
+        operation: "listEvents",
+        label: "List events",
+        toolName: "list_calendar_events",
+        description: "Search the user's calendar. Returns headers (summary, start, end, attendees) per match. USAGE RULES: (1) Default to next 7 days when the user doesn't specify a window. (2) Use ISO datetimes for timeMin / timeMax. (3) For full event details (description, location), call getEvent with the specific id.",
+        parameters: [
+            p("timeMin", "Start of window (ISO 8601). Defaults to now.", false),
+            p("timeMax", "End of window (ISO 8601). Defaults to 7 days from now.", false),
+            p("maxResults", "Default 25, max 250.", false, "number"),
+            p("query", "Free-text search across summary/description/attendees.", false),
+            p("timeZone", "IANA timezone for parsing timeMin/timeMax.", false),
+            p("calendarId", "Optional calendar id. Defaults to the configured calendar (usually 'primary'). Use list_my_calendars to discover ids.", false),
+        ],
+    },
+    {
+        operation: "getEvent",
+        label: "Get event",
+        toolName: "get_calendar_event",
+        description: "Fetch a single event by id. Returns full details including description, attendees, organizer, recurrence.",
+        parameters: [
+            p("eventId", "Event id to fetch.", true),
+            p("calendarId", "Optional calendar id. Defaults to the configured calendar (usually 'primary'). Use list_my_calendars to discover ids.", false),
+        ],
+    },
+    {
+        operation: "listCalendars",
+        label: "List my calendars",
+        toolName: "list_my_calendars",
+        description: "Return all calendars the user can write to (primary + shared + secondary). USAGE RULES: (1) Call this when the user mentions a non-default calendar by name (e.g. 'add this to my Work calendar') and you don't yet know its id. (2) After listing, pass the matching `id` as `calendarId` on subsequent ops to target that calendar.",
+        parameters: [],
+    },
+    {
+        operation: "findFreeSlots",
+        label: "Find free slots",
+        toolName: "find_calendar_free_slots",
+        description: "Return open windows in a date range across one or more calendars. USAGE RULES: (1) Call this BEFORE proposing / creating an event when the user asks 'when am I free' or wants you to pick a time. (2) Default window: next 7 days, business hours 8am-6pm in the user's timezone. (3) Suggest the top 2-3 slots in your reply, then ask which they prefer.",
+        parameters: [
+            p("timeMin", "Start of window (ISO 8601).", true),
+            p("timeMax", "End of window (ISO 8601).", true),
+            p("durationMinutes", "Required slot length in minutes. Default 30, min 15, max 480.", false, "number"),
+            p("calendarIds", "Comma-separated calendar ids to combine availability across. Defaults to the configured calendar.", false),
+            p("timeZone", "IANA timezone for parsing timeMin/timeMax.", false),
+        ],
+    },
+    {
+        operation: "proposeEvent",
+        label: "Propose event (tentative)",
+        toolName: "propose_calendar_event",
+        description: "Create a TENTATIVE event (status: tentative, NO invites sent). The user sees it greyed out in their calendar. USAGE RULES: (1) Use this instead of create_calendar_event for events with external attendees or significant impact — the user previews before invites fire. (2) Show the proposalId in your reply ('I drafted: <details>. Confirm with proposalId X to send invites.'). (3) After the user confirms, call confirm_calendar_event with that proposalId. If they reject, call delete_calendar_event with it.",
+        parameters: [
+            p("summary", "Short event title.", true),
+            p("start", "Event start (ISO 8601 or YYYY-MM-DD for all-day).", true),
+            p("end", "Event end. For all-day events this is EXCLUSIVE: to cover through Apr 20 send end=2026-04-21.", true),
+            p("description", "Optional longer description.", false),
+            p("location", "Optional location.", false),
+            p("attendees", "Optional comma-separated emails (NOT invited yet — only saved on the tentative event).", false),
+            p("timeZone", "IANA timezone.", false),
+            p("recurrence", "Optional RFC 5545 RRULE string for repeating events (e.g. \"RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=10\"). Daily=\"RRULE:FREQ=DAILY\"; weekly Mon=\"RRULE:FREQ=WEEKLY;BYDAY=MO\"; monthly first=\"RRULE:FREQ=MONTHLY;BYDAY=1MO\". Confirm the recurrence pattern in your reply.", false),
+            p("calendarId", "Optional calendar id. Defaults to the configured calendar (usually 'primary'). Use list_my_calendars to discover ids.", false),
+        ],
+    },
+    {
+        operation: "confirmEvent",
+        label: "Confirm proposed event",
+        toolName: "confirm_calendar_event",
+        description: "Promote a tentative event to confirmed and (by default) send invites to attendees. Pairs with propose_calendar_event for the preview-then-commit flow. USAGE RULES: (1) Use the proposalId from your most recent propose_calendar_event call in THIS conversation — never from memory. (2) sendUpdates default 'all' fires invites; pass 'externalOnly' for just non-org attendees, or 'none' to silently confirm.",
+        parameters: [
+            p("eventId", "Proposal id (returned by propose_calendar_event as proposalId).", true),
+            p("sendUpdates", "Invite policy: 'all' (default), 'externalOnly', or 'none'.", false),
+            p("calendarId", "Optional calendar id. Defaults to the configured calendar (usually 'primary'). Use list_my_calendars to discover ids.", false),
+        ],
+    },
+];
+/** Índice por nombre de herramienta, para enrutar un `tools/call` sin recorrer. */
+exports.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.GOOGLE_CALENDAR_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/index.d.ts

@@ -7,8 +7,10 @@ export type { NodeRegistryEntry, NodeGroup } from './registry';
 export { NODE_REGISTRY, getNodeRegistryEntry, NODE_DETAIL_PATHS, NODE_COLORS, NODE_STATE_KEYS, PREFIX_TO_NODE_TYPE, NODE_TYPE_TO_PREFIX, } from './registry';
 export { GMAIL_OPERATIONS, isGmailOperation, } from './gmail-operations';
 export type { GmailOperation } from './gmail-operations';
-export { GOOGLE_CALENDAR_OPERATIONS, isGoogleCalendarOperation, } from './calendar-operations';
-export type { GoogleCalendarOperation } from './calendar-operations';
+export { GOOGLE_CALENDAR_OPERATIONS, GOOGLE_CALENDAR_OPERATION_SPECS, isGoogleCalendarOperation, } from './calendar-operations';
+export type { GoogleCalendarOperation, GoogleCalendarParamTarget, GoogleCalendarParamType, GoogleCalendarParamSpec, GoogleCalendarOperationSpec, } from './calendar-operations';
+export { GOOGLE_CALENDAR_TOOLKIT_SPECS, GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME, } from './calendar-toolkit';
+export type { GoogleCalendarToolkitSpec, GoogleCalendarToolkitParameter, } from './calendar-toolkit';
 export { DRIVE_OPERATIONS, DRIVE_OPERATION_SPECS, isDriveOperation, } from './drive-operations';
 export type { DriveOperation, DriveParamType, DriveParamSpec, DriveOperationSpec, } from './drive-operations';
 export { DRIVE_TOOLKIT_SPECS, DRIVE_TOOLKIT_BY_TOOL_NAME, } from './drive-toolkit';
@@ -31,5 +33,7 @@ export { GOOGLE_CONTACTS_OPERATIONS, GOOGLE_CONTACTS_OPERATIONS_V1, GOOGLE_CONTA
 export type { GoogleContactsOperation, GoogleContactsParamSpec, GoogleContactsOperationSpec, GoogleContactsOperationGroup, } from './google-contacts-operations';
 export { POSTGRES_OPERATIONS, POSTGRES_MODES, POSTGRES_OPERATION_SPECS, isPostgresOperation, } from './postgres-operations';
 export type { PostgresOperation, PostgresMode, PostgresOperationSpec, } from './postgres-operations';
+export { MONGO_OPERATIONS, MONGO_OPERATION_SPECS, isMongoOperation, } from './mongo-operations';
+export type { MongoOperation, MongoParamType, MongoParamSpec, MongoOperationSpec, } from './mongo-operations';
 export type { CredentialTypeRegistration, CredentialType } from './credentials';
 export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials';

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = 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.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.GMAIL_OPERATIONS = 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.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.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_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 = void 0;
+exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = 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.GMAIL_OPERATIONS = 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.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.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_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 = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_1.iterableMeta; } });
@@ -38,7 +38,11 @@ Object.defineProperty(exports, "GMAIL_OPERATIONS", { enumerable: true, get: func
 Object.defineProperty(exports, "isGmailOperation", { enumerable: true, get: function () { return gmail_operations_1.isGmailOperation; } });
 var calendar_operations_1 = require("./calendar-operations");
 Object.defineProperty(exports, "GOOGLE_CALENDAR_OPERATIONS", { enumerable: true, get: function () { return calendar_operations_1.GOOGLE_CALENDAR_OPERATIONS; } });
+Object.defineProperty(exports, "GOOGLE_CALENDAR_OPERATION_SPECS", { enumerable: true, get: function () { return calendar_operations_1.GOOGLE_CALENDAR_OPERATION_SPECS; } });
 Object.defineProperty(exports, "isGoogleCalendarOperation", { enumerable: true, get: function () { return calendar_operations_1.isGoogleCalendarOperation; } });
+var calendar_toolkit_1 = require("./calendar-toolkit");
+Object.defineProperty(exports, "GOOGLE_CALENDAR_TOOLKIT_SPECS", { enumerable: true, get: function () { return calendar_toolkit_1.GOOGLE_CALENDAR_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return calendar_toolkit_1.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME; } });
 var drive_operations_1 = require("./drive-operations");
 Object.defineProperty(exports, "DRIVE_OPERATIONS", { enumerable: true, get: function () { return drive_operations_1.DRIVE_OPERATIONS; } });
 Object.defineProperty(exports, "DRIVE_OPERATION_SPECS", { enumerable: true, get: function () { return drive_operations_1.DRIVE_OPERATION_SPECS; } });
@@ -85,6 +89,10 @@ Object.defineProperty(exports, "POSTGRES_OPERATIONS", { enumerable: true, get: f
 Object.defineProperty(exports, "POSTGRES_MODES", { enumerable: true, get: function () { return postgres_operations_1.POSTGRES_MODES; } });
 Object.defineProperty(exports, "POSTGRES_OPERATION_SPECS", { enumerable: true, get: function () { return postgres_operations_1.POSTGRES_OPERATION_SPECS; } });
 Object.defineProperty(exports, "isPostgresOperation", { enumerable: true, get: function () { return postgres_operations_1.isPostgresOperation; } });
+var mongo_operations_1 = require("./mongo-operations");
+Object.defineProperty(exports, "MONGO_OPERATIONS", { enumerable: true, get: function () { return mongo_operations_1.MONGO_OPERATIONS; } });
+Object.defineProperty(exports, "MONGO_OPERATION_SPECS", { enumerable: true, get: function () { return mongo_operations_1.MONGO_OPERATION_SPECS; } });
+Object.defineProperty(exports, "isMongoOperation", { enumerable: true, get: function () { return mongo_operations_1.isMongoOperation; } });
 var credentials_1 = require("./credentials");
 Object.defineProperty(exports, "CREDENTIAL_TYPES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPES; } });
 Object.defineProperty(exports, "CREDENTIAL_TYPE_VALUES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPE_VALUES; } });

package/dist/mongo-operations.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MongoDB operation enum + esquema del formulario — una sola copia para la api,
+ * el Dashboard y el broker.
+ *
+ * ── Lo que quita ──
+ * La lista estaba escrita a mano **cinco veces sólo en la api** (tres en el DTO,
+ * dos en la entidad) y otras tantas en el dashboard. Y de los siete valores,
+ * el lienzo sólo conocía **cinco**: `findAll` y `findOneAndUpdate` no estaban en
+ * sus mapas de etiqueta y color, así que se pintaban grises y con el nombre
+ * crudo en camelCase mientras el panel sí les daba azul y ámbar.
+ *
+ * ── Lo fácil de Mongo ──
+ * Al contrario que Drive o Calendar, aquí **no hay capa de renombrado**: el
+ * `name` de cada param es la prop de la entidad tal cual, y el `apiUpdate` de la
+ * página es un passthrough de una línea. Es la forma de guardado más simple de
+ * la tanda.
+ */
+export declare const MONGO_OPERATIONS: readonly ["insertOne", "findOne", "findAll", "updateOne", "findOneAndUpdate", "deleteOne", "aggregate"];
+export type MongoOperation = (typeof MONGO_OPERATIONS)[number];
+/** Type guard — útil al validar entrada que no controlas (DTOs, tool calls). */
+export declare function isMongoOperation(value: unknown): value is MongoOperation;
+export type MongoParamType = 
+/** El `TemplateEditor` de JSON, con autocompletado de `{{payload.*}}`. */
+'jsonTemplate'
+/** El componente `UpdateBuilder` (arma `$set`, `$inc`… sin escribir JSON). */
+ | 'updateBuilder'
+/**
+ * Un `Switch` que se guarda **al instante** (`updateFieldInstant`) y se lee de
+ * la entidad, no de los locales. Se conserva así porque es como estaba.
+ */
+ | 'booleanInstant';
+export interface MongoParamSpec {
+    /** La prop de la entidad. Sin renombrado: es también la clave del cable. */
+    name: string;
+    label: string;
+    type: MongoParamType;
+    /** Texto de ayuda. Llano: el paquete no lleva React. */
+    description?: string;
+    placeholder?: string;
+    /** Sólo para `jsonTemplate`: la altura del editor. */
+    minHeight?: number;
+    maxHeight?: number;
+}
+export interface MongoOperationSpec {
+    /** La del desplegable de la página de detalle: «Insert One». */
+    label: string;
+    /**
+     * La de la píldora estrecha del lienzo y del panel: «INSERT».
+     *
+     * **Son dos etiquetas a propósito**, como en Calendar: dos anchos distintos y
+     * las dos se ven. Antes había una TERCERA convención, porque el panel pintaba
+     * `operation.toUpperCase()` y decía «FINDONEANDUPDATE» donde el lienzo decía
+     * «UPDATE». Ahora los dos leen esta.
+     */
+    labelShort: string;
+    /** Sub-línea del desplegable. */
+    description: string;
+    /** Orden de pantalla. */
+    params: MongoParamSpec[];
+}
+export declare const MONGO_OPERATION_SPECS: Record<MongoOperation, MongoOperationSpec>;

package/dist/mongo-operations.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * MongoDB operation enum + esquema del formulario — una sola copia para la api,
+ * el Dashboard y el broker.
+ *
+ * ── Lo que quita ──
+ * La lista estaba escrita a mano **cinco veces sólo en la api** (tres en el DTO,
+ * dos en la entidad) y otras tantas en el dashboard. Y de los siete valores,
+ * el lienzo sólo conocía **cinco**: `findAll` y `findOneAndUpdate` no estaban en
+ * sus mapas de etiqueta y color, así que se pintaban grises y con el nombre
+ * crudo en camelCase mientras el panel sí les daba azul y ámbar.
+ *
+ * ── Lo fácil de Mongo ──
+ * Al contrario que Drive o Calendar, aquí **no hay capa de renombrado**: el
+ * `name` de cada param es la prop de la entidad tal cual, y el `apiUpdate` de la
+ * página es un passthrough de una línea. Es la forma de guardado más simple de
+ * la tanda.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = void 0;
+exports.isMongoOperation = isMongoOperation;
+exports.MONGO_OPERATIONS = [
+    'insertOne', // inserta un documento
+    'findOne', // devuelve el primero que casa
+    'findAll', // devuelve todos los que casan (tope 1000)
+    'updateOne', // actualiza el primero que casa
+    'findOneAndUpdate', // actualiza y devuelve el documento
+    'deleteOne', // borra el primero que casa
+    'aggregate', // pipeline de agregación
+];
+/** Type guard — útil al validar entrada que no controlas (DTOs, tool calls). */
+function isMongoOperation(value) {
+    return typeof value === 'string' && exports.MONGO_OPERATIONS.includes(value);
+}
+/* Los campos que comparten varias operaciones. */
+const queryTemplate = () => ({
+    name: 'queryTemplate',
+    label: 'Query Template',
+    type: 'jsonTemplate',
+    placeholder: '{"email": "{{payload.email}}"}',
+    minHeight: 100,
+    maxHeight: 200,
+});
+const updateTemplate = () => ({
+    name: 'updateTemplate',
+    label: 'Update Operations',
+    type: 'updateBuilder',
+});
+exports.MONGO_OPERATION_SPECS = {
+    insertOne: {
+        label: 'Insert One',
+        labelShort: 'INSERT',
+        description: 'Insert a single document',
+        params: [
+            {
+                name: 'documentTemplate',
+                label: 'Document Template',
+                type: 'jsonTemplate',
+                placeholder: '{"name": "{{payload.name}}", "email": "{{payload.email}}"}',
+                minHeight: 100,
+                maxHeight: 200,
+            },
+        ],
+    },
+    findOne: {
+        label: 'Find One',
+        labelShort: 'FIND',
+        description: 'Find a single matching document',
+        params: [queryTemplate()],
+    },
+    findAll: {
+        label: 'Find All',
+        /* Antes no estaba en el mapa del lienzo y salía el crudo `findAll`. */
+        labelShort: 'FIND ALL',
+        description: 'Find all matching documents (limit 1000)',
+        params: [
+            /* El interruptor va ANTES del query, que es el orden en que se pintaba. */
+            {
+                name: 'includeCount',
+                label: 'Include Count',
+                type: 'booleanInstant',
+                description: 'Return total count of matching documents alongside results',
+            },
+            queryTemplate(),
+        ],
+    },
+    updateOne: {
+        label: 'Update One',
+        labelShort: 'UPDATE',
+        description: 'Update a single matching document',
+        params: [queryTemplate(), updateTemplate()],
+    },
+    findOneAndUpdate: {
+        label: 'Find & Update',
+        /* Tampoco estaba: salía el crudo `findOneAndUpdate` en el lienzo y
+           `FINDONEANDUPDATE` en el panel. */
+        labelShort: 'FIND & UPDATE',
+        description: 'Find, update, and return the document',
+        params: [queryTemplate(), updateTemplate()],
+    },
+    deleteOne: {
+        label: 'Delete One',
+        labelShort: 'DELETE',
+        description: 'Delete a single matching document',
+        params: [queryTemplate()],
+    },
+    aggregate: {
+        label: 'Aggregate',
+        labelShort: 'AGGREGATE',
+        description: 'Run aggregation pipeline ($match, $group, $sort...)',
+        params: [
+            {
+                /* Mismo campo que en las demás, con otro título y otro ejemplo: por eso
+                   los params se declaran por operación y no en un registro global. */
+                name: 'queryTemplate',
+                label: 'Pipeline Template',
+                type: 'jsonTemplate',
+                placeholder: '[{"$match": {"status": "active"}}, {"$group": {"_id": "$category"}}]',
+                minHeight: 100,
+                maxHeight: 200,
+            },
+        ],
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-types",
-  "version": "1.52.13",
+  "version": "1.52.15",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",