@hostwebhook/node-types 1.52.11 → 1.52.12

package/dist/drive-operations.d.ts

@@ -20,3 +20,84 @@ export declare const DRIVE_OPERATIONS: readonly ["upload", "download", "copy", "
 export type DriveOperation = (typeof DRIVE_OPERATIONS)[number];
 /** Type guard — useful when validating untrusted input (DTOs, tool calls). */
 export declare function isDriveOperation(value: unknown): value is DriveOperation;
+export type DriveParamType = 
+/** Live file picker (needs a credential) + templated paste. */
+'driveFile'
+/** Text input with `{{payload.*}}` autocomplete. */
+ | 'template'
+/** Plain `<select>`; the labels are not the values, so `options` is required. */
+ | 'select'
+/**
+ * Searchable mime-type dropdown. The option list is long and shared with
+ * other screens, so it stays in the dashboard (`lib/drive-mime-options`)
+ * and the schema only says "this field is a mime picker".
+ */
+ | 'mimeSelect' | 'number'
+/**
+ * A `<select>` whose values are `''` / `'true'` / `'false'` but which is
+ * stored as a BOOLEAN, or omitted entirely when `''`.
+ *
+ * This is the shape that keeps `starred` honest: the api applies it with
+ * `typeof config.starred === 'boolean'`, so "— don't change —" has to mean
+ * *no key at all*. A plain Switch cannot express that third state, and
+ * storing `''` or `'false'` would silently stop the star from ever changing.
+ */
+ | 'booleanSelect'
+/**
+ * Full-width explainer card that toggles: icon, title, prose and bullets,
+ * with the switch on the right. The card's rich body is JSX, so it lives in
+ * the page keyed by param name — the schema only declares the field.
+ */
+ | 'switchCard'
+/** Live multi-select of the starting folder's immediate children. */
+ | 'driveSubfolders';
+export interface DriveParamSpec {
+    /** The `operationConfig` key. This is what the api reads — not a UI name. */
+    name: string;
+    label: string;
+    type: DriveParamType;
+    required?: boolean;
+    /**
+     * Help text under the field. Plain text on purpose: the package holds no
+     * React, so the `<code>` spans the page used to have are gone. Deliberate.
+     */
+    description?: string;
+    placeholder?: string;
+    /** Prefilled when the saved config has no value for this key. */
+    default?: string | number;
+    /** Required for `select` and `booleanSelect` — label and value differ. */
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+    min?: number;
+    max?: number;
+    /**
+     * Renders in the "Advanced" tab instead of "Config". The page used to keep
+     * a two-name `ADVANCED_FIELDS` array while the advanced *tab* actually held
+     * four fields, so `recursive` and `subfolderIds` only showed up because
+     * `list` happened to also carry one of the two named fields. Marking all
+     * four here removes that coincidence.
+     */
+    advanced?: boolean;
+    /**
+     * Only shown when a sibling field holds one of these values. No other node's
+     * schema needed this yet; Drive has three cases (the two share targets and
+     * the subfolder scope).
+     */
+    showWhen?: {
+        field: string;
+        in: ReadonlyArray<string>;
+    };
+}
+export interface DriveOperationSpec {
+    /** UI label for the operation dropdown row. */
+    label: string;
+    /** Sub-line under the label in the dropdown. */
+    description: string;
+    /** Drive API method it maps to (developers.google.com/drive/api/reference). */
+    apiMethod: string;
+    /** Parameter schema. Order matters: it is the on-screen order. */
+    params: DriveParamSpec[];
+}
+export declare const DRIVE_OPERATION_SPECS: Record<DriveOperation, DriveOperationSpec>;

package/dist/drive-operations.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DRIVE_OPERATIONS = void 0;
+exports.DRIVE_OPERATION_SPECS = exports.DRIVE_OPERATIONS = void 0;
 exports.isDriveOperation = isDriveOperation;
 /**
  * Google Drive operation enum — single source of truth across the API,
@@ -38,3 +38,286 @@ exports.DRIVE_OPERATIONS = [
 function isDriveOperation(value) {
     return typeof value === 'string' && exports.DRIVE_OPERATIONS.includes(value);
 }
+/* Fábricas de los campos que se repiten, para que un cambio de copy no haya
+   que perseguirlo por doce operaciones. */
+const fileId = () => ({
+    name: 'fileId',
+    label: 'Drive File',
+    type: 'driveFile',
+    required: true,
+    description: 'Pick a file from Drive or paste a templated value like {{payload.driveFileId}}.',
+});
+const parentFolderId = () => ({
+    name: 'parentFolderId',
+    label: 'Parent Folder ID (override)',
+    type: 'template',
+    advanced: true,
+    placeholder: 'Empty = use Default Folder above',
+    description: "Folder id used for this operation only. Leave empty to use the action's Default Folder. Templates work — e.g. {{payload.folderId}}.",
+});
+/** El filtro por tipo de upload/list. En `export` el mismo `mimeType` es otra
+    cosa y se declara aparte. */
+const mimeTypeFilter = () => ({
+    name: 'mimeType',
+    label: 'File type filter (optional)',
+    type: 'mimeSelect',
+    description: 'Restrict the operation to files of this type. Leave as "Any" to match every file.',
+});
+const ORDER_BY_OPTIONS = [
+    { value: 'modifiedTime desc', label: 'Modified time (newest first)' },
+    { value: 'modifiedTime', label: 'Modified time (oldest first)' },
+    { value: 'createdTime desc', label: 'Created time (newest first)' },
+    { value: 'createdTime', label: 'Created time (oldest first)' },
+    { value: 'name', label: 'Name (A→Z)' },
+    { value: 'name desc', label: 'Name (Z→A)' },
+];
+const EXPORT_FORMAT_OPTIONS = [
+    { value: 'application/pdf', label: 'PDF (.pdf)' },
+    {
+        value: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        label: 'Word (.docx) — for Google Docs',
+    },
+    {
+        value: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        label: 'Excel (.xlsx) — for Google Sheets',
+    },
+    {
+        value: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+        label: 'PowerPoint (.pptx) — for Google Slides',
+    },
+    { value: 'text/plain', label: 'Plain text (.txt)' },
+    { value: 'text/csv', label: 'CSV (.csv) — for Google Sheets' },
+    { value: 'text/html', label: 'HTML (.html)' },
+];
+exports.DRIVE_OPERATION_SPECS = {
+    upload: {
+        label: 'Upload File',
+        description: 'Stream a file from a payload _file ref into Drive',
+        apiMethod: 'files.create',
+        params: [
+            {
+                name: 'fileName',
+                label: 'Destination File Name',
+                type: 'template',
+                placeholder: '{{payload.name}} — leave blank to use _file.originalName',
+            },
+            {
+                name: 'sourceField',
+                label: 'Source Field (payload path)',
+                type: 'template',
+                placeholder: '_file',
+                default: '_file',
+                description: 'Where the _file ref lives in the incoming payload. Default _file. For nested refs use a dotted path (e.g. doc if upstream is { doc: { _file: ... } }).',
+            },
+            mimeTypeFilter(),
+            parentFolderId(),
+        ],
+    },
+    download: {
+        label: 'Download File',
+        description: 'Fetch a Drive file → payload _file ref for downstream nodes',
+        apiMethod: 'files.get (alt=media)',
+        params: [fileId()],
+    },
+    list: {
+        label: 'List / Search',
+        description: 'List or search files (iterable output)',
+        apiMethod: 'files.list',
+        params: [
+            {
+                name: 'query',
+                label: 'Search Query',
+                type: 'template',
+                placeholder: 'Substring to match against file names — empty = list all',
+            },
+            mimeTypeFilter(),
+            {
+                name: 'pageSize',
+                label: 'Max Results',
+                type: 'number',
+                min: 1,
+                max: 100,
+                default: 50,
+                description: 'Up to 100 per call. Output is iterable — downstream nodes process each file independently.',
+            },
+            {
+                name: 'orderBy',
+                label: 'Order By',
+                type: 'select',
+                default: 'modifiedTime desc',
+                options: ORDER_BY_OPTIONS,
+            },
+            parentFolderId(),
+            { name: 'recursive', label: 'Search subfolders too', type: 'switchCard', advanced: true },
+            {
+                name: 'subfolderIds',
+                label: 'Limit to specific subfolders',
+                type: 'driveSubfolders',
+                advanced: true,
+                showWhen: { field: 'recursive', in: ['true'] },
+            },
+            {
+                name: 'downloadResults',
+                label: 'Auto-download matching files',
+                type: 'switchCard',
+                advanced: true,
+            },
+        ],
+    },
+    get: {
+        label: 'Get Metadata',
+        description: 'Read metadata for one file (no bytes)',
+        apiMethod: 'files.get',
+        params: [fileId()],
+    },
+    copy: {
+        label: 'Copy File',
+        description: 'Duplicate a file, optionally rename and/or move',
+        apiMethod: 'files.copy',
+        params: [
+            fileId(),
+            {
+                name: 'newName',
+                label: 'New File Name',
+                type: 'template',
+                placeholder: "Optional — defaults to 'Copy of <original>'",
+            },
+            parentFolderId(),
+        ],
+    },
+    move: {
+        label: 'Move File',
+        description: 'Move a file to a different folder',
+        apiMethod: 'files.update (addParents / removeParents)',
+        params: [fileId(), parentFolderId()],
+    },
+    delete: {
+        label: 'Delete (Trash)',
+        description: 'Move to trash — recoverable for 30 days',
+        apiMethod: 'files.update (trashed) / files.delete when permanent',
+        params: [
+            fileId(),
+            {
+                name: 'permanent',
+                label: 'Delete Permanently?',
+                type: 'booleanSelect',
+                options: [
+                    { value: '', label: 'No — move to trash (recoverable)' },
+                    { value: 'true', label: '⚠️ Yes — erase forever (irreversible)' },
+                ],
+            },
+        ],
+    },
+    share: {
+        label: 'Share File',
+        description: 'Grant viewer / commenter / editor permission',
+        apiMethod: 'permissions.create',
+        params: [
+            fileId(),
+            {
+                name: 'type',
+                label: 'Share With',
+                type: 'select',
+                default: 'user',
+                options: [
+                    { value: 'user', label: 'Specific user (email)' },
+                    { value: 'group', label: 'Group (email)' },
+                    { value: 'domain', label: 'Entire domain' },
+                    { value: 'anyone', label: '⚠️ Anyone with the link (public)' },
+                ],
+            },
+            {
+                name: 'role',
+                label: 'Permission Role',
+                type: 'select',
+                default: 'reader',
+                options: [
+                    { value: 'reader', label: 'Viewer (read-only)' },
+                    { value: 'commenter', label: 'Commenter' },
+                    { value: 'writer', label: 'Editor' },
+                ],
+            },
+            {
+                name: 'emailAddress',
+                label: 'Email Address',
+                type: 'template',
+                placeholder: 'user@example.com or {{payload.email}}',
+                showWhen: { field: 'type', in: ['user', 'group'] },
+            },
+            {
+                name: 'domain',
+                label: 'Domain',
+                type: 'template',
+                placeholder: 'example.com',
+                showWhen: { field: 'type', in: ['domain'] },
+            },
+            {
+                name: 'sendNotificationEmail',
+                label: 'Notify Recipient',
+                type: 'booleanSelect',
+                options: [
+                    { value: '', label: "No — don't send email" },
+                    { value: 'true', label: 'Yes — send share notification email' },
+                ],
+            },
+        ],
+    },
+    update: {
+        label: 'Update Metadata',
+        description: 'Rename, set description, or star/unstar',
+        apiMethod: 'files.update',
+        params: [
+            fileId(),
+            { name: 'name', label: 'New Name', type: 'template', placeholder: '{{payload.title}}' },
+            {
+                name: 'description',
+                label: 'Description (optional)',
+                type: 'template',
+                placeholder: '{{payload.description}}',
+            },
+            {
+                name: 'starred',
+                label: 'Starred (optional)',
+                type: 'booleanSelect',
+                options: [
+                    { value: '', label: "— don't change —" },
+                    { value: 'true', label: '⭐ Star' },
+                    { value: 'false', label: 'Un-star' },
+                ],
+            },
+        ],
+    },
+    createFolder: {
+        label: 'Create Folder',
+        description: 'Create a new folder, optionally inside a parent',
+        apiMethod: 'files.create (folder mimeType)',
+        params: [
+            /* Mismo `name` que en update, con otra etiqueta y otro placeholder: por
+               eso los params son por operación y no un registro global de campos. */
+            { name: 'name', label: 'Folder Name', type: 'template', placeholder: 'Reports' },
+            parentFolderId(),
+        ],
+    },
+    export: {
+        label: 'Export Google Doc',
+        description: 'Export a Doc / Sheet / Slide to PDF / DOCX / XLSX',
+        apiMethod: 'files.export',
+        params: [
+            fileId(),
+            {
+                name: 'mimeType',
+                label: 'Export Format',
+                type: 'select',
+                default: 'application/pdf',
+                options: EXPORT_FORMAT_OPTIONS,
+                description: 'Export only works on Google native docs (Docs, Sheets, Slides, Drawings). For regular files use Download instead.',
+            },
+        ],
+    },
+    getPermissions: {
+        label: 'List Permissions',
+        description: 'List who has access (audit before changing)',
+        apiMethod: 'permissions.list',
+        params: [fileId()],
+    },
+};

package/dist/drive-toolkit.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Drive AI Toolkit — las herramientas que un driveAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez**, como el de Sheets y el de Telegram. Antes vivía
+ * TRES veces, y las tres a mano:
+ *
+ *   1. `dashboard/components/drive-actions/drive-operations-schemas.ts`
+ *   2. `api/src/mcp-servers/toolkit-specs.ts`
+ *   3. la página de detalle, que pintaba las doce herramientas como doce
+ *      `<li>` escritos a mano, con el número `12` también a mano en tres sitios
+ *
+ * La 1 y la 2 no habían derivado todavía (medido el 2026-08-10: cero
+ * diferencias, al contrario que Slack con 13 y WhatsApp con 4). Esto es lo que
+ * hace que sigan sin derivar.
+ *
+ * El ORDEN de este array importa: `AiToolkitPreview` pinta el encabezado de
+ * grupo sólo cuando cambia respecto a la fila anterior, así que las
+ * herramientas del mismo grupo tienen que ir seguidas. Los tres grupos son los
+ * que ya inventaba el JSX que sustituye.
+ */
+import type { DriveOperation } from './drive-operations';
+export interface DriveToolkitParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface DriveToolkitSpec {
+    operation: DriveOperation;
+    /** Etiqueta corta de la fila en la lista de herramientas. */
+    label: string;
+    /**
+     * Nombre con el que el LLM llama a la herramienta. Todas llevan `_drive_` o
+     * `_to_drive` para no chocar con las de Gmail, Sheets o Calendar cuando un
+     * mismo AI Node tiene varios toolkits encendidos.
+     */
+    toolName: string;
+    /** Descripción (más reglas de uso) que ve el LLM. */
+    description: string;
+    parameters: DriveToolkitParameter[];
+    /** Encabezado de grupo de la página de detalle. El orden es el que agrupa. */
+    group?: string;
+    /**
+     * Marca que la herramienta cambia algo difícil de deshacer, para que la página
+     * lo enseñe y el AI Node pida confirmación. Son **dos**, las mismas que ya
+     * estaban marcadas: `delete_drive_file` y `share_drive_file`. `move` no lo
+     * lleva, y es defendible — deshacerlo es otro move.
+     */
+    destructive?: boolean;
+}
+export declare const DRIVE_TOOLKIT_SPECS: DriveToolkitSpec[];
+/** Índice por nombre de herramienta, para enrutar un `tools/call` sin recorrer. */
+export declare const DRIVE_TOOLKIT_BY_TOOL_NAME: Record<string, DriveToolkitSpec>;

package/dist/drive-toolkit.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Drive AI Toolkit — las herramientas que un driveAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez**, como el de Sheets y el de Telegram. Antes vivía
+ * TRES veces, y las tres a mano:
+ *
+ *   1. `dashboard/components/drive-actions/drive-operations-schemas.ts`
+ *   2. `api/src/mcp-servers/toolkit-specs.ts`
+ *   3. la página de detalle, que pintaba las doce herramientas como doce
+ *      `<li>` escritos a mano, con el número `12` también a mano en tres sitios
+ *
+ * La 1 y la 2 no habían derivado todavía (medido el 2026-08-10: cero
+ * diferencias, al contrario que Slack con 13 y WhatsApp con 4). Esto es lo que
+ * hace que sigan sin derivar.
+ *
+ * El ORDEN de este array importa: `AiToolkitPreview` pinta el encabezado de
+ * grupo sólo cuando cambia respecto a la fila anterior, así que las
+ * herramientas del mismo grupo tienen que ir seguidas. Los tres grupos son los
+ * que ya inventaba el JSX que sustituye.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = void 0;
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+const ENTRAN_Y_SALEN = 'Files in / out';
+const DESCUBRIR = 'Discovery';
+const MUTACIONES = 'Mutations (LLM confirms first)';
+exports.DRIVE_TOOLKIT_SPECS = [
+    /* ── Files in / out ─────────────────────────────────────────────────── */
+    {
+        operation: 'upload',
+        label: 'Upload file',
+        toolName: 'upload_to_drive',
+        group: ENTRAN_Y_SALEN,
+        description: 'Upload a file from the current event payload into Google Drive. Requires an `_file` ref in the payload (created by an upstream node — multipart ingress, File Transform, or another Drive download). Streams from R2; never holds the full file in memory.',
+        parameters: [
+            p('fileName', 'Optional. Override the destination file name. Defaults to the _file ref originalName.', false),
+            p('sourceField', 'Optional. Payload field path holding the _file ref. Defaults to "_file".', false),
+            p('parentFolderId', 'Optional. Drive folder ID to upload into. Empty = root.', false),
+            p('mimeType', 'Optional. Override the MIME type. Defaults to the _file ref mimeType.', false),
+        ],
+    },
+    {
+        operation: 'download',
+        label: 'Download file',
+        toolName: 'download_from_drive',
+        group: ENTRAN_Y_SALEN,
+        description: 'Download a Drive file to HostWebhook storage and return a `_file` ref the next pipeline node can consume (FileTransform, AI vision, HTTP body). Use the file ID from list_drive_files / search.',
+        parameters: [p('fileId', 'The Drive file ID to download.')],
+    },
+    {
+        operation: 'export',
+        label: 'Export Google doc',
+        toolName: 'export_drive_file',
+        group: ENTRAN_Y_SALEN,
+        description: 'Export a Google native document (Doc / Sheet / Slide / Drawing) to a downloadable format like PDF or DOCX, returning a `_file` ref the next pipeline node can consume. Does NOT work on regular files (those use download_from_drive).',
+        parameters: [
+            p('fileId', 'The Drive file ID (must be a Google native doc).'),
+            /* De las dos copias me quedo con la de la api, que es la que dice qué
+               formato de origen va a cada destino. La del dashboard se había quedado
+               sin esa parte. Es la única deriva que tenían Drive y, como estaba en la
+               descripción de un PARÁMETRO, ningún conteo la miraba. */
+            p('mimeType', 'Target MIME type. Common: "application/pdf" (Doc/Slide → PDF), "application/vnd.openxmlformats-officedocument.wordprocessingml.document" (Doc → DOCX), "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" (Sheet → XLSX), "text/plain", "text/csv".'),
+        ],
+    },
+    /* ── Discovery ──────────────────────────────────────────────────────── */
+    {
+        operation: 'list',
+        label: 'List / search files',
+        toolName: 'list_drive_files',
+        group: DESCUBRIR,
+        description: "Search the user's Drive (or shared drive). Returns up to N matching files with id, name, mimeType, size, modifiedTime. Use this BEFORE any operation that needs a fileId — never invent IDs.",
+        parameters: [
+            p('query', 'Optional. Substring to match against file names.', false),
+            p('parentFolderId', 'Optional. Restrict search to a single folder.', false),
+            p('mimeType', 'Optional. Filter by MIME type (e.g. "application/pdf", "application/vnd.google-apps.folder").', false),
+            p('pageSize', 'Optional. Max results (default 50, max 100).', false, 'number'),
+            p('orderBy', 'Optional. Drive ordering string (default "modifiedTime desc").', false),
+        ],
+    },
+    {
+        operation: 'get',
+        label: 'Get file metadata',
+        toolName: 'get_drive_file',
+        group: DESCUBRIR,
+        description: 'Read full metadata for one Drive file (name, mimeType, size, parents, owners, starred, trashed). Does NOT download the bytes — use download_from_drive for that.',
+        parameters: [p('fileId', 'The Drive file ID.')],
+    },
+    {
+        operation: 'getPermissions',
+        label: 'List file permissions',
+        toolName: 'get_drive_permissions',
+        group: DESCUBRIR,
+        description: 'List who has access to a Drive file (id, type, role, emailAddress/domain, displayName). Use to audit sharing before changing permissions.',
+        parameters: [p('fileId', 'The Drive file ID.')],
+    },
+    /* ── Mutations ──────────────────────────────────────────────────────── */
+    {
+        operation: 'copy',
+        label: 'Copy file',
+        toolName: 'copy_drive_file',
+        group: MUTACIONES,
+        description: 'Duplicate a Drive file. Optionally rename and/or move into a different folder in one step.',
+        parameters: [
+            p('fileId', 'The source Drive file ID.'),
+            p('newName', 'Optional. Name for the copy. Defaults to "Copy of <original>".', false),
+            p('parentFolderId', 'Optional. Folder ID to place the copy into. Defaults to the source folder.', false),
+        ],
+    },
+    {
+        operation: 'move',
+        label: 'Move file',
+        toolName: 'move_drive_file',
+        group: MUTACIONES,
+        description: 'Move a Drive file to a different folder. The current parents are removed; the file is added to the new parent.',
+        parameters: [
+            p('fileId', 'The Drive file ID to move.'),
+            p('parentFolderId', 'Destination folder ID.'),
+        ],
+    },
+    {
+        operation: 'update',
+        label: 'Update file metadata',
+        toolName: 'update_drive_file',
+        group: MUTACIONES,
+        description: 'Rename a Drive file or change its description / starred status. Use list_drive_files first to find the fileId.',
+        parameters: [
+            p('fileId', 'The Drive file ID.'),
+            p('name', 'Optional. New name.', false),
+            p('description', 'Optional. New description.', false),
+            p('starred', 'Optional. Star/unstar.', false, 'boolean'),
+        ],
+    },
+    {
+        operation: 'createFolder',
+        label: 'Create folder',
+        toolName: 'create_drive_folder',
+        group: MUTACIONES,
+        description: 'Create a new folder in Drive. Use this BEFORE upload_to_drive when the user asks to put a file in a specific named folder that does not yet exist.',
+        parameters: [
+            p('name', 'Folder name.'),
+            p('parentFolderId', 'Optional. Parent folder ID. Empty = root.', false),
+        ],
+    },
+    {
+        operation: 'delete',
+        label: 'Delete file (trash)',
+        toolName: 'delete_drive_file',
+        group: MUTACIONES,
+        description: 'Move a Drive file to trash (recoverable for 30 days). Set permanent=true ONLY when the user explicitly confirms a permanent delete — irreversible. ALWAYS confirm with the user before calling this with permanent=true.',
+        parameters: [
+            p('fileId', 'The Drive file ID to delete.'),
+            p('permanent', 'Optional. true = bypass trash and erase forever (irreversible). Default false.', false, 'boolean'),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'share',
+        label: 'Share file',
+        toolName: 'share_drive_file',
+        group: MUTACIONES,
+        description: 'Grant a permission on a Drive file. CONFIRM with the user before calling this — sharing externally is sensitive. Public sharing (type="anyone") is especially dangerous; only use when the user explicitly says "make it public" or similar.',
+        parameters: [
+            p('fileId', 'The Drive file ID to share.'),
+            p('type', 'One of: "user" | "group" | "domain" | "anyone". Use "anyone" only with explicit user confirmation.'),
+            p('role', 'One of: "reader" | "commenter" | "writer".'),
+            p('emailAddress', 'Required when type=user|group.', false),
+            p('domain', 'Required when type=domain.', false),
+            p('sendNotificationEmail', 'Optional. true = email the recipient about the share.', false, 'boolean'),
+        ],
+        destructive: true,
+    },
+];
+/** Índice por nombre de herramienta, para enrutar un `tools/call` sin recorrer. */
+exports.DRIVE_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.DRIVE_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/index.d.ts

@@ -9,8 +9,10 @@ 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 { DRIVE_OPERATIONS, isDriveOperation, } from './drive-operations';
-export type { DriveOperation } from './drive-operations';
+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';
+export type { DriveToolkitSpec, DriveToolkitParameter, } from './drive-toolkit';
 export { TELEGRAM_OPERATIONS, TELEGRAM_OPERATION_SPECS, isTelegramOperation, } from './telegram-operations';
 export type { TelegramOperation, TelegramParamSpec, TelegramOperationSpec, } from './telegram-operations';
 export { TELEGRAM_TOOLKIT_SPECS, TELEGRAM_TOOLKIT_BY_TOOL_NAME, } from './telegram-toolkit';

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.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.isDriveOperation = 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.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = void 0;
+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.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;
 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; } });
@@ -41,7 +41,11 @@ Object.defineProperty(exports, "GOOGLE_CALENDAR_OPERATIONS", { enumerable: true,
 Object.defineProperty(exports, "isGoogleCalendarOperation", { enumerable: true, get: function () { return calendar_operations_1.isGoogleCalendarOperation; } });
 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; } });
 Object.defineProperty(exports, "isDriveOperation", { enumerable: true, get: function () { return drive_operations_1.isDriveOperation; } });
+var drive_toolkit_1 = require("./drive-toolkit");
+Object.defineProperty(exports, "DRIVE_TOOLKIT_SPECS", { enumerable: true, get: function () { return drive_toolkit_1.DRIVE_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "DRIVE_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return drive_toolkit_1.DRIVE_TOOLKIT_BY_TOOL_NAME; } });
 var telegram_operations_1 = require("./telegram-operations");
 Object.defineProperty(exports, "TELEGRAM_OPERATIONS", { enumerable: true, get: function () { return telegram_operations_1.TELEGRAM_OPERATIONS; } });
 Object.defineProperty(exports, "TELEGRAM_OPERATION_SPECS", { enumerable: true, get: function () { return telegram_operations_1.TELEGRAM_OPERATION_SPECS; } });

package/package.json

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