@n8n/telemetry 1.9.1 → 1.10.0

package/dist/events/context.js

@@ -3,19 +3,39 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONTEXT_TELEMETRY = void 0;
 const v4_1 = require("zod/v4");
 const define_1 = require("../define");
+const schemas_1 = require("../schemas");
 const scopeType = v4_1.z
     .enum(['user', 'project', 'instance'])
     .describe('Who the preference applies to: only its author, one project, or the whole instance');
 const textLength = v4_1.z
     .number()
     .describe('Character count of the preference text. The text itself is never reported');
-const surface = v4_1.z
+const surfaceType = v4_1.z
     .enum(['ui', 'aia', 'mcp'])
     .describe('Surface the event came from, with the same values as the `source` column');
-const assistantSurface = v4_1.z
-    .enum(['aia', 'mcp'])
-    .describe('Assistant surface that acted. The settings area cannot fire this event');
 exports.CONTEXT_TELEMETRY = (0, define_1.defineTelemetryEvents)({
+    USER_VIEWED_PREFERENCES: {
+        name: 'User viewed preferences',
+        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.',
+        properties: v4_1.z.object({
+            count: v4_1.z
+                .number()
+                .describe('Preferences the user can see in total, not the number the page showed'),
+            scope_types: v4_1.z
+                .array(scopeType)
+                .describe('Distinct scopes on the page the visit loaded. The list pages at 50 rows, so a longer list reports the scopes of the first page only and does not cover `count`'),
+        }),
+    },
+    USER_OPENED_PREFERENCE_MODAL: {
+        name: 'User opened preference modal',
+        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.',
+        properties: v4_1.z.object({
+            mode: v4_1.z
+                .enum(['new', 'edit'])
+                .describe('`new` is the Add button. `edit` is the pencil on an existing row'),
+            scope_type: scopeType.optional().describe('Scope of the row being edited. Absent on `new`'),
+        }),
+    },
     USER_CREATED_PREFERENCE: {
         name: 'User created preference',
         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.',
@@ -38,6 +58,9 @@ exports.CONTEXT_TELEMETRY = (0, define_1.defineTelemetryEvents)({
                 .string()
                 .optional()
                 .describe('Present only when the resulting scope is a project'),
+            surface: surfaceType
+                .optional()
+                .describe('Where the user made the edit: `ui` is the settings page and `aia` the chat card. Absent on a row written before the chat card could edit'),
         }),
     },
     USER_DELETED_PREFERENCES: {
@@ -46,9 +69,16 @@ exports.CONTEXT_TELEMETRY = (0, define_1.defineTelemetryEvents)({
         properties: v4_1.z.object({
             count: v4_1.z.number().describe('How many preferences the operation deleted'),
             source: v4_1.z
-                .enum(['row', 'bulk'])
-                .describe('`row` is the per-row Delete button, `bulk` is the selection toolbar'),
+                .enum(['row', 'bulk', 'rejected'])
+                .describe('`row` is the per-row Delete button and `bulk` the selection toolbar on the settings page. `rejected` is the Undo on the chat card, Decline on the MCP review form, or the MCP undo tool: the user did not accept a preference the assistant saved, a late refusal of one they first let stand'),
             scope_types: v4_1.z.array(scopeType).describe('Distinct scopes the deleted preferences covered'),
+            surface: schemas_1.assistantSurfaceSchema
+                .optional()
+                .describe('Set on a `rejected` delete, to tell the chat card from an MCP client'),
+            seconds_since_saved: v4_1.z
+                .number()
+                .optional()
+                .describe('On a `rejected` delete, how long after the assistant write the user took it back. A short gap means the write itself was wrong, not a later change of mind'),
         }),
     },
     PREFERENCES_APPLIED_TO_TURN: {
@@ -60,7 +90,7 @@ exports.CONTEXT_TELEMETRY = (0, define_1.defineTelemetryEvents)({
             rendered_length: v4_1.z
                 .number()
                 .describe('Characters in the rendered block. Reviews the caps: a 95th percentile above 8,000 means the caps need new numbers'),
-            surface: assistantSurface,
+            surface: schemas_1.assistantSurfaceSchema.describe('Always `aia`. An MCP client reads through a tool and never reports a turn, so it fires `Preferences read over MCP` instead'),
             injected_this_turn: v4_1.z
                 .boolean()
                 .describe('False when the text was unchanged and an earlier block in the same conversation still carries it. Shows how often re-injecting on every turn actually costs anything'),
@@ -74,44 +104,68 @@ exports.CONTEXT_TELEMETRY = (0, define_1.defineTelemetryEvents)({
                 .describe('Input tokens of the turn, so the cost with and without the block is comparable'),
         }),
     },
+    PREFERENCES_READ_OVER_MCP: {
+        name: 'Preferences read over MCP',
+        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.',
+        properties: v4_1.z.object({
+            count: v4_1.z.number().describe('Preferences the read returned. 0 when none are saved'),
+            scope_types: v4_1.z.array(scopeType).describe('Distinct scopes the returned preferences covered'),
+            rendered_length: v4_1.z
+                .number()
+                .describe('Characters in the rendered block the client received. 0 when nothing is saved. Reviews the caps against the same number the turn event reports'),
+            project_scoped: v4_1.z
+                .boolean()
+                .describe('Whether the call named one project instead of reading every visible project'),
+        }),
+    },
     ASSISTANT_SAVED_PREFERENCE: {
         name: 'Assistant saved preference',
-        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.',
+        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.',
         properties: v4_1.z.object({
-            surface: assistantSurface,
+            surface: schemas_1.assistantSurfaceSchema,
             scope_type: scopeType,
             text_length: textLength,
             replaced_existing: v4_1.z
                 .boolean()
-                .describe('Whether the write updated an existing preference instead of adding one'),
+                .describe('Whether the write updated an existing preference instead of adding one. Only `update_user_preference` on MCP sets this true. The chat assistant has no update tool, so an `aia` row is always false'),
         }),
     },
     PREFERENCE_CONFIRMATION_SHOWN: {
         name: 'Preference confirmation shown',
-        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.',
+        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.',
         properties: v4_1.z.object({
-            surface: assistantSurface,
+            surface: schemas_1.assistantSurfaceSchema,
             scope_type: scopeType.describe('Scope the assistant offered'),
             text_length: textLength,
         }),
     },
+    USER_SAW_PREFERENCE_CARD: {
+        name: 'User saw preference card',
+        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.',
+        properties: v4_1.z.object({
+            scope_type: scopeType.describe('Scope the card names at render time'),
+            state: v4_1.z
+                .enum(['saved', 'edited', 'undone'])
+                .describe('State the card rendered in, so a re-render after an edit is not read as a new write'),
+        }),
+    },
     PREFERENCE_CONFIRMATION_RESOLVED: {
         name: 'Preference confirmation resolved',
-        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.',
+        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.',
         properties: v4_1.z.object({
-            surface: assistantSurface,
+            surface: schemas_1.assistantSurfaceSchema,
             outcome: v4_1.z
                 .enum(['accepted', 'accepted_after_edit', 'rejected'])
-                .describe('`accepted_after_edit` means the user changed the text before accepting'),
+                .describe('`accepted` is implicit, fired with the write. `accepted_after_edit` means the user changed the text from the card or the MCP review form. `rejected` means the user took the write back: Undo on the card, Decline on the MCP review form, or the MCP undo tool. The same removal also fires `User deleted preferences` with source `rejected`'),
             scope_type: scopeType.describe('Scope the preference was saved with, or the offered scope on a rejection'),
             text_length: textLength.describe('Character count of the text the user accepted or rejected'),
         }),
     },
     PREFERENCE_SCOPE_ACCEPTED: {
         name: 'Preference scope accepted',
-        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.',
+        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.',
         properties: v4_1.z.object({
-            surface: assistantSurface,
+            surface: schemas_1.assistantSurfaceSchema,
             offered_scope: scopeType,
             accepted_scope: scopeType,
             scope_changed: v4_1.z.boolean().describe('Whether the user moved the write to another scope'),
@@ -119,9 +173,9 @@ exports.CONTEXT_TELEMETRY = (0, define_1.defineTelemetryEvents)({
     },
     PREFERENCE_WRITE_REJECTED: {
         name: 'Preference write rejected',
-        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.',
+        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`.',
         properties: v4_1.z.object({
-            surface,
+            surface: surfaceType,
             reason: v4_1.z
                 .enum([
                 'too_long',

package/dist/events/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/events/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/events/context.ts"],"names":[],"mappings":"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"}

package/dist/events/credentials.d.ts

@@ -1,5 +1,16 @@
 import { z } from 'zod/v4';
 export declare const CREDENTIALS_TELEMETRY: {
+    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: z.ZodObject<{
+            credential_type: z.ZodString;
+            node_type: z.ZodString;
+            workflow_id: z.ZodOptional<z.ZodString>;
+        }, z.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.";
@@ -29,13 +40,13 @@ export declare const CREDENTIALS_TELEMETRY: {
         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: z.ZodObject<{
-            has_description: z.ZodBoolean;
-            description_length: z.ZodNumber;
             user_id: z.ZodString;
             user_role: z.ZodOptional<z.ZodString>;
             credential_id: z.ZodString;
             credential_type: z.ZodString;
-            source: z.ZodLiteral<"backend">;
+            source: z.ZodOptional<z.ZodLiteral<"backend">>;
+            has_description: z.ZodOptional<z.ZodBoolean>;
+            description_length: z.ZodOptional<z.ZodNumber>;
             is_private: z.ZodBoolean;
             uses_external_secrets: z.ZodBoolean;
             jwe_enabled: z.ZodBoolean;

package/dist/events/credentials.js

@@ -13,6 +13,15 @@ const descriptionProperties = {
         .describe('Length of the trimmed, saved description in UTF-16 code units. Zero when absent.'),
 };
 exports.CREDENTIALS_TELEMETRY = (0, define_1.defineTelemetryEvents)({
+    USER_VIEWED_GATEWAY_CREDITS_CREDENTIAL_ERROR_NUDGE: {
+        name: 'User viewed Gateway credits credential error nudge',
+        description: 'The credential modal showed a Gateway credits suggestion after a failed credential test for an eligible workflow node.',
+        properties: v4_1.z.object({
+            credential_type: v4_1.z.string(),
+            node_type: v4_1.z.string(),
+            workflow_id: v4_1.z.string().optional(),
+        }),
+    },
     USER_CREATED_CREDENTIALS: {
         name: 'User created credentials',
         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.',
@@ -47,8 +56,9 @@ exports.CREDENTIALS_TELEMETRY = (0, define_1.defineTelemetryEvents)({
             user_role: v4_1.z.string().optional(),
             credential_id: v4_1.z.string(),
             credential_type: v4_1.z.string(),
-            source: v4_1.z.literal('backend'),
-            ...descriptionProperties,
+            source: v4_1.z.literal('backend').optional(),
+            has_description: descriptionProperties.has_description.optional(),
+            description_length: descriptionProperties.description_length.optional(),
             is_private: v4_1.z.boolean(),
             uses_external_secrets: v4_1.z.boolean(),
             jwe_enabled: v4_1.z.boolean(),

package/dist/events/credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/events/credentials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/events/credentials.ts"],"names":[],"mappings":"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"}

package/dist/events/instance-ai.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod/v4';
+export declare const ASSISTANT_MENTION_QUERY_TEXT_MAX_LENGTH = 100;
 export declare const INSTANCE_AI_TELEMETRY: {
     readonly SETUP_PANEL_STATE_OBSERVED: {
         readonly name: "AI Assistant setup panel state observed";
@@ -322,8 +323,15 @@ export declare const INSTANCE_AI_TELEMETRY: {
     };
     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: z.ZodObject<{
+            mention_counts: z.ZodObject<{
+                total: z.ZodNumber;
+                workflow: z.ZodNumber;
+                node: z.ZodNumber;
+                group: z.ZodNumber;
+            }, z.core.$strip>;
+            attachment_count: z.ZodNumber;
             instance_id: z.ZodString;
             thread_id: z.ZodString;
             run_id: z.ZodString;
@@ -343,6 +351,7 @@ export declare const INSTANCE_AI_TELEMETRY: {
                 credentials_list: "credentials_list";
                 evals: "evals";
                 node_error_view: "node_error_view";
+                onboarding: "onboarding";
                 playwright: "playwright";
                 "template-view": "template-view";
                 unknown: "unknown";
@@ -563,6 +572,108 @@ export declare const INSTANCE_AI_TELEMETRY: {
     } & 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: z.ZodObject<{
+            thread_id: z.ZodNullable<z.ZodString>;
+            source: z.ZodEnum<{
+                button: "button";
+                typed: "typed";
+            }>;
+        }, z.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: z.ZodObject<{
+            thread_id: z.ZodNullable<z.ZodString>;
+            source: z.ZodEnum<{
+                button: "button";
+                typed: "typed";
+            }>;
+            reason: z.ZodEnum<{
+                closed_menu: "closed_menu";
+                deleted_trigger: "deleted_trigger";
+                moved_caret: "moved_caret";
+                unavailable: "unavailable";
+            }>;
+            mode: z.ZodEnum<{
+                browse: "browse";
+                search: "search";
+            }>;
+            query_length: z.ZodNumber;
+            result_count: z.ZodNumber;
+            ambiguous_result_count: z.ZodNumber;
+            submenu_open_count: z.ZodNumber;
+        }, z.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: z.ZodObject<{
+            thread_id: z.ZodNullable<z.ZodString>;
+            source: z.ZodEnum<{
+                button: "button";
+                typed: "typed";
+            }>;
+            query: z.ZodString;
+            query_length: z.ZodNumber;
+            matched_node_type: z.ZodNullable<z.ZodString>;
+            artifact_count: z.ZodNumber;
+        }, z.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: z.ZodObject<{
+            thread_id: z.ZodNullable<z.ZodString>;
+            kind: z.ZodEnum<{
+                group: "group";
+                node: "node";
+                workflow: "workflow";
+            }>;
+            mode: z.ZodEnum<{
+                browse: "browse";
+                search: "search";
+            }>;
+            source: z.ZodEnum<{
+                artifacts: "artifacts";
+                workflows: "workflows";
+            }>;
+            result_position: z.ZodNumber;
+            query_length: z.ZodNumber;
+            already_artifact: z.ZodBoolean;
+            artifact_origin: z.ZodNullable<z.ZodEnum<{
+                attached: "attached";
+                built: "built";
+                fetched: "fetched";
+                mentioned: "mentioned";
+            }>>;
+        }, z.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: z.ZodObject<{
+            thread_id: z.ZodNullable<z.ZodString>;
+            kind: z.ZodEnum<{
+                group: "group";
+                node: "node";
+                workflow: "workflow";
+            }>;
+        }, z.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.";
@@ -576,6 +687,13 @@ export declare const INSTANCE_AI_TELEMETRY: {
                 control: "control";
                 variant: "variant";
             }>>;
+            mention_counts: z.ZodObject<{
+                total: z.ZodNumber;
+                workflow: z.ZodNumber;
+                node: z.ZodNumber;
+                group: z.ZodNumber;
+            }, z.core.$strip>;
+            attachment_count: z.ZodNumber;
             workflow_id: z.ZodOptional<z.ZodString>;
             pending_credential_count: z.ZodOptional<z.ZodNumber>;
             pending_parameter_count: z.ZodOptional<z.ZodNumber>;
@@ -592,6 +710,7 @@ export declare const INSTANCE_AI_TELEMETRY: {
                 credentials_list: "credentials_list";
                 evals: "evals";
                 node_error_view: "node_error_view";
+                onboarding: "onboarding";
                 playwright: "playwright";
                 "template-view": "template-view";
                 unknown: "unknown";
@@ -651,4 +770,142 @@ export declare const INSTANCE_AI_TELEMETRY: {
     } & 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: z.ZodObject<{
+            user_id: z.ZodString;
+            thread_id: z.ZodString;
+            team: z.ZodNullable<z.ZodString>;
+            team_source: z.ZodNullable<z.ZodEnum<{
+                cloud: "cloud";
+                url: "url";
+            }>>;
+        }, z.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: z.ZodObject<{
+            user_id: z.ZodString;
+            thread_id: z.ZodString;
+            team: z.ZodNullable<z.ZodString>;
+            team_source: z.ZodNullable<z.ZodEnum<{
+                card: "card";
+                cloud: "cloud";
+                url: "url";
+            }>>;
+            apps: z.ZodArray<z.ZodString>;
+            custom_text: z.ZodNullable<z.ZodString>;
+        }, z.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: z.ZodObject<{
+            thread_id: z.ZodString;
+            instance_id: z.ZodString;
+            outcome: z.ZodEnum<{
+                build: "build";
+                left: "left";
+                run_failed: "run_failed";
+            }>;
+            leave_reason: z.ZodNullable<z.ZodString>;
+        }, z.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: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            surface: z.ZodEnum<{
+                aia: "aia";
+                mcp: "mcp";
+            }>;
+            user_id: z.ZodString;
+            thread_id: z.ZodOptional<z.ZodString>;
+            run_id: z.ZodString;
+            segment: z.ZodEnum<{
+                resumed: "resumed";
+                suspended: "suspended";
+                whole: "whole";
+            }>;
+            instance_context_enabled: z.ZodBoolean;
+            node_usage_enabled: z.ZodBoolean;
+            context_depth: z.ZodNumber;
+            context_surfaces: z.ZodArray<z.ZodEnum<{
+                "activity-expand": "activity-expand";
+                "activity-list": "activity-list";
+                "node-usage": "node-usage";
+                "workflow-read": "workflow-read";
+            }>>;
+            asked_clarifying_question: z.ZodBoolean;
+            tool_calls: z.ZodNumber;
+            turn_prompt_tokens: z.ZodOptional<z.ZodNumber>;
+            turn_completion_tokens: z.ZodOptional<z.ZodNumber>;
+            turn_total_tokens: z.ZodOptional<z.ZodNumber>;
+            turn_cost_usd: z.ZodOptional<z.ZodNumber>;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                completed: "completed";
+                errored: "errored";
+                suspended: "suspended";
+            }>;
+            block_state: z.ZodLiteral<"absent">;
+            absence_reason: z.ZodEnum<{
+                disabled: "disabled";
+                empty: "empty";
+                failed: "failed";
+                "machine-follow-up": "machine-follow-up";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            surface: z.ZodEnum<{
+                aia: "aia";
+                mcp: "mcp";
+            }>;
+            user_id: z.ZodString;
+            thread_id: z.ZodOptional<z.ZodString>;
+            run_id: z.ZodString;
+            segment: z.ZodEnum<{
+                resumed: "resumed";
+                suspended: "suspended";
+                whole: "whole";
+            }>;
+            instance_context_enabled: z.ZodBoolean;
+            node_usage_enabled: z.ZodBoolean;
+            context_depth: z.ZodNumber;
+            context_surfaces: z.ZodArray<z.ZodEnum<{
+                "activity-expand": "activity-expand";
+                "activity-list": "activity-list";
+                "node-usage": "node-usage";
+                "workflow-read": "workflow-read";
+            }>>;
+            asked_clarifying_question: z.ZodBoolean;
+            tool_calls: z.ZodNumber;
+            turn_prompt_tokens: z.ZodOptional<z.ZodNumber>;
+            turn_completion_tokens: z.ZodOptional<z.ZodNumber>;
+            turn_total_tokens: z.ZodOptional<z.ZodNumber>;
+            turn_cost_usd: z.ZodOptional<z.ZodNumber>;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                completed: "completed";
+                errored: "errored";
+                suspended: "suspended";
+            }>;
+            block_state: z.ZodLiteral<"injected">;
+            block_is_update: z.ZodBoolean;
+            block_inventory_rows: z.ZodNumber;
+            block_event_rows: z.ZodNumber;
+            block_run_rows: z.ZodNumber;
+            block_chars: z.ZodNumber;
+            block_tokens_estimated: z.ZodNumber;
+        }, z.core.$strict>]>;
+    } & import("../define").TelemetryEventInput & {
+        readonly getValidationError: (properties: unknown) => string | null;
+    };
 };