@n8n/telemetry 1.8.0 → 1.9.0

package/dist/telemetry-events.d.ts

@@ -877,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.";
@@ -943,6 +1032,138 @@ export declare const TELEMETRY_EVENT: {
         } & 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: {
@@ -1049,6 +1270,54 @@ 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 n8n Assistant credit balance button to open or close the balance dropdown.";
@@ -1284,6 +1553,41 @@ export declare const TELEMETRY_EVENT: {
         } & 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.";
@@ -1492,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.";
@@ -1687,6 +2035,10 @@ export declare const TELEMETRY_EVENT: {
                     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";
@@ -1731,6 +2083,10 @@ export declare const TELEMETRY_EVENT: {
                     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";
@@ -1751,6 +2107,10 @@ export declare const TELEMETRY_EVENT: {
                     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";
@@ -1766,6 +2126,17 @@ export declare const TELEMETRY_EVENT: {
         };
     };
     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.";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n8n/telemetry",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "main": "dist/index.js",
   "module": "src/index.ts",
   "types": "dist/index.d.ts",
@@ -10,6 +10,7 @@
     "LICENSE_EE.md"
   ],
   "dependencies": {
+    "@n8n/api-types": "1.41.0",
     "@n8n/utils": "1.48.0",
     "zod": "3.25.76"
   },