@n8n/telemetry 1.9.1 → 1.10.0

package/dist/telemetry-events.d.ts

@@ -875,8 +875,109 @@ export declare const TELEMETRY_EVENT: {
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
         };
+        readonly USER_STARTED_AGENT_CHANNEL_SETUP: {
+            readonly name: "User started agent channel setup";
+            readonly description: "The setup view of a chat channel became visible in the agent channel modal. Pairs with \"User closed agent channel setup\" to measure the setup funnel.";
+            readonly properties: import("zod/v4").ZodObject<{
+                agent_id: import("zod/v4").ZodString;
+                channel_type: import("zod/v4").ZodString;
+                session_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_CLOSED_AGENT_CHANNEL_SETUP: {
+            readonly name: "User closed agent channel setup";
+            readonly description: "The user left a chat channel setup view: after connecting the channel, going back to the channel list, or closing the modal. Fires once for each \"User started agent channel setup\".";
+            readonly properties: import("zod/v4").ZodObject<{
+                agent_id: import("zod/v4").ZodString;
+                channel_type: import("zod/v4").ZodString;
+                completed: import("zod/v4").ZodBoolean;
+                session_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_FAILED_TO_CONNECT_AGENT_CHANNEL: {
+            readonly name: "User failed to connect agent channel";
+            readonly description: "Saving a chat channel setup failed. The user can retry, so one setup can emit this more than once.";
+            readonly properties: import("zod/v4").ZodObject<{
+                agent_id: import("zod/v4").ZodString;
+                channel_type: import("zod/v4").ZodString;
+                stage: import("zod/v4").ZodEnum<{
+                    before_save: "before_save";
+                    connect: "connect";
+                    persist: "persist";
+                }>;
+                conflict: import("zod/v4").ZodBoolean;
+                session_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_CHECKED_TEAMS_CHANNEL_CREDENTIAL: {
+            readonly name: "User checked Teams channel credential";
+            readonly description: "The Teams channel setup checked the selected credential against Microsoft. Runs on its own whenever the selected credential changes, including when the setup opens with one, and when the user clicks recheck.";
+            readonly properties: import("zod/v4").ZodObject<{
+                agent_id: import("zod/v4").ZodString;
+                trigger: import("zod/v4").ZodEnum<{
+                    auto: "auto";
+                    recheck: "recheck";
+                }>;
+                status: import("zod/v4").ZodEnum<{
+                    failed: "failed";
+                    ok: "ok";
+                }>;
+                reason: import("zod/v4").ZodOptional<import("zod/v4").ZodEnum<{
+                    certificate: "certificate";
+                    cloud: "cloud";
+                    incomplete: "incomplete";
+                    rejected: "rejected";
+                    request_failed: "request_failed";
+                    unreachable: "unreachable";
+                }>>;
+                session_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_CLICKED_DEPLOY_TO_AZURE_FOR_TEAMS_CHANNEL: {
+            readonly name: "User clicked Deploy to Azure for Teams channel";
+            readonly description: "The user clicked the Deploy to Azure button in the Teams channel setup.";
+            readonly properties: import("zod/v4").ZodObject<{
+                agent_id: import("zod/v4").ZodString;
+                session_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_DOWNLOADED_TEAMS_APP_PACKAGE: {
+            readonly name: "User downloaded Teams app package";
+            readonly description: "The user tried to download the Teams app package in the Teams channel setup.";
+            readonly properties: import("zod/v4").ZodObject<{
+                agent_id: import("zod/v4").ZodString;
+                status: import("zod/v4").ZodEnum<{
+                    error: "error";
+                    success: "success";
+                }>;
+                session_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
     };
     CREDENTIALS: {
+        readonly USER_VIEWED_GATEWAY_CREDITS_CREDENTIAL_ERROR_NUDGE: {
+            readonly name: "User viewed Gateway credits credential error nudge";
+            readonly description: "The credential modal showed a Gateway credits suggestion after a failed credential test for an eligible workflow node.";
+            readonly properties: import("zod/v4").ZodObject<{
+                credential_type: import("zod/v4").ZodString;
+                node_type: import("zod/v4").ZodString;
+                workflow_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_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.";
@@ -906,13 +1007,13 @@ export declare const TELEMETRY_EVENT: {
             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">;
+                source: import("zod/v4").ZodOptional<import("zod/v4").ZodLiteral<"backend">>;
+                has_description: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+                description_length: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
                 is_private: import("zod/v4").ZodBoolean;
                 uses_external_secrets: import("zod/v4").ZodBoolean;
                 jwe_enabled: import("zod/v4").ZodBoolean;
@@ -1001,6 +1102,37 @@ export declare const TELEMETRY_EVENT: {
         };
     };
     CONTEXT: {
+        readonly USER_VIEWED_PREFERENCES: {
+            readonly name: "User viewed preferences";
+            readonly description: "A user opened the preferences list in the Context settings area. Fires on every visit, so it is the first step of the create funnel and the only sign that somebody read their saved preferences without changing one.";
+            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";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_OPENED_PREFERENCE_MODAL: {
+            readonly name: "User opened preference modal";
+            readonly description: "A user opened the create or edit dialog on the preferences settings page. Pairs with `User created preference` and `User updated preference`: an open with no save that follows is an abandoned edit, which no other event shows.";
+            readonly properties: import("zod/v4").ZodObject<{
+                mode: import("zod/v4").ZodEnum<{
+                    edit: "edit";
+                    new: "new";
+                }>;
+                scope_type: import("zod/v4").ZodOptional<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 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.";
@@ -1028,6 +1160,11 @@ export declare const TELEMETRY_EVENT: {
                 text_length: import("zod/v4").ZodNumber;
                 scope_changed: import("zod/v4").ZodBoolean;
                 project_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                surface: import("zod/v4").ZodOptional<import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                    ui: "ui";
+                }>>;
             }, import("zod/v4/core").$strip>;
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
@@ -1039,6 +1176,7 @@ export declare const TELEMETRY_EVENT: {
                 count: import("zod/v4").ZodNumber;
                 source: import("zod/v4").ZodEnum<{
                     bulk: "bulk";
+                    rejected: "rejected";
                     row: "row";
                 }>;
                 scope_types: import("zod/v4").ZodArray<import("zod/v4").ZodEnum<{
@@ -1046,6 +1184,11 @@ export declare const TELEMETRY_EVENT: {
                     project: "project";
                     user: "user";
                 }>>;
+                surface: import("zod/v4").ZodOptional<import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                }>>;
+                seconds_since_saved: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
             }, import("zod/v4/core").$strip>;
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
@@ -1072,9 +1215,25 @@ export declare const TELEMETRY_EVENT: {
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
         };
+        readonly PREFERENCES_READ_OVER_MCP: {
+            readonly name: "Preferences read over MCP";
+            readonly description: "An MCP client called `get_user_preferences`. Kept apart from `Preferences applied to a turn` because an MCP read is not a turn: n8n hands the text over and never learns whether the client applied it, so the latency and token columns of the turn event would stay empty. Fires on a successful read, including one that found nothing.";
+            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;
+                project_scoped: import("zod/v4").ZodBoolean;
+            }, 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 description: "An AI surface created or updated a preference on the user behalf. The assistant writes first and the chat card is the confirmation, so this fires with the write, before the user has said anything. Kept apart from the UI events so an assistant write is never counted as a person writing in settings.";
             readonly properties: import("zod/v4").ZodObject<{
                 surface: import("zod/v4").ZodEnum<{
                     aia: "aia";
@@ -1093,7 +1252,7 @@ export declare const TELEMETRY_EVENT: {
         };
         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 description: "The assistant saved a preference and the user was given the way to edit or undo it: the chat card, the MCP review form, or, on an MCP client without elicitation, the tool result that tells the client to relay the saved text and the settings link. Fires with the write, whatever the user does next.";
             readonly properties: import("zod/v4").ZodObject<{
                 surface: import("zod/v4").ZodEnum<{
                     aia: "aia";
@@ -1109,9 +1268,27 @@ export declare const TELEMETRY_EVENT: {
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
         };
+        readonly USER_SAW_PREFERENCE_CARD: {
+            readonly name: "User saw preference card";
+            readonly description: "The preference card rendered in the chat thread. `Preference confirmation shown` fires with the write, so it counts confirmations offered, not confirmations seen. The gap between the two is a write whose card never reached the screen, which an MCP client without a review form always produces.";
+            readonly properties: import("zod/v4").ZodObject<{
+                scope_type: import("zod/v4").ZodEnum<{
+                    instance: "instance";
+                    project: "project";
+                    user: "user";
+                }>;
+                state: import("zod/v4").ZodEnum<{
+                    edited: "edited";
+                    saved: "saved";
+                    undone: "undone";
+                }>;
+            }, 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 description: "How a preference the assistant saved was settled. `accepted` fires with the write itself: the assistant writes first and silence is agreement, so it is not a user answer. `accepted_after_edit` and `rejected` are the explicit user actions, and either one supersedes the `accepted` already recorded for the same preference: read the last outcome for a preference, not the count of them. A high share of edits and removals means the assistant saves the wrong preferences, and no other number shows that.";
             readonly properties: import("zod/v4").ZodObject<{
                 surface: import("zod/v4").ZodEnum<{
                     aia: "aia";
@@ -1134,7 +1311,7 @@ export declare const TELEMETRY_EVENT: {
         };
         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 description: "The scope the user accepted against the scope offered. An accepted write from the assistant reports `user` for both, because the tool writes only `user`. A later move reports the scope the row left as `offered_scope`, so `user` appears there only on the first move off the default. Fires on an accepted assistant write, on every move from the chat card, and on a move from MCP: the review form, or `update_user_preference` with a scope.";
             readonly properties: import("zod/v4").ZodObject<{
                 surface: import("zod/v4").ZodEnum<{
                     aia: "aia";
@@ -1157,7 +1334,7 @@ export declare const TELEMETRY_EVENT: {
         };
         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 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`.";
             readonly properties: import("zod/v4").ZodObject<{
                 surface: import("zod/v4").ZodEnum<{
                     aia: "aia";
@@ -1610,8 +1787,15 @@ export declare const TELEMETRY_EVENT: {
         };
         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 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. Repeats the mention and attachment counts of the message that started the run, so outcome cuts by context need no join back to \"User sent builder message\".";
             readonly properties: import("zod/v4").ZodObject<{
+                mention_counts: import("zod/v4").ZodObject<{
+                    total: import("zod/v4").ZodNumber;
+                    workflow: import("zod/v4").ZodNumber;
+                    node: import("zod/v4").ZodNumber;
+                    group: import("zod/v4").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                attachment_count: import("zod/v4").ZodNumber;
                 instance_id: import("zod/v4").ZodString;
                 thread_id: import("zod/v4").ZodString;
                 run_id: import("zod/v4").ZodString;
@@ -1631,6 +1815,7 @@ export declare const TELEMETRY_EVENT: {
                     credentials_list: "credentials_list";
                     evals: "evals";
                     node_error_view: "node_error_view";
+                    onboarding: "onboarding";
                     playwright: "playwright";
                     "template-view": "template-view";
                     unknown: "unknown";
@@ -1851,6 +2036,108 @@ export declare const TELEMETRY_EVENT: {
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
         };
+        readonly USER_OPENED_AI_ASSISTANT_MENTION_PICKER: {
+            readonly name: "User opened AI Assistant mention picker";
+            readonly description: "The user opened the n8n Assistant mention picker by typing an at sign or selecting the composer button. Every open ends in exactly one \"User selected AI Assistant mention\" or one \"User dismissed AI Assistant mention picker\", so the two together give the pick rate per open.";
+            readonly properties: import("zod/v4").ZodObject<{
+                thread_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                source: import("zod/v4").ZodEnum<{
+                    button: "button";
+                    typed: "typed";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_DISMISSED_AI_ASSISTANT_MENTION_PICKER: {
+            readonly name: "User dismissed AI Assistant mention picker";
+            readonly description: "The n8n Assistant mention picker closed without a selection. The list properties describe what was on screen at that moment: a search with result_count 0 is a resource the user could not find, a non-zero ambiguous_result_count is a list the user could not tell apart. Carries interaction metadata but no query text or resource names; the query text of an empty search is on \"User searched AI Assistant mentions without results\".";
+            readonly properties: import("zod/v4").ZodObject<{
+                thread_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                source: import("zod/v4").ZodEnum<{
+                    button: "button";
+                    typed: "typed";
+                }>;
+                reason: import("zod/v4").ZodEnum<{
+                    closed_menu: "closed_menu";
+                    deleted_trigger: "deleted_trigger";
+                    moved_caret: "moved_caret";
+                    unavailable: "unavailable";
+                }>;
+                mode: import("zod/v4").ZodEnum<{
+                    browse: "browse";
+                    search: "search";
+                }>;
+                query_length: import("zod/v4").ZodNumber;
+                result_count: import("zod/v4").ZodNumber;
+                ambiguous_result_count: import("zod/v4").ZodNumber;
+                submenu_open_count: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_SEARCHED_AI_ASSISTANT_MENTIONS_WITHOUT_RESULTS: {
+            readonly name: "User searched AI Assistant mentions without results";
+            readonly description: "The n8n Assistant mention picker showed its empty state for a search query the user let settle for about a second, or closed the picker on. Fires once per distinct settled query within one picker open, so typing straight through a prefix chain like \"S\", \"Sl\", \"Slack\" reports \"Slack\" once. The one mention event that carries the query text, to learn what users try to mention and cannot.";
+            readonly properties: import("zod/v4").ZodObject<{
+                thread_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                source: import("zod/v4").ZodEnum<{
+                    button: "button";
+                    typed: "typed";
+                }>;
+                query: import("zod/v4").ZodString;
+                query_length: import("zod/v4").ZodNumber;
+                matched_node_type: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                artifact_count: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_SELECTED_AI_ASSISTANT_MENTION: {
+            readonly name: "User selected AI Assistant mention";
+            readonly description: "The user selected a workflow, node, or canvas group from the n8n Assistant mention picker. A pick of a mention that is already staged also counts, so every open ends in this event or in \"User dismissed AI Assistant mention picker\". The event contains interaction metadata but no resource names or IDs.";
+            readonly properties: import("zod/v4").ZodObject<{
+                thread_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                kind: import("zod/v4").ZodEnum<{
+                    group: "group";
+                    node: "node";
+                    workflow: "workflow";
+                }>;
+                mode: import("zod/v4").ZodEnum<{
+                    browse: "browse";
+                    search: "search";
+                }>;
+                source: import("zod/v4").ZodEnum<{
+                    artifacts: "artifacts";
+                    workflows: "workflows";
+                }>;
+                result_position: import("zod/v4").ZodNumber;
+                query_length: import("zod/v4").ZodNumber;
+                already_artifact: import("zod/v4").ZodBoolean;
+                artifact_origin: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    attached: "attached";
+                    built: "built";
+                    fetched: "fetched";
+                    mentioned: "mentioned";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_REMOVED_AI_ASSISTANT_MENTION: {
+            readonly name: "User removed AI Assistant mention";
+            readonly description: "The user removed workflow, node, or canvas group context that they added through the n8n Assistant mention picker.";
+            readonly properties: import("zod/v4").ZodObject<{
+                thread_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                kind: import("zod/v4").ZodEnum<{
+                    group: "group";
+                    node: "node";
+                    workflow: "workflow";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & 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.";
@@ -1864,6 +2151,13 @@ export declare const TELEMETRY_EVENT: {
                     control: "control";
                     variant: "variant";
                 }>>;
+                mention_counts: import("zod/v4").ZodObject<{
+                    total: import("zod/v4").ZodNumber;
+                    workflow: import("zod/v4").ZodNumber;
+                    node: import("zod/v4").ZodNumber;
+                    group: import("zod/v4").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                attachment_count: import("zod/v4").ZodNumber;
                 workflow_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
                 pending_credential_count: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
                 pending_parameter_count: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
@@ -1880,6 +2174,7 @@ export declare const TELEMETRY_EVENT: {
                     credentials_list: "credentials_list";
                     evals: "evals";
                     node_error_view: "node_error_view";
+                    onboarding: "onboarding";
                     playwright: "playwright";
                     "template-view": "template-view";
                     unknown: "unknown";
@@ -1939,6 +2234,144 @@ export declare const TELEMETRY_EVENT: {
         } & import("./define").TelemetryEventInput & {
             readonly getValidationError: (properties: unknown) => string | null;
         };
+        readonly USER_STARTED_AI_ASSISTANT_ONBOARDING: {
+            readonly name: "User started AI Assistant onboarding";
+            readonly description: "An onboarding thread was created: the user arrived from the n8n Cloud signup survey (/assistant?source=onboarding) or opened the onboarding by hand. Fires once per thread, from the backend, when the seeded greeting and question card are stored.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodString;
+                team: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                team_source: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    cloud: "cloud";
+                    url: "url";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_ANSWERED_AI_ASSISTANT_ONBOARDING_CARD: {
+            readonly name: "User answered AI Assistant onboarding card";
+            readonly description: "The user settled the question card an onboarding thread opens with. Fires once per thread, from the backend, when the answers are stored. Carries the picked apps and the free text as typed.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodString;
+                team: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                team_source: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    card: "card";
+                    cloud: "cloud";
+                    url: "url";
+                }>>;
+                apps: import("zod/v4").ZodArray<import("zod/v4").ZodString>;
+                custom_text: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly AI_ASSISTANT_ONBOARDING_ENDED: {
+            readonly name: "AI Assistant onboarding ended";
+            readonly description: "The onboarding flow of a thread ended and the normal chat came back. Fires once per thread, from the browser, on the first build, when the agent calls `leave-onboarding`, or when a run fails.";
+            readonly properties: import("zod/v4").ZodObject<{
+                thread_id: import("zod/v4").ZodString;
+                instance_id: import("zod/v4").ZodString;
+                outcome: import("zod/v4").ZodEnum<{
+                    build: "build";
+                    left: "left";
+                    run_failed: "run_failed";
+                }>;
+                leave_reason: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly INSTANCE_CONTEXT_TURN: {
+            readonly name: "Instance AI instance-context turn completed";
+            readonly description: "One context result per turn segment, including turns without a block. Group by run_id. Count distinct runs, sum segment tokens, and count a question if any segment asked one.";
+            readonly properties: import("zod/v4").ZodDiscriminatedUnion<[import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                }>;
+                user_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                run_id: import("zod/v4").ZodString;
+                segment: import("zod/v4").ZodEnum<{
+                    resumed: "resumed";
+                    suspended: "suspended";
+                    whole: "whole";
+                }>;
+                instance_context_enabled: import("zod/v4").ZodBoolean;
+                node_usage_enabled: import("zod/v4").ZodBoolean;
+                context_depth: import("zod/v4").ZodNumber;
+                context_surfaces: import("zod/v4").ZodArray<import("zod/v4").ZodEnum<{
+                    "activity-expand": "activity-expand";
+                    "activity-list": "activity-list";
+                    "node-usage": "node-usage";
+                    "workflow-read": "workflow-read";
+                }>>;
+                asked_clarifying_question: import("zod/v4").ZodBoolean;
+                tool_calls: import("zod/v4").ZodNumber;
+                turn_prompt_tokens: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                turn_completion_tokens: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                turn_total_tokens: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                turn_cost_usd: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                status: import("zod/v4").ZodEnum<{
+                    cancelled: "cancelled";
+                    completed: "completed";
+                    errored: "errored";
+                    suspended: "suspended";
+                }>;
+                block_state: import("zod/v4").ZodLiteral<"absent">;
+                absence_reason: import("zod/v4").ZodEnum<{
+                    disabled: "disabled";
+                    empty: "empty";
+                    failed: "failed";
+                    "machine-follow-up": "machine-follow-up";
+                }>;
+            }, import("zod/v4/core").$strict>, import("zod/v4").ZodObject<{
+                surface: import("zod/v4").ZodEnum<{
+                    aia: "aia";
+                    mcp: "mcp";
+                }>;
+                user_id: import("zod/v4").ZodString;
+                thread_id: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+                run_id: import("zod/v4").ZodString;
+                segment: import("zod/v4").ZodEnum<{
+                    resumed: "resumed";
+                    suspended: "suspended";
+                    whole: "whole";
+                }>;
+                instance_context_enabled: import("zod/v4").ZodBoolean;
+                node_usage_enabled: import("zod/v4").ZodBoolean;
+                context_depth: import("zod/v4").ZodNumber;
+                context_surfaces: import("zod/v4").ZodArray<import("zod/v4").ZodEnum<{
+                    "activity-expand": "activity-expand";
+                    "activity-list": "activity-list";
+                    "node-usage": "node-usage";
+                    "workflow-read": "workflow-read";
+                }>>;
+                asked_clarifying_question: import("zod/v4").ZodBoolean;
+                tool_calls: import("zod/v4").ZodNumber;
+                turn_prompt_tokens: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                turn_completion_tokens: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                turn_total_tokens: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                turn_cost_usd: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+                status: import("zod/v4").ZodEnum<{
+                    cancelled: "cancelled";
+                    completed: "completed";
+                    errored: "errored";
+                    suspended: "suspended";
+                }>;
+                block_state: import("zod/v4").ZodLiteral<"injected">;
+                block_is_update: import("zod/v4").ZodBoolean;
+                block_inventory_rows: import("zod/v4").ZodNumber;
+                block_event_rows: import("zod/v4").ZodNumber;
+                block_run_rows: import("zod/v4").ZodNumber;
+                block_chars: import("zod/v4").ZodNumber;
+                block_tokens_estimated: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strict>]>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
     };
     MCP: {
         readonly MCP_NUDGE_VIEWED: {
@@ -2060,6 +2493,7 @@ export declare const TELEMETRY_EVENT: {
                 client_brand: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
                     claude: "claude";
                     cursor: "cursor";
+                    mistral: "mistral";
                     openai: "openai";
                     vscode: "vscode";
                 }>>;
@@ -2088,10 +2522,10 @@ 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.";
+    TYPE_AVAILABILITY_POLICIES: {
+        readonly USER_SAVED_TYPE_AVAILABILITY_POLICY: {
+            readonly name: "User saved type availability policy";
+            readonly description: "A type availability policy (node types or credential types, per `kind`) 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;
@@ -2137,9 +2571,9 @@ export declare const TELEMETRY_EVENT: {
         } & 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 USER_UPDATED_TYPE_AVAILABILITY_POLICY_DOCUMENT: {
+            readonly name: "User updated type availability 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 type availability 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;
@@ -2165,8 +2599,8 @@ export declare const TELEMETRY_EVENT: {
         } & 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 USER_UPDATED_TYPE_AVAILABILITY_POLICY_ATTACHMENTS: {
+            readonly name: "User updated type availability 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>;
@@ -2193,6 +2627,116 @@ export declare const TELEMETRY_EVENT: {
         };
     };
     WORKFLOW: {
+        readonly USER_GROUPED_NODES: {
+            readonly name: "User grouped nodes";
+            readonly description: "The user created a node group on the workflow canvas. Empty groups report no node ids because their internal anchor is excluded.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                group_id: import("zod/v4").ZodString;
+                node_ids: import("zod/v4").ZodArray<import("zod/v4").ZodString>;
+                node_count: import("zod/v4").ZodNumber;
+                group_title: import("zod/v4").ZodString;
+                source: import("zod/v4").ZodEnum<{
+                    "context-menu": "context-menu";
+                    "group-header": "group-header";
+                    "group-toolbar": "group-toolbar";
+                    "keyboard-shortcut": "keyboard-shortcut";
+                    "node-creator": "node-creator";
+                    "sub-workflow-extraction": "sub-workflow-extraction";
+                    "update-blocked-toast": "update-blocked-toast";
+                }>;
+                push_ref: import("zod/v4").ZodString;
+                is_empty: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+                node_creator_open_source: import("zod/v4").ZodOptional<import("zod/v4").ZodEnum<{
+                    add_evaluation_node_button: "add_evaluation_node_button";
+                    add_input_endpoint: "add_input_endpoint";
+                    add_node_button: "add_node_button";
+                    context_menu: "context_menu";
+                    instance_ai: "instance_ai";
+                    no_trigger_execution_tooltip: "no_trigger_execution_tooltip";
+                    node_connection_action: "node_connection_action";
+                    node_connection_drop: "node_connection_drop";
+                    node_shortcut: "node_shortcut";
+                    notice_error_message: "notice_error_message";
+                    plus_endpoint: "plus_endpoint";
+                    replace_node_action: "replace_node_action";
+                    templates_callout: "templates_callout";
+                    trigger_placeholder_button: "trigger_placeholder_button";
+                }>>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_FILLED_EMPTY_GROUP: {
+            readonly name: "User filled empty group";
+            readonly description: "The user added the first real node or node batch to a group that contained only its internal empty-group anchor.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                group_id: import("zod/v4").ZodString;
+                push_ref: import("zod/v4").ZodString;
+                node_count_after: import("zod/v4").ZodNumber;
+                connection_count_before_fill: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_DELETED_LAST_NODE_FROM_GROUP: {
+            readonly name: "User deleted last node from group";
+            readonly description: "The user deleted the last real node from a group and the editor replaced it with an internal empty-group anchor.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                group_id: import("zod/v4").ZodString;
+                push_ref: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_DELETED_GROUP: {
+            readonly name: "User deleted group";
+            readonly description: "The user deleted the final member of a group, which removed the group from the workflow.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                group_id: import("zod/v4").ZodString;
+                push_ref: import("zod/v4").ZodString;
+                was_empty: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_CONNECTED_EMPTY_GROUP: {
+            readonly name: "User connected empty group";
+            readonly description: "The user added a connection whose source or target was a group that still contained only its internal empty-group anchor.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                group_id: import("zod/v4").ZodString;
+                push_ref: import("zod/v4").ZodString;
+                was_first_connection: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_ACTIVATED_WORKFLOW: {
+            readonly name: "User activated workflow";
+            readonly description: "A workflow version became active. The empty-group count is calculated from that published version, not from the current draft.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodString;
+                workflow_id: import("zod/v4").ZodString;
+                public_api: import("zod/v4").ZodBoolean;
+                source: import("zod/v4").ZodEnum<{
+                    api: "api";
+                    import: "import";
+                    "n8n-ai": "n8n-ai";
+                    "n8n-mcp": "n8n-mcp";
+                    "review-approval": "review-approval";
+                    ui: "ui";
+                }>;
+                private_credentials_count: import("zod/v4").ZodNumber;
+                private_credential_types: import("zod/v4").ZodArray<import("zod/v4").ZodString>;
+                empty_group_count: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         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.";