@n8n/telemetry 1.2.1 → 1.3.1

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.";
@@ -858,4 +874,284 @@ 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;
+        };
+    };
+    INSTANCE_AI: {
+        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;
+        };
+    };
 };

package/dist/telemetry-events.js

@@ -2,9 +2,15 @@
 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 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,
 };
 //# 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,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"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@n8n/telemetry",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "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/eslint-config": "0.0.1",
     "@n8n/typescript-config": "1.9.0",
-    "@n8n/vitest-config": "1.19.0",
-    "@n8n/eslint-config": "0.0.1"
+    "@n8n/vitest-config": "1.20.0"
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://n8n.io",