@n8n/telemetry 1.7.0 → 1.8.0

package/dist/events/node-type-policies.d.ts

@@ -0,0 +1,93 @@
+import { z } from 'zod/v4';
+export declare const NODE_TYPE_POLICIES_TELEMETRY: {
+    readonly USER_SAVED_NODE_TYPE_POLICY: {
+        readonly name: "User saved node type policy";
+        readonly description: "A node type availability policy was saved for one scope through the composed write that the policy UI uses. One event per save, covering both the scope default action and its rules. Rule-level edits through the advanced document and attachment APIs report separately. The type counts and list report what this scope decides on its own, so at project scope they are the project layer before it composes with the instance policy.";
+        readonly properties: z.ZodObject<{
+            rule_count: z.ZodNumber;
+            allow_rule_count: z.ZodNumber;
+            deny_rule_count: z.ZodNumber;
+            delegate_rule_count: z.ZodNumber;
+            user_id: z.ZodOptional<z.ZodString>;
+            source: z.ZodEnum<{
+                environment: "environment";
+                user: "user";
+            }>;
+            scope: z.ZodEnum<{
+                instance: "instance";
+                project: "project";
+            }>;
+            project_id: z.ZodOptional<z.ZodString>;
+            default_action: z.ZodEnum<{
+                allow: "allow";
+                delegate: "delegate";
+                deny: "deny";
+            }>;
+            previous_default_action: z.ZodNullable<z.ZodEnum<{
+                allow: "allow";
+                delegate: "delegate";
+                deny: "deny";
+            }>>;
+            is_first_write: z.ZodBoolean;
+            name_selector_count: z.ZodNumber;
+            package_selector_count: z.ZodNumber;
+            evaluated_type_count: z.ZodNumber;
+            blocked_type_count: z.ZodNumber;
+            allowed_type_count: z.ZodNumber;
+            delegated_type_count: z.ZodNumber;
+            blocked_types: z.ZodArray<z.ZodString>;
+            allowed_types: z.ZodArray<z.ZodString>;
+            previous_rule_count: z.ZodNullable<z.ZodNumber>;
+            shadow_warning_count: z.ZodNumber;
+            version: z.ZodNumber;
+        }, z.core.$strip>;
+    } & import("../define").TelemetryEventInput & {
+        readonly getValidationError: (properties: unknown) => string | null;
+    };
+    readonly USER_UPDATED_NODE_TYPE_POLICY_DOCUMENT: {
+        readonly name: "User updated node type policy document";
+        readonly description: "A policy document was created, edited, or deleted through the advanced instance-only document API. The composed save that the policy UI uses reports as \"User saved node type policy\" instead. Rule counts describe the document after the operation, so a delete reports 0 and carries the deleted size in previous_rule_count.";
+        readonly properties: z.ZodObject<{
+            rule_count: z.ZodNumber;
+            allow_rule_count: z.ZodNumber;
+            deny_rule_count: z.ZodNumber;
+            delegate_rule_count: z.ZodNumber;
+            user_id: z.ZodOptional<z.ZodString>;
+            source: z.ZodEnum<{
+                environment: "environment";
+                user: "user";
+            }>;
+            operation: z.ZodEnum<{
+                created: "created";
+                deleted: "deleted";
+                updated: "updated";
+            }>;
+            policy_id: z.ZodString;
+            previous_rule_count: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+    } & import("../define").TelemetryEventInput & {
+        readonly getValidationError: (properties: unknown) => string | null;
+    };
+    readonly USER_UPDATED_NODE_TYPE_POLICY_ATTACHMENTS: {
+        readonly name: "User updated node type policy attachments";
+        readonly description: "The set of policy documents attached to one scope was replaced through the advanced instance-only attachment API. Reports the resulting set, not the individual add or remove.";
+        readonly properties: z.ZodObject<{
+            user_id: z.ZodOptional<z.ZodString>;
+            source: z.ZodEnum<{
+                environment: "environment";
+                user: "user";
+            }>;
+            scope: z.ZodEnum<{
+                instance: "instance";
+                project: "project";
+            }>;
+            project_id: z.ZodOptional<z.ZodString>;
+            scope_id: z.ZodString;
+            attachment_count: z.ZodNumber;
+            floor_attachment_count: z.ZodNumber;
+            previous_attachment_count: z.ZodNumber;
+        }, z.core.$strip>;
+    } & import("../define").TelemetryEventInput & {
+        readonly getValidationError: (properties: unknown) => string | null;
+    };
+};

package/dist/events/node-type-policies.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NODE_TYPE_POLICIES_TELEMETRY = void 0;
+const v4_1 = require("zod/v4");
+const define_1 = require("../define");
+const userId = v4_1.z.string().optional();
+const source = v4_1.z
+    .enum(['user', 'environment'])
+    .describe("'environment' is a bootstrap write from configuration, with no acting user");
+const scope = v4_1.z
+    .enum(['instance', 'project'])
+    .describe('Which scope the policy was written at; project policies compose under instance');
+const projectId = v4_1.z.string().optional().describe('Absent at instance scope');
+const ruleCounts = {
+    rule_count: v4_1.z.number(),
+    allow_rule_count: v4_1.z.number(),
+    deny_rule_count: v4_1.z.number(),
+    delegate_rule_count: v4_1.z
+        .number()
+        .describe('Always 0 at project scope, which rejects the delegate action'),
+};
+exports.NODE_TYPE_POLICIES_TELEMETRY = (0, define_1.defineTelemetryEvents)({
+    USER_SAVED_NODE_TYPE_POLICY: {
+        name: 'User saved node type policy',
+        description: 'A node type availability policy was saved for one scope through the composed write that the policy UI uses. One event per save, covering both the scope default action and its rules. Rule-level edits through the advanced document and attachment APIs report separately. The type counts and list report what this scope decides on its own, so at project scope they are the project layer before it composes with the instance policy.',
+        properties: v4_1.z.object({
+            user_id: userId,
+            source,
+            scope,
+            project_id: projectId,
+            default_action: v4_1.z
+                .enum(['allow', 'deny', 'delegate'])
+                .describe('What the scope decides for a type that no rule matches'),
+            previous_default_action: v4_1.z
+                .enum(['allow', 'deny', 'delegate'])
+                .nullable()
+                .describe('Null on the first write to this scope, which had no stored default'),
+            is_first_write: v4_1.z
+                .boolean()
+                .describe('Whether this write created the scope; an unwritten scope allows every type'),
+            ...ruleCounts,
+            name_selector_count: v4_1.z.number().describe('Rules that target one exact node type name'),
+            package_selector_count: v4_1.z.number().describe('Rules that target a whole node package'),
+            evaluated_type_count: v4_1.z
+                .number()
+                .describe('Node types this instance knows, and so the denominator for the counts below'),
+            blocked_type_count: v4_1.z.number(),
+            allowed_type_count: v4_1.z.number(),
+            delegated_type_count: v4_1.z
+                .number()
+                .describe('Types a project can opt into; always 0 at project scope'),
+            blocked_types: v4_1.z
+                .array(v4_1.z.string())
+                .describe('The node types this policy makes unavailable, capped at 100. Node type names, not user data. Compare the length against blocked_type_count to see whether the cap dropped any'),
+            allowed_types: v4_1.z
+                .array(v4_1.z.string())
+                .describe('The node types this policy leaves available, capped at 100 the same way'),
+            previous_rule_count: v4_1.z.number().nullable().describe('Null on the first write to this scope'),
+            shadow_warning_count: v4_1.z
+                .number()
+                .describe('Saved rules that can never match, because an earlier rule already covers them'),
+            version: v4_1.z.number().describe('The scope version after the write'),
+        }),
+    },
+    USER_UPDATED_NODE_TYPE_POLICY_DOCUMENT: {
+        name: 'User updated node type policy document',
+        description: 'A policy document was created, edited, or deleted through the advanced instance-only document API. The composed save that the policy UI uses reports as "User saved node type policy" instead. Rule counts describe the document after the operation, so a delete reports 0 and carries the deleted size in previous_rule_count.',
+        properties: v4_1.z.object({
+            user_id: userId,
+            source,
+            operation: v4_1.z.enum(['created', 'updated', 'deleted']),
+            policy_id: v4_1.z.string(),
+            ...ruleCounts,
+            previous_rule_count: v4_1.z.number().nullable().describe('Null on a created document'),
+        }),
+    },
+    USER_UPDATED_NODE_TYPE_POLICY_ATTACHMENTS: {
+        name: 'User updated node type policy attachments',
+        description: 'The set of policy documents attached to one scope was replaced through the advanced instance-only attachment API. Reports the resulting set, not the individual add or remove.',
+        properties: v4_1.z.object({
+            user_id: userId,
+            source,
+            scope,
+            project_id: projectId,
+            scope_id: v4_1.z.string(),
+            attachment_count: v4_1.z.number(),
+            floor_attachment_count: v4_1.z
+                .number()
+                .describe('Attachments that a narrower scope cannot override'),
+            previous_attachment_count: v4_1.z.number(),
+        }),
+    },
+});
+//# sourceMappingURL=node-type-policies.js.map

package/dist/events/node-type-policies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-type-policies.js","sourceRoot":"","sources":["../../src/events/node-type-policies.ts"],"names":[],"mappings":"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"}

package/dist/telemetry-events.d.ts

@@ -703,6 +703,7 @@ export declare const TELEMETRY_EVENT: {
                     dropdown: "dropdown";
                 }>;
                 agent_id: import("zod/v4").ZodString;
+                manual: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
                 session_id: import("zod/v4").ZodString;
             }, import("zod/v4/core").$strip>;
         } & import("./define").TelemetryEventInput & {
@@ -892,6 +893,57 @@ export declare const TELEMETRY_EVENT: {
             readonly getValidationError: (properties: unknown) => string | null;
         };
     };
+    CONTEXT: {
+        readonly USER_CREATED_PREFERENCE: {
+            readonly name: "User created preference";
+            readonly description: "A user saved a new preference from the Context settings area. Fires once the save succeeds, so opening the modal and cancelling reports nothing.";
+            readonly properties: import("zod/v4").ZodObject<{
+                scope_type: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>;
+                text_length: import("zod/v4").ZodNumber;
+                project_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_UPDATED_PREFERENCE: {
+            readonly name: "User updated preference";
+            readonly description: "A user saved an edit to an existing preference. Fires once the save succeeds. Reports the resulting scope, not the prior one; `scope_changed` tells them apart.";
+            readonly properties: import("zod/v4").ZodObject<{
+                scope_type: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>;
+                text_length: import("zod/v4").ZodNumber;
+                scope_changed: import("zod/v4").ZodBoolean;
+                project_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_DELETED_PREFERENCES: {
+            readonly name: "User deleted preferences";
+            readonly description: "A user deleted one or more preferences. One event covers a single row action and a bulk delete; `source` tells them apart and `count` carries how many went. Fires after the delete succeeds and the confirmation was accepted.";
+            readonly properties: import("zod/v4").ZodObject<{
+                count: import("zod/v4").ZodNumber;
+                source: import("zod/v4").ZodEnum<{
+                    bulk: "bulk";
+                    row: "row";
+                }>;
+                scope_types: import("zod/v4").ZodArray<import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
     INSTANCE: {
         readonly INSTANCE_STARTED: {
             readonly name: "Instance started";
@@ -999,7 +1051,7 @@ export declare const TELEMETRY_EVENT: {
     INSTANCE_AI: {
         readonly USER_CLICKED_AI_CREDIT_BALANCE: {
             readonly name: "User clicked AI credit balance";
-            readonly description: "The user clicked the AI Assistant credit balance button to open or close the balance dropdown.";
+            readonly description: "The user clicked the n8n Assistant credit balance button to open or close the balance dropdown.";
             readonly properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
@@ -1040,7 +1092,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly OPEN_BY_DEFAULT_NOTIFICATION_SHOWN: {
             readonly name: "Open in assistant notification shown";
-            readonly description: "The open-by-default experiment notification rendered after a workflow list card auto-opened in the AI Assistant.";
+            readonly description: "The open-by-default experiment notification rendered after a workflow list card auto-opened in the n8n Assistant.";
             readonly properties: import("zod/v4").ZodObject<{
                 workflow_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
                 variant: import("zod/v4").ZodEnum<{
@@ -1079,7 +1131,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly DEFAULT_EDITOR_PREFERENCE_CHANGED: {
             readonly name: "Default editor preference changed";
-            readonly description: "The user saved the default-editor preference on the AI Assistant settings page.";
+            readonly description: "The user saved the default-editor preference on the n8n Assistant settings page.";
             readonly properties: import("zod/v4").ZodObject<{
                 value: import("zod/v4").ZodEnum<{
                     assistant: "assistant";
@@ -1117,14 +1169,14 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly USER_CLICKED_AI_ASSISTANT_INPUT_PLUS_BUTTON: {
             readonly name: "User clicked AI Assistant input plus button";
-            readonly description: "The user clicked the plus button in the AI Assistant input.";
+            readonly description: "The user clicked the plus button in the n8n Assistant input.";
             readonly properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
         };
         readonly TOOLS_LIST_OPENED: {
             readonly name: "Instance AI tools list opened";
-            readonly description: "The user opened the AI Assistant tools connection modal.";
+            readonly description: "The user opened the n8n Assistant tools connection modal.";
             readonly properties: import("zod/v4").ZodObject<{
                 source: import("zod/v4").ZodEnum<{
                     input_menu: "input_menu";
@@ -1136,7 +1188,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly MCP_SETTINGS_OPENED: {
             readonly name: "Instance AI mcp settings opened";
-            readonly description: "The user opened settings for an MCP connection in the AI Assistant.";
+            readonly description: "The user opened settings for an MCP connection in the n8n Assistant.";
             readonly properties: import("zod/v4").ZodObject<{
                 server_slug: import("zod/v4").ZodString;
                 source: import("zod/v4").ZodEnum<{
@@ -1227,7 +1279,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly BROWSER_USE_DIRECT_CONNECT_REQUESTED: {
             readonly name: "Instance AI Browser Use direct connect requested";
-            readonly description: "The AI Assistant requested a direct connection through the Browser Use extension.";
+            readonly description: "The n8n Assistant requested a direct connection through the Browser Use extension.";
             readonly properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
@@ -1276,7 +1328,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly USER_VIEWED_AI_ASSISTANT_SETUP_PAGE: {
             readonly name: "User viewed AI Assistant setup page";
-            readonly description: "The user landed on a self-hosted AI Assistant setup surface: the onboarding takeover on /assistant, or the settings page on /settings/assistant. Carries the configuration snapshot at view time, so joined with \"AI Assistant setup completed\" it measures setup drop-off. Not emitted on cloud or proxy deployments, where setup is managed.";
+            readonly description: "The user landed on a self-hosted n8n Assistant setup surface: the onboarding takeover on /assistant, or the settings page on /settings/assistant. Carries the configuration snapshot at view time, so joined with \"AI Assistant setup completed\" it measures setup drop-off. Not emitted on cloud or proxy deployments, where setup is managed.";
             readonly properties: import("zod/v4").ZodObject<{
                 model_source: import("zod/v4").ZodEnum<{
                     env: "env";
@@ -1314,7 +1366,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly USER_CONFIGURED_AI_ASSISTANT_MODEL: {
             readonly name: "User configured AI Assistant model";
-            readonly description: "An admin saved an AI Assistant model connection (PUT /instance-ai/settings), covering the first connect, later changes, and same-provider key rotations: first connects are rows where previous_provider is absent. The event marks a saved configuration, not a verified one — the setup wizard verifies before saving, but a direct API save can skip verification. Env-var model config never emits this; it is visible on \"Instance started\" and on the snapshot events instead.";
+            readonly description: "An admin saved an n8n Assistant model connection (PUT /instance-ai/settings), covering the first connect, later changes, and same-provider key rotations: first connects are rows where previous_provider is absent. The event marks a saved configuration, not a verified one — the setup wizard verifies before saving, but a direct API save can skip verification. Env-var model config never emits this; it is visible on \"Instance started\" and on the snapshot events instead.";
             readonly properties: import("zod/v4").ZodObject<{
                 provider: import("zod/v4").ZodString;
                 model: import("zod/v4").ZodString;
@@ -1326,7 +1378,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly USER_CONFIGURED_AI_ASSISTANT_SANDBOX: {
             readonly name: "User configured AI Assistant sandbox";
-            readonly description: "An admin saved an AI Assistant sandbox connection (PUT /instance-ai/settings), covering the first connect, later changes, and same-provider key rotations: first connects are rows where previous_sandbox_type is absent. Env-var sandbox config never emits this.";
+            readonly description: "An admin saved an n8n Assistant sandbox connection (PUT /instance-ai/settings), covering the first connect, later changes, and same-provider key rotations: first connects are rows where previous_sandbox_type is absent. Env-var sandbox config never emits this.";
             readonly properties: import("zod/v4").ZodObject<{
                 sandbox_type: import("zod/v4").ZodEnum<{
                     daytona: "daytona";
@@ -1342,7 +1394,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly USER_CONFIGURED_AI_ASSISTANT_WEB_SEARCH: {
             readonly name: "User configured AI Assistant web search";
-            readonly description: "An admin saved an AI Assistant web search connection (PUT /instance-ai/settings), covering the first connect, later changes, and same-provider key rotations: first connects are rows where previous_provider is absent. Explicitly disabling web search does not emit this; that decision is visible as web_search_source \"disabled\" on the snapshot events.";
+            readonly description: "An admin saved an n8n Assistant web search connection (PUT /instance-ai/settings), covering the first connect, later changes, and same-provider key rotations: first connects are rows where previous_provider is absent. Explicitly disabling web search does not emit this; that decision is visible as web_search_source \"disabled\" on the snapshot events.";
             readonly properties: import("zod/v4").ZodObject<{
                 provider: import("zod/v4").ZodEnum<{
                     brave: "brave";
@@ -1383,7 +1435,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly AI_ASSISTANT_SETUP_COMPLETED: {
             readonly name: "AI Assistant setup completed";
-            readonly description: "A self-hosted instance reached a complete AI Assistant setup for the first time: model configured, sandbox configured, and web search decided (configured or explicitly disabled) — the same predicate that unlocks the assistant UI. Fires at most once per instance, guarded by a persisted settings key, regardless of how the last piece was set: emitted from the settings save path, with a boot-time check so an env-var finish is also counted. No \"User\" prefix because the last piece can land via env vars with no acting user.";
+            readonly description: "A self-hosted instance reached a complete n8n Assistant setup for the first time: model configured, sandbox configured, and web search decided (configured or explicitly disabled) — the same predicate that unlocks the assistant UI. Fires at most once per instance, guarded by a persisted settings key, regardless of how the last piece was set: emitted from the settings save path, with a boot-time check so an env-var finish is also counted. No \"User\" prefix because the last piece can land via env vars with no acting user.";
             readonly properties: import("zod/v4").ZodObject<{
                 model_source: import("zod/v4").ZodEnum<{
                     env: "env";
@@ -1474,6 +1526,81 @@ export declare const TELEMETRY_EVENT: {
         };
     };
     MCP: {
+        readonly MCP_NUDGE_VIEWED: {
+            readonly name: "User viewed MCP nudge";
+            readonly description: "The MCP nudge modal opened after the user exported a workflow as JSON, imported one from a file or URL, copied nodes, or pasted workflow JSON onto the canvas. Fires only when the modal opens, so a trigger that the flag, the two-impression cap, an opt-out, or instance-level MCP access suppresses emits nothing. Each fire consumes one impression.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    copy: "copy";
+                    export: "export";
+                    import_file: "import_file";
+                    import_url: "import_url";
+                    paste: "paste";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_NUDGE_CONNECT_CLICKED: {
+            readonly name: "User clicked connect in MCP nudge";
+            readonly description: "The user clicked \"Connect n8n\" in the MCP nudge. The app navigates to the MCP settings page and abandons the export or import that opened the nudge. Kept separate from the skip and dismiss events so the connect-to-export click ratio stays computable.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    copy: "copy";
+                    export: "export";
+                    import_file: "import_file";
+                    import_url: "import_url";
+                    paste: "paste";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_NUDGE_SKIPPED: {
+            readonly name: "User skipped MCP nudge";
+            readonly description: "The user clicked \"Skip\" in the MCP nudge. The export or import that opened the nudge completes unchanged. Closing with × or Escape is \"User dismissed MCP nudge\" instead.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    copy: "copy";
+                    export: "export";
+                    import_file: "import_file";
+                    import_url: "import_url";
+                    paste: "paste";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_NUDGE_DISMISSED: {
+            readonly name: "User dismissed MCP nudge";
+            readonly description: "The user closed the MCP nudge with × or Escape without choosing an action. The export or import that opened the nudge completes unchanged.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    copy: "copy";
+                    export: "export";
+                    import_file: "import_file";
+                    import_url: "import_url";
+                    paste: "paste";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_NUDGE_OPTED_OUT: {
+            readonly name: "User opted out of MCP nudge";
+            readonly description: "The user checked \"Don't show this again\" in the MCP nudge. Fires when the checkbox is checked, independent of which button later closes the modal. The nudge never shows again for this user.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    copy: "copy";
+                    export: "export";
+                    import_file: "import_file";
+                    import_url: "import_url";
+                    paste: "paste";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         readonly USER_GAVE_MCP_ACCESS_TO_WORKFLOW: {
             readonly name: "User gave MCP access to workflow";
             readonly description: "A workflow was exposed over MCP.";
@@ -1546,6 +1673,98 @@ export declare const TELEMETRY_EVENT: {
             readonly getValidationError: (properties: unknown) => string | null;
         };
     };
+    NODE_TYPE_POLICIES: {
+        readonly USER_SAVED_NODE_TYPE_POLICY: {
+            readonly name: "User saved node type policy";
+            readonly description: "A node type availability policy was saved for one scope through the composed write that the policy UI uses. One event per save, covering both the scope default action and its rules. Rule-level edits through the advanced document and attachment APIs report separately. The type counts and list report what this scope decides on its own, so at project scope they are the project layer before it composes with the instance policy.";
+            readonly properties: import("zod/v4").ZodObject<{
+                rule_count: import("zod/v4").ZodNumber;
+                allow_rule_count: import("zod/v4").ZodNumber;
+                deny_rule_count: import("zod/v4").ZodNumber;
+                delegate_rule_count: import("zod/v4").ZodNumber;
+                user_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                source: import("zod/v4").ZodEnum<{
+                    environment: "environment";
+                    user: "user";
+                }>;
+                scope: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                }>;
+                project_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                default_action: import("zod/v4").ZodEnum<{
+                    allow: "allow";
+                    delegate: "delegate";
+                    deny: "deny";
+                }>;
+                previous_default_action: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    allow: "allow";
+                    delegate: "delegate";
+                    deny: "deny";
+                }>>;
+                is_first_write: import("zod/v4").ZodBoolean;
+                name_selector_count: import("zod/v4").ZodNumber;
+                package_selector_count: import("zod/v4").ZodNumber;
+                evaluated_type_count: import("zod/v4").ZodNumber;
+                blocked_type_count: import("zod/v4").ZodNumber;
+                allowed_type_count: import("zod/v4").ZodNumber;
+                delegated_type_count: import("zod/v4").ZodNumber;
+                blocked_types: import("zod/v4").ZodArray<import("zod/v4").ZodString>;
+                allowed_types: import("zod/v4").ZodArray<import("zod/v4").ZodString>;
+                previous_rule_count: import("zod/v4").ZodNullable<import("zod/v4").ZodNumber>;
+                shadow_warning_count: import("zod/v4").ZodNumber;
+                version: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_UPDATED_NODE_TYPE_POLICY_DOCUMENT: {
+            readonly name: "User updated node type policy document";
+            readonly description: "A policy document was created, edited, or deleted through the advanced instance-only document API. The composed save that the policy UI uses reports as \"User saved node type policy\" instead. Rule counts describe the document after the operation, so a delete reports 0 and carries the deleted size in previous_rule_count.";
+            readonly properties: import("zod/v4").ZodObject<{
+                rule_count: import("zod/v4").ZodNumber;
+                allow_rule_count: import("zod/v4").ZodNumber;
+                deny_rule_count: import("zod/v4").ZodNumber;
+                delegate_rule_count: import("zod/v4").ZodNumber;
+                user_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                source: import("zod/v4").ZodEnum<{
+                    environment: "environment";
+                    user: "user";
+                }>;
+                operation: import("zod/v4").ZodEnum<{
+                    created: "created";
+                    deleted: "deleted";
+                    updated: "updated";
+                }>;
+                policy_id: import("zod/v4").ZodString;
+                previous_rule_count: import("zod/v4").ZodNullable<import("zod/v4").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_UPDATED_NODE_TYPE_POLICY_ATTACHMENTS: {
+            readonly name: "User updated node type policy attachments";
+            readonly description: "The set of policy documents attached to one scope was replaced through the advanced instance-only attachment API. Reports the resulting set, not the individual add or remove.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                source: import("zod/v4").ZodEnum<{
+                    environment: "environment";
+                    user: "user";
+                }>;
+                scope: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                }>;
+                project_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                scope_id: import("zod/v4").ZodString;
+                attachment_count: import("zod/v4").ZodNumber;
+                floor_attachment_count: import("zod/v4").ZodNumber;
+                previous_attachment_count: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
     WORKFLOW: {
         readonly MULTIPLE_NODES_SELECTED: {
             readonly name: "User selected multiple nodes";

package/dist/telemetry-events.js

@@ -2,10 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TELEMETRY_EVENT = void 0;
 const agents_1 = require("./events/agents");
+const context_1 = require("./events/context");
 const credentials_1 = require("./events/credentials");
 const instance_1 = require("./events/instance");
 const instance_ai_1 = require("./events/instance-ai");
 const mcp_1 = require("./events/mcp");
+const node_type_policies_1 = require("./events/node-type-policies");
 const platform_1 = require("./events/platform");
 const workflow_1 = require("./events/workflow");
 const workflow_reviews_1 = require("./events/workflow-reviews");
@@ -13,9 +15,11 @@ exports.TELEMETRY_EVENT = {
     PLATFORM: platform_1.PLATFORM_TELEMETRY,
     AGENTS: agents_1.AGENTS_TELEMETRY,
     CREDENTIALS: credentials_1.CREDENTIALS_TELEMETRY,
+    CONTEXT: context_1.CONTEXT_TELEMETRY,
     INSTANCE: instance_1.INSTANCE_TELEMETRY,
     INSTANCE_AI: instance_ai_1.INSTANCE_AI_TELEMETRY,
     MCP: mcp_1.MCP_TELEMETRY,
+    NODE_TYPE_POLICIES: node_type_policies_1.NODE_TYPE_POLICIES_TELEMETRY,
     WORKFLOW: workflow_1.WORKFLOW_TELEMETRY,
     WORKFLOW_REVIEWS: workflow_reviews_1.WORKFLOW_REVIEWS_TELEMETRY,
 };

package/dist/telemetry-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-events.js","sourceRoot":"","sources":["../src/telemetry-events.ts"],"names":[],"mappings":";;;AACA,4CAAmD;AACnD,sDAA6D;AAC7D,gDAAuD;AACvD,sDAA6D;AAC7D,sCAA6C;AAC7C,gDAAuD;AACvD,gDAAuD;AACvD,gEAAuE;AAE1D,QAAA,eAAe,GAAG;IAC9B,QAAQ,EAAE,6BAAkB;IAC5B,MAAM,EAAE,yBAAgB;IACxB,WAAW,EAAE,mCAAqB;IAClC,QAAQ,EAAE,6BAAkB;IAC5B,WAAW,EAAE,mCAAqB;IAClC,GAAG,EAAE,mBAAa;IAClB,QAAQ,EAAE,6BAAkB;IAC5B,gBAAgB,EAAE,6CAA0B;CACX,CAAC"}
+{"version":3,"file":"telemetry-events.js","sourceRoot":"","sources":["../src/telemetry-events.ts"],"names":[],"mappings":";;;AACA,4CAAmD;AACnD,8CAAqD;AACrD,sDAA6D;AAC7D,gDAAuD;AACvD,sDAA6D;AAC7D,sCAA6C;AAC7C,oEAA2E;AAC3E,gDAAuD;AACvD,gDAAuD;AACvD,gEAAuE;AAE1D,QAAA,eAAe,GAAG;IAC9B,QAAQ,EAAE,6BAAkB;IAC5B,MAAM,EAAE,yBAAgB;IACxB,WAAW,EAAE,mCAAqB;IAClC,OAAO,EAAE,2BAAiB;IAC1B,QAAQ,EAAE,6BAAkB;IAC5B,WAAW,EAAE,mCAAqB;IAClC,GAAG,EAAE,mBAAa;IAClB,kBAAkB,EAAE,iDAA4B;IAChD,QAAQ,EAAE,6BAAkB;IAC5B,gBAAgB,EAAE,6CAA0B;CACX,CAAC"}

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@n8n/telemetry",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "main": "dist/index.js",
   "module": "src/index.ts",
   "types": "dist/index.d.ts",
   "files": [
     "dist/**/*",
-    "LICENSE_EE.md",
-    "LICENSE.md"
+    "LICENSE.md",
+    "LICENSE_EE.md"
   ],
   "dependencies": {
-    "@n8n/utils": "1.47.0",
+    "@n8n/utils": "1.48.0",
     "zod": "3.25.76"
   },
   "devDependencies": {
     "@n8n/eslint-config": "0.0.1",
-    "@n8n/typescript-config": "1.11.0",
-    "@n8n/vitest-config": "1.21.0",
+    "@n8n/typescript-config": "1.12.0",
+    "@n8n/vitest-config": "1.22.0",
     "@types/node": "24.10.1",
     "@vitest/coverage-v8": "4.1.9",
     "eslint": "9.29.0",