@n8n/telemetry 1.2.1 → 1.4.0

package/dist/events/instance.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSTANCE_TELEMETRY = void 0;
+const v4_1 = require("zod/v4");
+const define_1 = require("../define");
+exports.INSTANCE_TELEMETRY = (0, define_1.defineTelemetryEvents)({
+    INSTANCE_STARTED: {
+        name: 'Instance started',
+        description: 'Instance finished booting, reported once per main process start with a snapshot of its configuration.',
+        properties: v4_1.z.object({
+            version_cli: v4_1.z.string(),
+            db_type: v4_1.z.enum(['sqlite', 'postgresdb']),
+            db_version: v4_1.z
+                .string()
+                .nullable()
+                .describe('Postgres server version, or SQLite library version. Null when it could not be determined, which for `postgresdb` means the query failed rather than that the instance runs SQLite.'),
+            n8n_version_notifications_enabled: v4_1.z.boolean(),
+            n8n_disable_production_main_process: v4_1.z.boolean(),
+            system_info: v4_1.z.object({
+                os: v4_1.z.object({
+                    type: v4_1.z.string(),
+                    version: v4_1.z.string(),
+                }),
+                memory: v4_1.z.number().describe('Total system memory in KiB'),
+                cpus: v4_1.z.object({
+                    count: v4_1.z.number(),
+                    model: v4_1.z.string(),
+                    speed: v4_1.z.number().describe('Clock speed in MHz'),
+                }),
+                is_docker: v4_1.z.boolean(),
+            }),
+            execution_variables: v4_1.z.object({
+                executions_mode: v4_1.z.enum(['regular', 'queue']),
+                executions_timeout: v4_1.z.number().describe('Seconds, -1 for unlimited'),
+                executions_timeout_max: v4_1.z.number().describe('Seconds'),
+                executions_data_save_on_error: v4_1.z.enum(['all', 'none']),
+                executions_data_save_on_success: v4_1.z.enum(['all', 'none']),
+                executions_data_save_on_progress: v4_1.z.boolean(),
+                executions_data_save_manual_executions: v4_1.z.boolean(),
+                executions_data_prune: v4_1.z.boolean(),
+                executions_data_max_age: v4_1.z.number().describe('Hours'),
+            }),
+            workflow_history: v4_1.z.object({
+                compaction_optimizing_time_window_hours: v4_1.z.number(),
+                compaction_trim_on_start_up: v4_1.z.boolean(),
+                compaction_trimming_time_window_days: v4_1.z.number(),
+            }),
+            n8n_deployment_type: v4_1.z.string(),
+            n8n_binary_data_mode: v4_1.z.enum(['default', 'filesystem', 's3', 'azure', 'database']),
+            smtp_set_up: v4_1.z.boolean(),
+            ldap_allowed: v4_1.z.boolean(),
+            saml_enabled: v4_1.z.boolean(),
+            license_plan_name: v4_1.z.string(),
+            license_tenant_id: v4_1.z.number(),
+            binary_data_s3: v4_1.z
+                .boolean()
+                .describe('S3 binary data is selected, available and licensed, all three'),
+            multi_main_setup_enabled: v4_1.z.boolean(),
+            instance_ai: v4_1.z
+                .object({
+                sandbox_enabled: v4_1.z.boolean(),
+                sandbox_provider: v4_1.z.string(),
+                search_brave_set: v4_1.z.boolean(),
+                search_searxng_set: v4_1.z.boolean(),
+                model_env_set: v4_1.z
+                    .boolean()
+                    .describe('Model connection env vars are set (API key or base URL). UI-credential model state is on the "AI Assistant setup completed" and "User viewed AI Assistant setup page" events instead'),
+                model_id: v4_1.z
+                    .string()
+                    .describe("Configured model identifier incl. provider, e.g. 'anthropic/claude-sonnet-4'"),
+            })
+                .describe('Which model, sandbox and search providers are configured via env vars, never key values'),
+            metrics: v4_1.z.object({
+                metrics_enabled: v4_1.z.boolean(),
+                metrics_category_default: v4_1.z.boolean(),
+                metrics_category_routes: v4_1.z.boolean(),
+                metrics_category_cache: v4_1.z.boolean(),
+                metrics_category_logs: v4_1.z.boolean(),
+                metrics_category_queue: v4_1.z.boolean(),
+                metrics_category_execution_data: v4_1.z.boolean(),
+                metrics_category_webhooks: v4_1.z.boolean(),
+                metrics_category_forms: v4_1.z.boolean(),
+                metrics_category_workflow_info: v4_1.z.boolean(),
+            }),
+            earliest_workflow_created: v4_1.z
+                .unknown()
+                .describe('Date of the oldest workflow, absent when the instance has none'),
+            otel: v4_1.z.object({
+                enabled: v4_1.z.boolean(),
+                include_node_spans: v4_1.z.boolean(),
+            }),
+            settings_managed_by_env_vars: v4_1.z.object({
+                owner_managed_by_env: v4_1.z.boolean(),
+                sso_managed_by_env: v4_1.z.boolean(),
+                security_policy_managed_by_env: v4_1.z.boolean(),
+                log_streaming_managed_by_env: v4_1.z.boolean(),
+                mcp_managed_by_env: v4_1.z.boolean(),
+                community_packages_managed_by_env: v4_1.z.boolean(),
+            }),
+        }),
+    },
+    INSTANCE_REFUSED_DURABLE_POLLERS: {
+        name: 'Instance refused durable pollers',
+        description: 'Boot scan found active workflows whose published version has duplicate or missing trigger node ids. Durable poll cursors and durable-scheduler poll triggers were disabled instance-wide and the offending workflows poller_state rows were deleted.',
+        properties: v4_1.z.object({
+            workflow_ids: v4_1.z
+                .array(v4_1.z.string())
+                .describe('Active workflows whose published version failed the trigger node id check'),
+            deleted_cursor_rows: v4_1.z
+                .number()
+                .describe('How many poller_state rows of the offending workflows were deleted'),
+        }),
+    },
+});
+//# sourceMappingURL=instance.js.map

package/dist/events/instance.js.map

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

package/dist/events/mcp.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod/v4';
+export declare const MCP_TELEMETRY: {
+    readonly USER_GAVE_MCP_ACCESS_TO_WORKFLOW: {
+        readonly name: "User gave MCP access to workflow";
+        readonly description: "A workflow was exposed over MCP.";
+        readonly properties: z.ZodObject<{
+            workflow_id: z.ZodString;
+        }, z.core.$strip>;
+    } & import("../define").TelemetryEventInput & {
+        readonly getValidationError: (properties: unknown) => string | null;
+    };
+    readonly USER_TOGGLED_MCP_ACCESS: {
+        readonly name: "User toggled MCP access";
+        readonly description: "An admin turned instance-level MCP access on or off. Reports the resulting state.";
+        readonly properties: z.ZodObject<{
+            state: z.ZodBoolean;
+        }, z.core.$strip>;
+    } & import("../define").TelemetryEventInput & {
+        readonly getValidationError: (properties: unknown) => string | null;
+    };
+    readonly AUTO_EXPOSE_NEW_WORKFLOWS_TOGGLED: {
+        readonly name: "User toggled auto-expose new workflows to MCP";
+        readonly description: "An admin turned the \"Auto-expose new workflows\" MCP setting on or off. Reports the resulting state so enabling and disabling are distinguishable.";
+        readonly properties: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            source: z.ZodEnum<{
+                expose_all: "expose_all";
+                settings: "settings";
+            }>;
+        }, z.core.$strip>;
+    } & import("../define").TelemetryEventInput & {
+        readonly getValidationError: (properties: unknown) => string | null;
+    };
+};

package/dist/events/mcp.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_TELEMETRY = void 0;
+const v4_1 = require("zod/v4");
+const define_1 = require("../define");
+exports.MCP_TELEMETRY = (0, define_1.defineTelemetryEvents)({
+    USER_GAVE_MCP_ACCESS_TO_WORKFLOW: {
+        name: 'User gave MCP access to workflow',
+        description: 'A workflow was exposed over MCP.',
+        properties: v4_1.z.object({
+            workflow_id: v4_1.z.string(),
+        }),
+    },
+    USER_TOGGLED_MCP_ACCESS: {
+        name: 'User toggled MCP access',
+        description: 'An admin turned instance-level MCP access on or off. Reports the resulting state.',
+        properties: v4_1.z.object({
+            state: v4_1.z.boolean().describe('Resulting state of MCP access, not the prior one'),
+        }),
+    },
+    AUTO_EXPOSE_NEW_WORKFLOWS_TOGGLED: {
+        name: 'User toggled auto-expose new workflows to MCP',
+        description: 'An admin turned the "Auto-expose new workflows" MCP setting on or off. Reports the resulting state so enabling and disabling are distinguishable.',
+        properties: v4_1.z.object({
+            enabled: v4_1.z.boolean().describe('Resulting state of the setting, not the prior one'),
+            source: v4_1.z
+                .enum(['settings', 'expose_all'])
+                .describe('Where the toggle came from: "settings" for the manual MCP settings switch, "expose_all" when enabled automatically as part of exposing all workflows'),
+        }),
+    },
+});
+//# sourceMappingURL=mcp.js.map

package/dist/events/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/events/mcp.ts"],"names":[],"mappings":";;;AAAA,+BAA2B;AAE3B,sCAAkD;AAErC,QAAA,aAAa,GAAG,IAAA,8BAAqB,EAAC;IAClD,gCAAgC,EAAE;QACjC,IAAI,EAAE,kCAAkC;QACxC,WAAW,EAAE,kCAAkC;QAC/C,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,MAAC,CAAC,MAAM,EAAE;SACvB,CAAC;KACF;IACD,uBAAuB,EAAE;QACxB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACV,mFAAmF;QACpF,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,MAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;SAC/E,CAAC;KACF;IACD,iCAAiC,EAAE;QAClC,IAAI,EAAE,+CAA+C;QACrD,WAAW,EACV,mJAAmJ;QACpJ,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,MAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;YAClF,MAAM,EAAE,MAAC;iBACP,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;iBAChC,QAAQ,CACR,sJAAsJ,CACtJ;SACF,CAAC;KACF;CACD,CAAC,CAAC"}

package/dist/telemetry-events.d.ts

@@ -753,6 +753,22 @@ export declare const TELEMETRY_EVENT: {
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
         };
+        readonly USER_ADDED_AGENT_NODE: {
+            readonly name: "User added agent node";
+            readonly description: "The user added a Message an Agent node to the workflow canvas. agent_source distinguishes the inline agent variant from calling an existing agent.";
+            readonly properties: import("zod/v4").ZodObject<{
+                agent_source: import("zod/v4").ZodOptional<import("zod/v4").ZodEnum<{
+                    inline: "inline";
+                    referenced: "referenced";
+                }>>;
+                agent_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                workflow_id: import("zod/v4").ZodString;
+                node_id: import("zod/v4").ZodString;
+                node_version: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         readonly USER_OPENED_AGENT_TOOL: {
             readonly name: "User opened agent tool";
             readonly description: "The user opened a tool from the builder capabilities list.";
@@ -807,7 +823,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly USER_STARTED_ADDING_AGENT_TOOL: {
             readonly name: "User started adding agent tool";
-            readonly description: "The user clicked Connect on an available row in the tools modal, starting a new tool flow.";
+            readonly description: "The user started adding an available tool manually by connecting it or creating a workflow.";
             readonly properties: import("zod/v4").ZodObject<{
                 tool_type: import("zod/v4").ZodEnum<{
                     custom: "custom";
@@ -858,4 +874,334 @@ export declare const TELEMETRY_EVENT: {
             readonly getValidationError: (properties: unknown) => string | null;
         };
     };
+    CREDENTIALS: {
+        readonly USER_PROBED_CREDENTIAL: {
+            readonly name: "User probed credential";
+            readonly description: "A stored credential was auth-probed against its own persisted test URL (POST /credentials/:id/probe) — the test path for generic credential types that declare no test, currently Simplified Custom Auth. Fires once per probe, including retries. The outcome is the probe's three-state verdict; joins to 'User created credentials' on credential_id.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodString;
+                credential_id: import("zod/v4").ZodString;
+                outcome: import("zod/v4").ZodEnum<{
+                    accepted: "accepted";
+                    rejected: "rejected";
+                    unverified: "unverified";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
+    INSTANCE: {
+        readonly INSTANCE_STARTED: {
+            readonly name: "Instance started";
+            readonly description: "Instance finished booting, reported once per main process start with a snapshot of its configuration.";
+            readonly properties: import("zod/v4").ZodObject<{
+                version_cli: import("zod/v4").ZodString;
+                db_type: import("zod/v4").ZodEnum<{
+                    postgresdb: "postgresdb";
+                    sqlite: "sqlite";
+                }>;
+                db_version: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                n8n_version_notifications_enabled: import("zod/v4").ZodBoolean;
+                n8n_disable_production_main_process: import("zod/v4").ZodBoolean;
+                system_info: import("zod/v4").ZodObject<{
+                    os: import("zod/v4").ZodObject<{
+                        type: import("zod/v4").ZodString;
+                        version: import("zod/v4").ZodString;
+                    }, import("zod/v4/core").$strip>;
+                    memory: import("zod/v4").ZodNumber;
+                    cpus: import("zod/v4").ZodObject<{
+                        count: import("zod/v4").ZodNumber;
+                        model: import("zod/v4").ZodString;
+                        speed: import("zod/v4").ZodNumber;
+                    }, import("zod/v4/core").$strip>;
+                    is_docker: import("zod/v4").ZodBoolean;
+                }, import("zod/v4/core").$strip>;
+                execution_variables: import("zod/v4").ZodObject<{
+                    executions_mode: import("zod/v4").ZodEnum<{
+                        queue: "queue";
+                        regular: "regular";
+                    }>;
+                    executions_timeout: import("zod/v4").ZodNumber;
+                    executions_timeout_max: import("zod/v4").ZodNumber;
+                    executions_data_save_on_error: import("zod/v4").ZodEnum<{
+                        all: "all";
+                        none: "none";
+                    }>;
+                    executions_data_save_on_success: import("zod/v4").ZodEnum<{
+                        all: "all";
+                        none: "none";
+                    }>;
+                    executions_data_save_on_progress: import("zod/v4").ZodBoolean;
+                    executions_data_save_manual_executions: import("zod/v4").ZodBoolean;
+                    executions_data_prune: import("zod/v4").ZodBoolean;
+                    executions_data_max_age: import("zod/v4").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                workflow_history: import("zod/v4").ZodObject<{
+                    compaction_optimizing_time_window_hours: import("zod/v4").ZodNumber;
+                    compaction_trim_on_start_up: import("zod/v4").ZodBoolean;
+                    compaction_trimming_time_window_days: import("zod/v4").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                n8n_deployment_type: import("zod/v4").ZodString;
+                n8n_binary_data_mode: import("zod/v4").ZodEnum<{
+                    azure: "azure";
+                    database: "database";
+                    default: "default";
+                    filesystem: "filesystem";
+                    s3: "s3";
+                }>;
+                smtp_set_up: import("zod/v4").ZodBoolean;
+                ldap_allowed: import("zod/v4").ZodBoolean;
+                saml_enabled: import("zod/v4").ZodBoolean;
+                license_plan_name: import("zod/v4").ZodString;
+                license_tenant_id: import("zod/v4").ZodNumber;
+                binary_data_s3: import("zod/v4").ZodBoolean;
+                multi_main_setup_enabled: import("zod/v4").ZodBoolean;
+                instance_ai: import("zod/v4").ZodObject<{
+                    sandbox_enabled: import("zod/v4").ZodBoolean;
+                    sandbox_provider: import("zod/v4").ZodString;
+                    search_brave_set: import("zod/v4").ZodBoolean;
+                    search_searxng_set: import("zod/v4").ZodBoolean;
+                    model_env_set: import("zod/v4").ZodBoolean;
+                    model_id: import("zod/v4").ZodString;
+                }, import("zod/v4/core").$strip>;
+                metrics: import("zod/v4").ZodObject<{
+                    metrics_enabled: import("zod/v4").ZodBoolean;
+                    metrics_category_default: import("zod/v4").ZodBoolean;
+                    metrics_category_routes: import("zod/v4").ZodBoolean;
+                    metrics_category_cache: import("zod/v4").ZodBoolean;
+                    metrics_category_logs: import("zod/v4").ZodBoolean;
+                    metrics_category_queue: import("zod/v4").ZodBoolean;
+                    metrics_category_execution_data: import("zod/v4").ZodBoolean;
+                    metrics_category_webhooks: import("zod/v4").ZodBoolean;
+                    metrics_category_forms: import("zod/v4").ZodBoolean;
+                    metrics_category_workflow_info: import("zod/v4").ZodBoolean;
+                }, import("zod/v4/core").$strip>;
+                earliest_workflow_created: import("zod/v4").ZodUnknown;
+                otel: import("zod/v4").ZodObject<{
+                    enabled: import("zod/v4").ZodBoolean;
+                    include_node_spans: import("zod/v4").ZodBoolean;
+                }, import("zod/v4/core").$strip>;
+                settings_managed_by_env_vars: import("zod/v4").ZodObject<{
+                    owner_managed_by_env: import("zod/v4").ZodBoolean;
+                    sso_managed_by_env: import("zod/v4").ZodBoolean;
+                    security_policy_managed_by_env: import("zod/v4").ZodBoolean;
+                    log_streaming_managed_by_env: import("zod/v4").ZodBoolean;
+                    mcp_managed_by_env: import("zod/v4").ZodBoolean;
+                    community_packages_managed_by_env: import("zod/v4").ZodBoolean;
+                }, import("zod/v4/core").$strip>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly INSTANCE_REFUSED_DURABLE_POLLERS: {
+            readonly name: "Instance refused durable pollers";
+            readonly description: "Boot scan found active workflows whose published version has duplicate or missing trigger node ids. Durable poll cursors and durable-scheduler poll triggers were disabled instance-wide and the offending workflows poller_state rows were deleted.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_ids: import("zod/v4").ZodArray<import("zod/v4").ZodString>;
+                deleted_cursor_rows: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
+    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 properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly BUILDER_SPECCED_TEMPLATED_CRED: {
+            readonly name: "Builder specced templated cred";
+            readonly description: "The Instance AI workflow builder composed a Simplified Custom Auth recipe (credentialHints) and suspended to show its setup card. Captures the recipe fields so template and link quality are observable in production — one event per recipe in the suspension. Contains no secrets by construction: recipes are agent-authored before any user input.";
+            readonly properties: import("zod/v4").ZodObject<{
+                thread_id: import("zod/v4").ZodString;
+                input_thread_id: import("zod/v4").ZodString;
+                template: import("zod/v4").ZodRecord<import("zod/v4").ZodString, import("zod/v4").ZodUnknown>;
+                placeholders: import("zod/v4").ZodArray<import("zod/v4").ZodRecord<import("zod/v4").ZodString, import("zod/v4").ZodUnknown>>;
+                test_url: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                docs_url: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                service_host: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                accepted_status_codes: import("zod/v4").ZodOptional<import("zod/v4").ZodArray<import("zod/v4").ZodNumber>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        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 properties: import("zod/v4").ZodObject<{
+                model_source: import("zod/v4").ZodEnum<{
+                    env: "env";
+                    none: "none";
+                    ui: "ui";
+                }>;
+                model_provider: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                model_name: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                sandbox_source: import("zod/v4").ZodEnum<{
+                    env: "env";
+                    none: "none";
+                    ui: "ui";
+                }>;
+                sandbox_type: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    daytona: "daytona";
+                    "n8n-sandbox": "n8n-sandbox";
+                }>>;
+                web_search_source: import("zod/v4").ZodEnum<{
+                    disabled: "disabled";
+                    env: "env";
+                    none: "none";
+                    ui: "ui";
+                }>;
+                web_search_provider: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    brave: "brave";
+                    searxng: "searxng";
+                }>>;
+                page: import("zod/v4").ZodEnum<{
+                    onboarding: "onboarding";
+                    settings: "settings";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        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 properties: import("zod/v4").ZodObject<{
+                provider: import("zod/v4").ZodString;
+                model: import("zod/v4").ZodString;
+                previous_provider: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                previous_model: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        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 properties: import("zod/v4").ZodObject<{
+                sandbox_type: import("zod/v4").ZodEnum<{
+                    daytona: "daytona";
+                    "n8n-sandbox": "n8n-sandbox";
+                }>;
+                previous_sandbox_type: import("zod/v4").ZodOptional<import("zod/v4").ZodEnum<{
+                    daytona: "daytona";
+                    "n8n-sandbox": "n8n-sandbox";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        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 properties: import("zod/v4").ZodObject<{
+                provider: import("zod/v4").ZodEnum<{
+                    brave: "brave";
+                    searxng: "searxng";
+                }>;
+                previous_provider: import("zod/v4").ZodOptional<import("zod/v4").ZodEnum<{
+                    brave: "brave";
+                    searxng: "searxng";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly AI_ASSISTANT_CONNECTION_FAILED: {
+            readonly name: "AI Assistant connection failed";
+            readonly description: "A setup verification call (POST /instance-ai/settings/verify/*) failed for a model, sandbox, or web search connection. One event covers all three components; the component property tells them apart. Fires once per failed verify attempt, including retries.";
+            readonly properties: import("zod/v4").ZodObject<{
+                component: import("zod/v4").ZodEnum<{
+                    model: "model";
+                    sandbox: "sandbox";
+                    web_search: "web_search";
+                }>;
+                provider: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                failure: import("zod/v4").ZodEnum<{
+                    forbidden: "forbidden";
+                    invalid_response: "invalid_response";
+                    provider_error: "provider_error";
+                    quota_exceeded: "quota_exceeded";
+                    rate_limited: "rate_limited";
+                    timeout: "timeout";
+                    unauthorized: "unauthorized";
+                    unreachable: "unreachable";
+                }>;
+                error_message: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        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 properties: import("zod/v4").ZodObject<{
+                model_source: import("zod/v4").ZodEnum<{
+                    env: "env";
+                    none: "none";
+                    ui: "ui";
+                }>;
+                model_provider: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                model_name: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                sandbox_source: import("zod/v4").ZodEnum<{
+                    env: "env";
+                    none: "none";
+                    ui: "ui";
+                }>;
+                sandbox_type: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    daytona: "daytona";
+                    "n8n-sandbox": "n8n-sandbox";
+                }>>;
+                web_search_source: import("zod/v4").ZodEnum<{
+                    disabled: "disabled";
+                    env: "env";
+                    none: "none";
+                    ui: "ui";
+                }>;
+                web_search_provider: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    brave: "brave";
+                    searxng: "searxng";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
+    MCP: {
+        readonly USER_GAVE_MCP_ACCESS_TO_WORKFLOW: {
+            readonly name: "User gave MCP access to workflow";
+            readonly description: "A workflow was exposed over MCP.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_TOGGLED_MCP_ACCESS: {
+            readonly name: "User toggled MCP access";
+            readonly description: "An admin turned instance-level MCP access on or off. Reports the resulting state.";
+            readonly properties: import("zod/v4").ZodObject<{
+                state: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly AUTO_EXPOSE_NEW_WORKFLOWS_TOGGLED: {
+            readonly name: "User toggled auto-expose new workflows to MCP";
+            readonly description: "An admin turned the \"Auto-expose new workflows\" MCP setting on or off. Reports the resulting state so enabling and disabling are distinguishable.";
+            readonly properties: import("zod/v4").ZodObject<{
+                enabled: import("zod/v4").ZodBoolean;
+                source: import("zod/v4").ZodEnum<{
+                    expose_all: "expose_all";
+                    settings: "settings";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
 };

package/dist/telemetry-events.js

@@ -2,9 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TELEMETRY_EVENT = void 0;
 const agents_1 = require("./events/agents");
+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 platform_1 = require("./events/platform");
 exports.TELEMETRY_EVENT = {
     PLATFORM: platform_1.PLATFORM_TELEMETRY,
     AGENTS: agents_1.AGENTS_TELEMETRY,
+    CREDENTIALS: credentials_1.CREDENTIALS_TELEMETRY,
+    INSTANCE: instance_1.INSTANCE_TELEMETRY,
+    INSTANCE_AI: instance_ai_1.INSTANCE_AI_TELEMETRY,
+    MCP: mcp_1.MCP_TELEMETRY,
 };
 //# sourceMappingURL=telemetry-events.js.map

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,gDAAuD;AAE1C,QAAA,eAAe,GAAG;IAC9B,QAAQ,EAAE,6BAAkB;IAC5B,MAAM,EAAE,yBAAgB;CACS,CAAC"}
+{"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;AAE1C,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;CACe,CAAC"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@n8n/telemetry",
-  "version": "1.2.1",
+  "version": "1.4.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": {
     "zod": "3.25.76"
@@ -19,9 +19,9 @@
     "typescript": "7.0.2",
     "vite": "^8.0.2",
     "vitest": "^4.1.9",
-    "@n8n/typescript-config": "1.9.0",
-    "@n8n/vitest-config": "1.19.0",
-    "@n8n/eslint-config": "0.0.1"
+    "@n8n/eslint-config": "0.0.1",
+    "@n8n/typescript-config": "1.10.0",
+    "@n8n/vitest-config": "1.21.0"
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://n8n.io",