@n8n/telemetry 1.3.0 → 1.4.0

package/dist/telemetry-events.d.ts

@@ -823,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";
@@ -962,6 +962,8 @@ export declare const TELEMETRY_EVENT: {
                     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;
@@ -992,8 +994,25 @@ export declare const TELEMETRY_EVENT: {
         } & 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.";
@@ -1010,5 +1029,179 @@ export declare const TELEMETRY_EVENT: {
         } & 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

@@ -5,6 +5,7 @@ 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,
@@ -12,5 +13,6 @@ exports.TELEMETRY_EVENT = {
     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,sDAA6D;AAC7D,gDAAuD;AACvD,sDAA6D;AAC7D,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;CACD,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,6 +1,6 @@
 {
   "name": "@n8n/telemetry",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "main": "dist/index.js",
   "module": "src/index.ts",
   "types": "dist/index.d.ts",
@@ -20,8 +20,8 @@
     "vite": "^8.0.2",
     "vitest": "^4.1.9",
     "@n8n/eslint-config": "0.0.1",
-    "@n8n/typescript-config": "1.9.0",
-    "@n8n/vitest-config": "1.20.0"
+    "@n8n/typescript-config": "1.10.0",
+    "@n8n/vitest-config": "1.21.0"
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://n8n.io",