@n8n/telemetry 1.7.0 → 1.9.0

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 & {
@@ -876,6 +877,95 @@ export declare const TELEMETRY_EVENT: {
         };
     };
     CREDENTIALS: {
+        readonly USER_CREATED_CREDENTIALS: {
+            readonly name: "User created credentials";
+            readonly description: "A credential was created. The server sets source to backend and reports description metadata. Existing editor events omit these properties. Description text is never included.";
+            readonly properties: import("zod/v4").ZodObject<{
+                credential_id: import("zod/v4").ZodString;
+                credential_type: import("zod/v4").ZodString;
+                source: import("zod/v4").ZodOptional<import("zod/v4").ZodLiteral<"backend">>;
+                public_api: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+                has_description: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+                description_length: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                user_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                user_role: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                project_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                project_type: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                workflow_id: import("zod/v4").ZodOptional<import("zod/v4").ZodNullable<import("zod/v4").ZodString>>;
+                uiContext: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                is_private: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+                uses_external_secrets: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+                jwe_enabled: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+                credential_supports_managed_auth: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+                credential_uses_managed_auth: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_UPDATED_CREDENTIALS: {
+            readonly name: "User updated credentials";
+            readonly description: "The server updated a credential through the internal credential API. Description metadata comes from the saved record. Description text is never included.";
+            readonly properties: import("zod/v4").ZodObject<{
+                has_description: import("zod/v4").ZodBoolean;
+                description_length: import("zod/v4").ZodNumber;
+                user_id: import("zod/v4").ZodString;
+                user_role: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                credential_id: import("zod/v4").ZodString;
+                credential_type: import("zod/v4").ZodString;
+                source: import("zod/v4").ZodLiteral<"backend">;
+                is_private: import("zod/v4").ZodBoolean;
+                uses_external_secrets: import("zod/v4").ZodBoolean;
+                jwe_enabled: import("zod/v4").ZodBoolean;
+                credential_supports_managed_auth: import("zod/v4").ZodBoolean;
+                credential_uses_managed_auth: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_STARTED_CREDENTIAL_CONNECTION: {
+            readonly name: "User started credential connection";
+            readonly description: "The user started a connection attempt or selected an existing credential in the setup panel. Includes retries.";
+            readonly properties: import("zod/v4").ZodObject<{
+                source: import("zod/v4").ZodLiteral<"instance_ai_setup_panel">;
+                workflow_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodString;
+                credential_type: import("zod/v4").ZodString;
+                method: import("zod/v4").ZodEnum<{
+                    advanced: "advanced";
+                    api_key: "api_key";
+                    existing: "existing";
+                    gateway: "gateway";
+                    oauth: "oauth";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_COMPLETED_CREDENTIAL_CONNECTION: {
+            readonly name: "User completed credential connection";
+            readonly description: "A setup-panel credential was selected or connected and its workflow binding was applied or queued. This does not report workflow validation.";
+            readonly properties: import("zod/v4").ZodObject<{
+                source: import("zod/v4").ZodLiteral<"instance_ai_setup_panel">;
+                workflow_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodString;
+                credential_type: import("zod/v4").ZodString;
+                credential_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                method: import("zod/v4").ZodEnum<{
+                    advanced: "advanced";
+                    api_key: "api_key";
+                    existing: "existing";
+                    gateway: "gateway";
+                    oauth: "oauth";
+                }>;
+                binding_state: import("zod/v4").ZodEnum<{
+                    applied: "applied";
+                    noop: "noop";
+                    queued: "queued";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         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.";
@@ -892,6 +982,189 @@ 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;
+        };
+        readonly PREFERENCES_APPLIED_TO_TURN: {
+            readonly name: "Preferences applied to a turn";
+            readonly description: "A turn was built with the saved preferences available to it. Fires once for each turn that ran the preferences path, including a turn that applied none, so the share of turns with preferences is computable. CONTEXT-139 fires it.";
+            readonly properties: import("zod/v4").ZodObject<{
+                count: import("zod/v4").ZodNumber;
+                scope_types: import("zod/v4").ZodArray<import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>>;
+                rendered_length: import("zod/v4").ZodNumber;
+                surface: import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                }>;
+                injected_this_turn: import("zod/v4").ZodBoolean;
+                turn_latency_ms: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                turn_token_count: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly ASSISTANT_SAVED_PREFERENCE: {
+            readonly name: "Assistant saved preference";
+            readonly description: "An AI surface created or updated a preference on the user behalf, after the user accepted it. Kept apart from the UI events so an assistant write is never counted as a person writing in settings. CONTEXT-138 fires it.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                }>;
+                scope_type: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>;
+                text_length: import("zod/v4").ZodNumber;
+                replaced_existing: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly PREFERENCE_CONFIRMATION_SHOWN: {
+            readonly name: "Preference confirmation shown";
+            readonly description: "The assistant proposed a preference and the confirmation card was shown. Fires when the card appears, whatever the user does next. CONTEXT-138 fires it.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                }>;
+                scope_type: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>;
+                text_length: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly PREFERENCE_CONFIRMATION_RESOLVED: {
+            readonly name: "Preference confirmation resolved";
+            readonly description: "The user answered a preference confirmation. A high `rejected` share means the assistant proposes the wrong preferences, and no other number shows that. CONTEXT-138 fires it.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                }>;
+                outcome: import("zod/v4").ZodEnum<{
+                    accepted: "accepted";
+                    accepted_after_edit: "accepted_after_edit";
+                    rejected: "rejected";
+                }>;
+                scope_type: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>;
+                text_length: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly PREFERENCE_SCOPE_ACCEPTED: {
+            readonly name: "Preference scope accepted";
+            readonly description: "The scope the user accepted against the scope the assistant offered. Shows whether the assistant reads the difference between a personal habit and a team rule. Fires only on an accepted write. CONTEXT-138 and the scope ticket fire it.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                }>;
+                offered_scope: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>;
+                accepted_scope: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>;
+                scope_changed: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly PREFERENCE_WRITE_REJECTED: {
+            readonly name: "Preference write rejected";
+            readonly description: "A preference write was refused before it reached the database. Separates a rule the code applied from a user saying no, which is `Preference confirmation resolved`. CONTEXT-138 fires it.";
+            readonly properties: import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                    ui: "ui";
+                }>;
+                reason: import("zod/v4").ZodEnum<{
+                    blocked_by_admin: "blocked_by_admin";
+                    duplicate: "duplicate";
+                    failed: "failed";
+                    not_permitted: "not_permitted";
+                    scope_full: "scope_full";
+                    too_long: "too_long";
+                }>;
+                scope_type: import("zod/v4").ZodOptional<import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>>;
+                text_length: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
     INSTANCE: {
         readonly INSTANCE_STARTED: {
             readonly name: "Instance started";
@@ -997,9 +1270,57 @@ export declare const TELEMETRY_EVENT: {
         };
     };
     INSTANCE_AI: {
+        readonly SETUP_PANEL_STATE_OBSERVED: {
+            readonly name: "AI Assistant setup panel state observed";
+            readonly description: "The setup panel observed a new requirement snapshot. Also fires when no setup is needed, including workflows whose credentials were already connected.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodString;
+                credential_count: import("zod/v4").ZodNumber;
+                pending_credential_count: import("zod/v4").ZodNumber;
+                pending_parameter_count: import("zod/v4").ZodNumber;
+                already_connected_count: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly SETUP_PANEL_ITEM_SHOWN: {
+            readonly name: "AI Assistant setup panel item shown";
+            readonly description: "A setup checklist row became visible. Reopening the same row within the mounted panel does not emit another event.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodString;
+                kind: import("zod/v4").ZodEnum<{
+                    credential: "credential";
+                    details: "details";
+                    parameters: "parameters";
+                }>;
+                credential_type: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                parameter_count: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly SETUP_PANEL_DISMISSED: {
+            readonly name: "AI Assistant setup panel dismissed";
+            readonly description: "A visible setup panel closed. The reason separates navigation and removed requirements from a finished execution or an explicit dismissal.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodString;
+                reason: import("zod/v4").ZodEnum<{
+                    execution_finished: "execution_finished";
+                    execution_succeeded: "execution_succeeded";
+                    items_removed: "items_removed";
+                    navigation: "navigation";
+                    user_dismissed: "user_dismissed";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         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 +1361,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 +1400,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 +1438,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 +1457,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,11 +1548,46 @@ 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;
         };
+        readonly USER_RECEIVED_AI_ASSISTANT_RESPONSE: {
+            readonly name: "User received AI Assistant response";
+            readonly description: "The initial foreground AI Assistant reply was rendered after a user submitted a chat message. Starts before attachment processing and first-thread creation, then fires once when the initial run completes or pauses for user input. Automated follow-up runs do not create another sample.";
+            readonly properties: import("zod/v4").ZodObject<{
+                instance_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodString;
+                run_id: import("zod/v4").ZodString;
+                latency_ms: import("zod/v4").ZodNumber;
+                is_first_user_message: import("zod/v4").ZodBoolean;
+                response_kind: import("zod/v4").ZodEnum<{
+                    awaiting_input: "awaiting_input";
+                    completed: "completed";
+                }>;
+                action_source: import("zod/v4").ZodEnum<{
+                    agent_builder_page: "agent_builder_page";
+                    agent_preview: "agent_preview";
+                    assistant_page: "assistant_page";
+                    canvas_action_button: "canvas_action_button";
+                    canvas_choice_prompt: "canvas_choice_prompt";
+                    credential_edit: "credential_edit";
+                    credentials_list: "credentials_list";
+                    evals: "evals";
+                    node_error_view: "node_error_view";
+                    playwright: "playwright";
+                    "template-view": "template-view";
+                    unknown: "unknown";
+                    "website-template": "website-template";
+                    workflow_list_auto: "workflow_list_auto";
+                    workflow_list_button: "workflow_list_button";
+                }>;
+                tab_visible: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         readonly COMPUTER_USE_MODAL_OPENED: {
             readonly name: "User opened computer use connection modal";
             readonly description: "The user opened the Computer Use connection interface.";
@@ -1276,7 +1632,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 +1670,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 +1682,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 +1698,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 +1739,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";
@@ -1440,6 +1796,50 @@ export declare const TELEMETRY_EVENT: {
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
         };
+        readonly USER_SENT_BUILDER_MESSAGE: {
+            readonly name: "User sent builder message";
+            readonly description: "The user sent a message to the n8n Assistant. Fires once per message on the optimistic send, before the request is admitted, so a refused send still counts as an attempt. Carries who wrote the text: a pre-fill is an opener n8n composed (a failed execution, a credential modal, a template card, a suggestion chip) that the user accepted or edited, so pre-fill share must be read from prefill_type rather than matched against the message body.";
+            readonly properties: import("zod/v4").ZodObject<{
+                thread_id: import("zod/v4").ZodString;
+                instance_id: import("zod/v4").ZodString;
+                is_first_message: import("zod/v4").ZodBoolean;
+                action_source: import("zod/v4").ZodEnum<{
+                    agent_builder_page: "agent_builder_page";
+                    agent_preview: "agent_preview";
+                    assistant_page: "assistant_page";
+                    canvas_action_button: "canvas_action_button";
+                    canvas_choice_prompt: "canvas_choice_prompt";
+                    credential_edit: "credential_edit";
+                    credentials_list: "credentials_list";
+                    evals: "evals";
+                    node_error_view: "node_error_view";
+                    playwright: "playwright";
+                    "template-view": "template-view";
+                    unknown: "unknown";
+                    "website-template": "website-template";
+                    workflow_list_auto: "workflow_list_auto";
+                    workflow_list_button: "workflow_list_button";
+                }>;
+                prefill_type: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    contextual_followup: "contextual_followup";
+                    handoff_agent_change_request: "handoff_agent_change_request";
+                    handoff_credential_setup: "handoff_credential_setup";
+                    handoff_execution_error: "handoff_execution_error";
+                    handoff_fix_with_ai: "handoff_fix_with_ai";
+                    handoff_setup_panel_execute: "handoff_setup_panel_execute";
+                    suggestion_catalog: "suggestion_catalog";
+                    template_adjustment: "template_adjustment";
+                    template_example: "template_example";
+                    unknown: "unknown";
+                    v1_opener: "v1_opener";
+                    workflow_attachment_opener: "workflow_attachment_opener";
+                }>>;
+                prefill_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                prompt_modified: import("zod/v4").ZodNullable<import("zod/v4").ZodBoolean>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         readonly BUILDER_LISTED_WORKFLOWS: {
             readonly name: "Builder listed workflows";
             readonly description: "Instance AI called workflows(action=\"list\"). Emitted on every list call, in both arms of the folder-exploration rollout, so folder-scoped calls have a denominator. Carries no folder names.";
@@ -1474,6 +1874,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,7 +2021,122 @@ 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";
+                }>;
+                kind: import("zod/v4").ZodEnum<{
+                    "credential-types": "credential-types";
+                    "node-types": "node-types";
+                }>;
+                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";
+                }>;
+                kind: import("zod/v4").ZodEnum<{
+                    "credential-types": "credential-types";
+                    "node-types": "node-types";
+                }>;
+                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";
+                }>;
+                kind: import("zod/v4").ZodEnum<{
+                    "credential-types": "credential-types";
+                    "node-types": "node-types";
+                }>;
+                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 USER_REQUESTED_WORKFLOW_TEST: {
+            readonly name: "User requested workflow test";
+            readonly description: "The user started a manual workflow test from the AI Assistant setup panel. This event does not report execution success.";
+            readonly properties: import("zod/v4").ZodObject<{
+                source: import("zod/v4").ZodLiteral<"instance_ai_setup_panel">;
+                workflow_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         readonly MULTIPLE_NODES_SELECTED: {
             readonly name: "User selected multiple nodes";
             readonly description: "The user has two or more nodes selected on the workflow canvas. Fires once the selection settles (debounced), covering all selection paths — rubber-band drag, shift-click, and select-all — so intermediate states during a drag are not reported. Groups are excluded from the count.";