@n8n/telemetry 1.3.1 → 1.5.0

package/dist/events/workflow-reviews.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_REVIEWS_TELEMETRY = void 0;
+const v4_1 = require("zod/v4");
+const define_1 = require("../define");
+exports.WORKFLOW_REVIEWS_TELEMETRY = (0, define_1.defineTelemetryEvents)({
+    USER_REQUESTED_WORKFLOW_REVIEW: {
+        name: 'User requested workflow review',
+        description: 'A workflow was submitted for review, opening a review request. Fires once per opened review, not on a later re-pin.',
+        properties: v4_1.z.object({
+            user_id: v4_1.z.string(),
+            workflow_review_request_id: v4_1.z.string(),
+            project_id: v4_1.z.string().describe('Owning project when the review opened'),
+            workflow_id: v4_1.z.string(),
+            workflow_version_id: v4_1.z.string(),
+            reviewer_count: v4_1.z
+                .number()
+                .describe('Reviewers assigned when the review opened, not everyone eligible to review'),
+        }),
+    },
+    USER_UPDATED_WORKFLOW_VERSION_UNDER_REVIEW: {
+        name: 'User updated workflow version under review',
+        description: 'An open review was re-pinned to another version of the workflow it covers. Fires only on a real re-pin, not on a rename or a description edit.',
+        properties: v4_1.z.object({
+            user_id: v4_1.z.string(),
+            workflow_review_request_id: v4_1.z.string(),
+            workflow_id: v4_1.z.string(),
+            workflow_version_id: v4_1.z.string().describe('The newly pinned version, not the previous one'),
+        }),
+    },
+    USER_DECIDED_WORKFLOW_REVIEW: {
+        name: 'User decided workflow review',
+        description: 'A user approved a review or requested changes on it. Fires once per decision, so a review can appear several times.',
+        properties: v4_1.z.object({
+            user_id: v4_1.z.string(),
+            workflow_review_request_id: v4_1.z.string(),
+            workflow_id: v4_1.z.string(),
+            workflow_version_id: v4_1.z
+                .string()
+                .nullable()
+                .describe('Null when the pinned version was pruned before the decision'),
+            decision: v4_1.z.enum(['approved', 'changes_requested']),
+            decided_via: v4_1.z
+                .enum(['assigned-reviewer', 'admin-override'])
+                .describe("'assigned-reviewer' = the decider was assigned to this review; 'admin-override' = they decided through an instance or project admin role. Assignment wins when both apply"),
+            review_created_at: v4_1.z.string().describe('When the review was opened, ISO 8601'),
+        }),
+    },
+    WORKFLOW_REVIEW_CLOSED: {
+        name: 'Workflow review closed',
+        description: 'An open review was closed without a decision because no reviewable workflow was left on it. No user performs it.',
+        properties: v4_1.z.object({
+            workflow_review_request_id: v4_1.z.string(),
+            cause_trigger: v4_1.z
+                .enum(['workflow-archived', 'workflow-moved', 'workflow-deleted', 'unknown'])
+                .describe('What left the review without a reviewable workflow. "unknown" means the trigger went unrecorded and the review was swept up later, not that nothing triggered it'),
+            cause_actor_kind: v4_1.z
+                .enum(['user', 'system'])
+                .describe('Who caused the trigger, not who closed the review. "system" means no actor was recorded, not that automation acted'),
+        }),
+    },
+    USER_COMMENTED_ON_WORKFLOW_REVIEW: {
+        name: 'User commented on workflow review',
+        description: 'A comment was posted on an open review.',
+        properties: v4_1.z.object({
+            user_id: v4_1.z.string(),
+            workflow_review_request_id: v4_1.z.string(),
+        }),
+    },
+});
+//# sourceMappingURL=workflow-reviews.js.map

package/dist/events/workflow-reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-reviews.js","sourceRoot":"","sources":["../../src/events/workflow-reviews.ts"],"names":[],"mappings":";;;AAAA,+BAA2B;AAE3B,sCAAkD;AAErC,QAAA,0BAA0B,GAAG,IAAA,8BAAqB,EAAC;IAC/D,8BAA8B,EAAE;QAC/B,IAAI,EAAE,gCAAgC;QACtC,WAAW,EACV,qHAAqH;QACtH,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,MAAC,CAAC,MAAM,EAAE;YACnB,0BAA0B,EAAE,MAAC,CAAC,MAAM,EAAE;YACtC,UAAU,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACxE,WAAW,EAAE,MAAC,CAAC,MAAM,EAAE;YACvB,mBAAmB,EAAE,MAAC,CAAC,MAAM,EAAE;YAC/B,cAAc,EAAE,MAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,CAAC,4EAA4E,CAAC;SACxF,CAAC;KACF;IACD,0CAA0C,EAAE;QAC3C,IAAI,EAAE,4CAA4C;QAClD,WAAW,EACV,gJAAgJ;QACjJ,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,MAAC,CAAC,MAAM,EAAE;YACnB,0BAA0B,EAAE,MAAC,CAAC,MAAM,EAAE;YACtC,WAAW,EAAE,MAAC,CAAC,MAAM,EAAE;YACvB,mBAAmB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;SAC1F,CAAC;KACF;IACD,4BAA4B,EAAE;QAC7B,IAAI,EAAE,8BAA8B;QACpC,WAAW,EACV,qHAAqH;QACtH,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,MAAC,CAAC,MAAM,EAAE;YACnB,0BAA0B,EAAE,MAAC,CAAC,MAAM,EAAE;YACtC,WAAW,EAAE,MAAC,CAAC,MAAM,EAAE;YACvB,mBAAmB,EAAE,MAAC;iBACpB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6DAA6D,CAAC;YACzE,QAAQ,EAAE,MAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;YACnD,WAAW,EAAE,MAAC;iBACZ,IAAI,CAAC,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;iBAC7C,QAAQ,CACR,2KAA2K,CAC3K;YACF,iBAAiB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SAC9E,CAAC;KACF;IACD,sBAAsB,EAAE;QACvB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACV,kHAAkH;QACnH,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,0BAA0B,EAAE,MAAC,CAAC,MAAM,EAAE;YACtC,aAAa,EAAE,MAAC;iBACd,IAAI,CAAC,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,SAAS,CAAC,CAAC;iBAC5E,QAAQ,CACR,kKAAkK,CAClK;YACF,gBAAgB,EAAE,MAAC;iBACjB,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;iBACxB,QAAQ,CACR,oHAAoH,CACpH;SACF,CAAC;KACF;IACD,iCAAiC,EAAE;QAClC,IAAI,EAAE,mCAAmC;QACzC,WAAW,EAAE,yCAAyC;QACtD,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,MAAC,CAAC,MAAM,EAAE;YACnB,0BAA0B,EAAE,MAAC,CAAC,MAAM,EAAE;SACtC,CAAC;KACF;CACD,CAAC,CAAC"}

package/dist/events/workflow.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod/v4';
+export declare const WORKFLOW_TELEMETRY: {
+    readonly NODE_IDS_HEALED: {
+        readonly name: "Workflow node ids healed";
+        readonly description: "A published version about to be activated carried duplicate or missing node ids, so a corrected system-authored version was published in its place. `superseded` means the corrected version lost against a concurrent publish or unpublish and was discarded.";
+        readonly properties: z.ZodObject<{
+            workflow_id: z.ZodString;
+            filled_count: z.ZodNumber;
+            reassigned_count: z.ZodNumber;
+            dropped_count: z.ZodNumber;
+            superseded: z.ZodBoolean;
+        }, z.core.$strip>;
+    } & import("../define").TelemetryEventInput & {
+        readonly getValidationError: (properties: unknown) => string | null;
+    };
+};

package/dist/events/workflow.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_TELEMETRY = void 0;
+const v4_1 = require("zod/v4");
+const define_1 = require("../define");
+exports.WORKFLOW_TELEMETRY = (0, define_1.defineTelemetryEvents)({
+    NODE_IDS_HEALED: {
+        name: 'Workflow node ids healed',
+        description: 'A published version about to be activated carried duplicate or missing node ids, so a corrected system-authored version was published in its place. `superseded` means the corrected version lost against a concurrent publish or unpublish and was discarded.',
+        properties: v4_1.z.object({
+            workflow_id: v4_1.z.string(),
+            filled_count: v4_1.z.number().describe('Nodes that had no id and received a fresh one'),
+            reassigned_count: v4_1.z
+                .number()
+                .describe('Nodes that shared their id with another node and received a fresh one'),
+            dropped_count: v4_1.z
+                .number()
+                .describe('Exact same-name duplicates removed in favor of their last occurrence'),
+            superseded: v4_1.z
+                .boolean()
+                .describe('Whether the corrected version lost the publish race and was discarded'),
+        }),
+    },
+});
+//# sourceMappingURL=workflow.js.map

package/dist/events/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/events/workflow.ts"],"names":[],"mappings":";;;AAAA,+BAA2B;AAE3B,sCAAkD;AAErC,QAAA,kBAAkB,GAAG,IAAA,8BAAqB,EAAC;IACvD,eAAe,EAAE;QAChB,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACV,gQAAgQ;QACjQ,UAAU,EAAE,MAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,MAAC,CAAC,MAAM,EAAE;YACvB,YAAY,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;YAClF,gBAAgB,EAAE,MAAC;iBACjB,MAAM,EAAE;iBACR,QAAQ,CAAC,uEAAuE,CAAC;YACnF,aAAa,EAAE,MAAC;iBACd,MAAM,EAAE;iBACR,QAAQ,CAAC,sEAAsE,CAAC;YAClF,UAAU,EAAE,MAAC;iBACX,OAAO,EAAE;iBACT,QAAQ,CAAC,uEAAuE,CAAC;SACnF,CAAC;KACF;CACD,CAAC,CAAC"}

package/dist/index.d.ts

@@ -3,5 +3,7 @@ export type { TelemetryCatalogEntry, TelemetryCatalogProperty } from './catalog'
 export { POSTHOG_EVENTS_BLACKLIST } from './constants';
 export { defineTelemetryEvents } from './define';
 export type { InferTelemetryProps, TelemetryEventDef, TelemetryEventInput, TelemetryEventRegistry, } from './define';
+export { redactTelemetryProperties, redactTelemetryText } from './redaction';
+export type { TelemetryTextOptions } from './redaction';
 export { collectDuplicateNames, validateEntrySchemas } from './registry-checks';
 export { TELEMETRY_EVENT } from './telemetry-events';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TELEMETRY_EVENT = exports.validateEntrySchemas = exports.collectDuplicateNames = exports.defineTelemetryEvents = exports.POSTHOG_EVENTS_BLACKLIST = exports.formatCatalog = exports.buildCatalog = void 0;
+exports.TELEMETRY_EVENT = exports.validateEntrySchemas = exports.collectDuplicateNames = exports.redactTelemetryText = exports.redactTelemetryProperties = exports.defineTelemetryEvents = exports.POSTHOG_EVENTS_BLACKLIST = exports.formatCatalog = exports.buildCatalog = void 0;
 var catalog_1 = require("./catalog");
 Object.defineProperty(exports, "buildCatalog", { enumerable: true, get: function () { return catalog_1.buildCatalog; } });
 Object.defineProperty(exports, "formatCatalog", { enumerable: true, get: function () { return catalog_1.formatCatalog; } });
@@ -8,6 +8,9 @@ var constants_1 = require("./constants");
 Object.defineProperty(exports, "POSTHOG_EVENTS_BLACKLIST", { enumerable: true, get: function () { return constants_1.POSTHOG_EVENTS_BLACKLIST; } });
 var define_1 = require("./define");
 Object.defineProperty(exports, "defineTelemetryEvents", { enumerable: true, get: function () { return define_1.defineTelemetryEvents; } });
+var redaction_1 = require("./redaction");
+Object.defineProperty(exports, "redactTelemetryProperties", { enumerable: true, get: function () { return redaction_1.redactTelemetryProperties; } });
+Object.defineProperty(exports, "redactTelemetryText", { enumerable: true, get: function () { return redaction_1.redactTelemetryText; } });
 var registry_checks_1 = require("./registry-checks");
 Object.defineProperty(exports, "collectDuplicateNames", { enumerable: true, get: function () { return registry_checks_1.collectDuplicateNames; } });
 Object.defineProperty(exports, "validateEntrySchemas", { enumerable: true, get: function () { return registry_checks_1.validateEntrySchemas; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAwD;AAA/C,uGAAA,YAAY,OAAA;AAAE,wGAAA,aAAa,OAAA;AAEpC,yCAAuD;AAA9C,qHAAA,wBAAwB,OAAA;AACjC,mCAAiD;AAAxC,+GAAA,qBAAqB,OAAA;AAO9B,qDAAgF;AAAvE,wHAAA,qBAAqB,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AACpD,uDAAqD;AAA5C,mHAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAwD;AAA/C,uGAAA,YAAY,OAAA;AAAE,wGAAA,aAAa,OAAA;AAEpC,yCAAuD;AAA9C,qHAAA,wBAAwB,OAAA;AACjC,mCAAiD;AAAxC,+GAAA,qBAAqB,OAAA;AAO9B,yCAA6E;AAApE,sHAAA,yBAAyB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAEvD,qDAAgF;AAAvE,wHAAA,qBAAqB,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AACpD,uDAAqD;AAA5C,mHAAA,eAAe,OAAA"}

package/dist/redaction.d.ts

@@ -0,0 +1,7 @@
+type TelemetryValue = string | number | boolean | object | null | undefined;
+export interface TelemetryTextOptions {
+    maxLength?: number;
+}
+export declare function redactTelemetryText(value: string, opts?: TelemetryTextOptions): string;
+export declare function redactTelemetryProperties<T extends Record<string, TelemetryValue>>(properties: T): Record<string, TelemetryValue>;
+export {};

package/dist/redaction.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactTelemetryText = redactTelemetryText;
+exports.redactTelemetryProperties = redactTelemetryProperties;
+const pii_patterns_1 = require("@n8n/utils/redaction/pii-patterns");
+const redact_text_1 = require("@n8n/utils/redaction/redact-text");
+const TELEMETRY_REDACTION_OPTIONS = {
+    secrets: true,
+    detect: pii_patterns_1.SUPPORTED_PII_CATEGORIES,
+    preserveUrlStructure: true,
+};
+const MAX_TELEMETRY_TEXT_LENGTH = 8_000;
+const IDENTIFIER_KEY_PATTERN = /(?:^|_)(?:id|ids|hash)$/;
+const SECRET_KEY_PATTERN = /(?:^|_)(?:password|passwd|pwd|secret|token|api_?key|apikey|access_?token|refresh_?token|id_?token|session_?token|auth_?token|authorization|cookie|private_?key)$/i;
+function toSnakeCase(key) {
+    return key.replace(/([a-z0-9])([A-Z])/g, '$1_$2').replace(/-/g, '_');
+}
+const MAX_PROPERTY_DEPTH = 5;
+const OVER_DEPTH_MARKER = '[REDACTED_DEPTH]';
+function redactTelemetryText(value, opts = {}) {
+    const maxLength = opts.maxLength ?? MAX_TELEMETRY_TEXT_LENGTH;
+    const redacted = (0, redact_text_1.redactText)(value, TELEMETRY_REDACTION_OPTIONS).text;
+    return redacted.length > maxLength ? `${redacted.slice(0, maxLength)}...` : redacted;
+}
+function isNonNullObject(value) {
+    return value !== null && typeof value === 'object';
+}
+function redactPropertyValue(key, value, depth) {
+    if (SECRET_KEY_PATTERN.test(toSnakeCase(key)) &&
+        (typeof value === 'string' || isNonNullObject(value))) {
+        return redact_text_1.DEFAULT_PLACEHOLDER;
+    }
+    if (typeof value === 'string') {
+        return IDENTIFIER_KEY_PATTERN.test(key) ? value : redactTelemetryText(value);
+    }
+    if (Array.isArray(value)) {
+        if (depth >= MAX_PROPERTY_DEPTH)
+            return OVER_DEPTH_MARKER;
+        return value.map((entry) => redactPropertyValue(key, entry, depth + 1));
+    }
+    if (isNonNullObject(value)) {
+        if (depth >= MAX_PROPERTY_DEPTH)
+            return OVER_DEPTH_MARKER;
+        const redacted = {};
+        for (const [nestedKey, nestedValue] of Object.entries(value)) {
+            redacted[nestedKey] = redactPropertyValue(nestedKey, nestedValue, depth + 1);
+        }
+        return redacted;
+    }
+    return value;
+}
+function redactTelemetryProperties(properties) {
+    const redacted = {};
+    for (const [key, value] of Object.entries(properties)) {
+        redacted[key] = redactPropertyValue(key, value, 0);
+    }
+    return redacted;
+}
+//# sourceMappingURL=redaction.js.map

package/dist/redaction.js.map

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

package/dist/telemetry-events.d.ts

@@ -823,7 +823,7 @@ export declare const TELEMETRY_EVENT: {
         };
         readonly USER_STARTED_ADDING_AGENT_TOOL: {
             readonly name: "User started adding agent tool";
-            readonly description: "The user clicked Connect on an available row in the tools modal, starting a new tool flow.";
+            readonly description: "The user started adding an available tool manually by connecting it or creating a workflow.";
             readonly properties: import("zod/v4").ZodObject<{
                 tool_type: import("zod/v4").ZodEnum<{
                     custom: "custom";
@@ -996,6 +996,190 @@ export declare const TELEMETRY_EVENT: {
         };
     };
     INSTANCE_AI: {
+        readonly USER_CLICKED_AI_CREDIT_BALANCE: {
+            readonly name: "User clicked AI credit balance";
+            readonly description: "The user clicked the AI Assistant credit balance button to open or close the balance dropdown.";
+            readonly properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly FREE_NUDGE_EXPOSED: {
+            readonly name: "Instance AI free nudge exposed";
+            readonly description: "An eligible user reached the Instance AI empty state for the free-use nudge experiment, including the control variant.";
+            readonly properties: import("zod/v4").ZodObject<{
+                variant: import("zod/v4").ZodEnum<{
+                    control: "control";
+                    "variant-1": "variant-1";
+                    "variant-2": "variant-2";
+                }>;
+                '$feature/105_instance_ai_free_nudge': import("zod/v4").ZodEnum<{
+                    control: "control";
+                    "variant-1": "variant-1";
+                    "variant-2": "variant-2";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly FREE_NUDGE_DISMISSED: {
+            readonly name: "Instance AI free nudge dismissed";
+            readonly description: "The user dismissed a visible Instance AI free-use nudge.";
+            readonly properties: import("zod/v4").ZodObject<{
+                variant: import("zod/v4").ZodEnum<{
+                    "variant-1": "variant-1";
+                    "variant-2": "variant-2";
+                }>;
+                '$feature/105_instance_ai_free_nudge': import("zod/v4").ZodEnum<{
+                    "variant-1": "variant-1";
+                    "variant-2": "variant-2";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_CLICKED_AI_ASSISTANT_INPUT_PLUS_BUTTON: {
+            readonly name: "User clicked AI Assistant input plus button";
+            readonly description: "The user clicked the plus button in the AI Assistant input.";
+            readonly properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly TOOLS_LIST_OPENED: {
+            readonly name: "Instance AI tools list opened";
+            readonly description: "The user opened the AI Assistant tools connection modal.";
+            readonly properties: import("zod/v4").ZodObject<{
+                source: import("zod/v4").ZodEnum<{
+                    input_menu: "input_menu";
+                    mcp_connect_card: "mcp_connect_card";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_SETTINGS_OPENED: {
+            readonly name: "Instance AI mcp settings opened";
+            readonly description: "The user opened settings for an MCP connection in the AI Assistant.";
+            readonly properties: import("zod/v4").ZodObject<{
+                server_slug: import("zod/v4").ZodString;
+                source: import("zod/v4").ZodEnum<{
+                    input_menu: "input_menu";
+                    mcp_connect_card: "mcp_connect_card";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_FIRST_CREDENTIAL_CONNECTION_STARTED: {
+            readonly name: "Instance AI mcp first credential connection start";
+            readonly description: "The user started connecting the first credential for an MCP server.";
+            readonly properties: import("zod/v4").ZodObject<{
+                server_slug: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_CREDENTIAL_DROPDOWN_OPENED: {
+            readonly name: "Instance AI mcp credential dropdown opened";
+            readonly description: "The user opened the credential dropdown for an MCP server.";
+            readonly properties: import("zod/v4").ZodObject<{
+                server_slug: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_EXISTING_CREDENTIAL_SELECTED: {
+            readonly name: "Instance AI mcp existing credential selected";
+            readonly description: "The user selected an existing credential for an MCP server.";
+            readonly properties: import("zod/v4").ZodObject<{
+                server_slug: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_NEW_CREDENTIAL_CONNECTION_STARTED: {
+            readonly name: "Instance AI mcp new credential connection start";
+            readonly description: "The user started connecting a new credential for an MCP server.";
+            readonly properties: import("zod/v4").ZodObject<{
+                server_slug: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly MCP_TOOL_FILTER_SETTINGS_UPDATED: {
+            readonly name: "Instance AI mcp tool filter settings updated";
+            readonly description: "The user updated which tools are enabled for an MCP server.";
+            readonly properties: import("zod/v4").ZodObject<{
+                server_slug: import("zod/v4").ZodString;
+                inclusion_mode: import("zod/v4").ZodEnum<{
+                    all: "all";
+                    except: "except";
+                    selected: "selected";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly BROWSER_USE_MODAL_OPENED: {
+            readonly name: "Instance AI Connect Browser Use modal opened";
+            readonly description: "The user opened the Browser Use connection interface.";
+            readonly properties: import("zod/v4").ZodObject<{
+                browser_supported: import("zod/v4").ZodBoolean;
+                source: import("zod/v4").ZodEnum<{
+                    credential_setup: "credential_setup";
+                    input_menu: "input_menu";
+                    tools_modal: "tools_modal";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly BROWSER_USE_INSTALL_EXTENSION_CLICKED: {
+            readonly name: "Instance AI Install Chrome Browser Extension button clicked";
+            readonly description: "The user clicked the button to install the Browser Use Chrome extension.";
+            readonly properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly BROWSER_USE_OPEN_EXTENSION_CLICKED: {
+            readonly name: "Instance AI Open Browser Use Extension button clicked";
+            readonly description: "The user clicked the button to open the Browser Use extension.";
+            readonly properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly BROWSER_USE_DIRECT_CONNECT_REQUESTED: {
+            readonly name: "Instance AI Browser Use direct connect requested";
+            readonly description: "The AI Assistant requested a direct connection through the Browser Use extension.";
+            readonly properties: import("zod/v4").ZodObject<{}, 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.";
+            readonly properties: import("zod/v4").ZodObject<{
+                is_connected: import("zod/v4").ZodBoolean;
+                source: import("zod/v4").ZodEnum<{
+                    input_menu: "input_menu";
+                    tools_modal: "tools_modal";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly COMPUTER_USE_CONNECTION_COMMAND_COPIED: {
+            readonly name: "User copied computer use connection command";
+            readonly description: "The user copied the Computer Use connection command.";
+            readonly properties: import("zod/v4").ZodObject<{
+                os: import("zod/v4").ZodEnum<{
+                    linux: "linux";
+                    mac: "mac";
+                    windows: "windows";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
         readonly BUILDER_SPECCED_TEMPLATED_CRED: {
             readonly name: "Builder specced templated cred";
             readonly description: "The Instance AI workflow builder composed a Simplified Custom Auth recipe (credentialHints) and suspended to show its setup card. Captures the recipe fields so template and link quality are observable in production — one event per recipe in the suspension. Contains no secrets by construction: recipes are agent-authored before any user input.";
@@ -1154,4 +1338,170 @@ export declare const TELEMETRY_EVENT: {
             readonly getValidationError: (properties: unknown) => string | null;
         };
     };
+    MCP: {
+        readonly USER_GAVE_MCP_ACCESS_TO_WORKFLOW: {
+            readonly name: "User gave MCP access to workflow";
+            readonly description: "A workflow was exposed over MCP.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_TOGGLED_MCP_ACCESS: {
+            readonly name: "User toggled MCP access";
+            readonly description: "An admin turned instance-level MCP access on or off. Reports the resulting state.";
+            readonly properties: import("zod/v4").ZodObject<{
+                state: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_CLICKED_CONNECT_CLIENT: {
+            readonly name: "User clicked connect MCP client";
+            readonly description: "A user opened the connect-client dialog. Heads the client setup funnel: sessions carrying this event without a follow-up copy or token fetch are the ones abandoning the one-click setup.";
+            readonly properties: import("zod/v4").ZodObject<{
+                source: import("zod/v4").ZodEnum<{
+                    settings: "settings";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_VIEWED_ALL_MCP_CLIENTS: {
+            readonly name: "User viewed all MCP clients";
+            readonly description: "An admin switched the connected-clients page from their own consents to the whole instance's. Only the switch is reported, so landing on the page emits nothing.";
+            readonly properties: import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_REVOKED_MCP_CLIENT_ACCESS: {
+            readonly name: "User revoked MCP client access";
+            readonly description: "A connected client's MCP access was revoked from the connected-clients page. Fires once the revoke succeeds, so opening the confirmation dialog and cancelling emits nothing.";
+            readonly properties: import("zod/v4").ZodObject<{
+                client_id: import("zod/v4").ZodString;
+                client_brand: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    claude: "claude";
+                    cursor: "cursor";
+                    openai: "openai";
+                    vscode: "vscode";
+                }>>;
+                client_type: import("zod/v4").ZodNullable<import("zod/v4").ZodEnum<{
+                    assistant: "assistant";
+                    cli: "cli";
+                    editor: "editor";
+                    ide: "ide";
+                }>>;
+                revoked_for_other: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly AUTO_EXPOSE_NEW_WORKFLOWS_TOGGLED: {
+            readonly name: "User toggled auto-expose new workflows to MCP";
+            readonly description: "An admin turned the \"Auto-expose new workflows\" MCP setting on or off. Reports the resulting state so enabling and disabling are distinguishable.";
+            readonly properties: import("zod/v4").ZodObject<{
+                enabled: import("zod/v4").ZodBoolean;
+                source: import("zod/v4").ZodEnum<{
+                    expose_all: "expose_all";
+                    settings: "settings";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
+    WORKFLOW: {
+        readonly NODE_IDS_HEALED: {
+            readonly name: "Workflow node ids healed";
+            readonly description: "A published version about to be activated carried duplicate or missing node ids, so a corrected system-authored version was published in its place. `superseded` means the corrected version lost against a concurrent publish or unpublish and was discarded.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_id: import("zod/v4").ZodString;
+                filled_count: import("zod/v4").ZodNumber;
+                reassigned_count: import("zod/v4").ZodNumber;
+                dropped_count: import("zod/v4").ZodNumber;
+                superseded: import("zod/v4").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
+    WORKFLOW_REVIEWS: {
+        readonly USER_REQUESTED_WORKFLOW_REVIEW: {
+            readonly name: "User requested workflow review";
+            readonly description: "A workflow was submitted for review, opening a review request. Fires once per opened review, not on a later re-pin.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodString;
+                workflow_review_request_id: import("zod/v4").ZodString;
+                project_id: import("zod/v4").ZodString;
+                workflow_id: import("zod/v4").ZodString;
+                workflow_version_id: import("zod/v4").ZodString;
+                reviewer_count: import("zod/v4").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_UPDATED_WORKFLOW_VERSION_UNDER_REVIEW: {
+            readonly name: "User updated workflow version under review";
+            readonly description: "An open review was re-pinned to another version of the workflow it covers. Fires only on a real re-pin, not on a rename or a description edit.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodString;
+                workflow_review_request_id: import("zod/v4").ZodString;
+                workflow_id: import("zod/v4").ZodString;
+                workflow_version_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_DECIDED_WORKFLOW_REVIEW: {
+            readonly name: "User decided workflow review";
+            readonly description: "A user approved a review or requested changes on it. Fires once per decision, so a review can appear several times.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodString;
+                workflow_review_request_id: import("zod/v4").ZodString;
+                workflow_id: import("zod/v4").ZodString;
+                workflow_version_id: import("zod/v4").ZodNullable<import("zod/v4").ZodString>;
+                decision: import("zod/v4").ZodEnum<{
+                    approved: "approved";
+                    changes_requested: "changes_requested";
+                }>;
+                decided_via: import("zod/v4").ZodEnum<{
+                    "admin-override": "admin-override";
+                    "assigned-reviewer": "assigned-reviewer";
+                }>;
+                review_created_at: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly WORKFLOW_REVIEW_CLOSED: {
+            readonly name: "Workflow review closed";
+            readonly description: "An open review was closed without a decision because no reviewable workflow was left on it. No user performs it.";
+            readonly properties: import("zod/v4").ZodObject<{
+                workflow_review_request_id: import("zod/v4").ZodString;
+                cause_trigger: import("zod/v4").ZodEnum<{
+                    unknown: "unknown";
+                    "workflow-archived": "workflow-archived";
+                    "workflow-deleted": "workflow-deleted";
+                    "workflow-moved": "workflow-moved";
+                }>;
+                cause_actor_kind: import("zod/v4").ZodEnum<{
+                    system: "system";
+                    user: "user";
+                }>;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+        readonly USER_COMMENTED_ON_WORKFLOW_REVIEW: {
+            readonly name: "User commented on workflow review";
+            readonly description: "A comment was posted on an open review.";
+            readonly properties: import("zod/v4").ZodObject<{
+                user_id: import("zod/v4").ZodString;
+                workflow_review_request_id: import("zod/v4").ZodString;
+            }, import("zod/v4/core").$strip>;
+        } & import("./define").TelemetryEventInput & {
+            readonly getValidationError: (properties: unknown) => string | null;
+        };
+    };
 };

package/dist/telemetry-events.js

@@ -5,12 +5,18 @@ const agents_1 = require("./events/agents");
 const credentials_1 = require("./events/credentials");
 const instance_1 = require("./events/instance");
 const instance_ai_1 = require("./events/instance-ai");
+const mcp_1 = require("./events/mcp");
 const platform_1 = require("./events/platform");
+const workflow_1 = require("./events/workflow");
+const workflow_reviews_1 = require("./events/workflow-reviews");
 exports.TELEMETRY_EVENT = {
     PLATFORM: platform_1.PLATFORM_TELEMETRY,
     AGENTS: agents_1.AGENTS_TELEMETRY,
     CREDENTIALS: credentials_1.CREDENTIALS_TELEMETRY,
     INSTANCE: instance_1.INSTANCE_TELEMETRY,
     INSTANCE_AI: instance_ai_1.INSTANCE_AI_TELEMETRY,
+    MCP: mcp_1.MCP_TELEMETRY,
+    WORKFLOW: workflow_1.WORKFLOW_TELEMETRY,
+    WORKFLOW_REVIEWS: workflow_reviews_1.WORKFLOW_REVIEWS_TELEMETRY,
 };
 //# sourceMappingURL=telemetry-events.js.map

package/dist/telemetry-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-events.js","sourceRoot":"","sources":["../src/telemetry-events.ts"],"names":[],"mappings":";;;AACA,4CAAmD;AACnD,sDAA6D;AAC7D,gDAAuD;AACvD,sDAA6D;AAC7D,gDAAuD;AAE1C,QAAA,eAAe,GAAG;IAC9B,QAAQ,EAAE,6BAAkB;IAC5B,MAAM,EAAE,yBAAgB;IACxB,WAAW,EAAE,mCAAqB;IAClC,QAAQ,EAAE,6BAAkB;IAC5B,WAAW,EAAE,mCAAqB;CACD,CAAC"}
+{"version":3,"file":"telemetry-events.js","sourceRoot":"","sources":["../src/telemetry-events.ts"],"names":[],"mappings":";;;AACA,4CAAmD;AACnD,sDAA6D;AAC7D,gDAAuD;AACvD,sDAA6D;AAC7D,sCAA6C;AAC7C,gDAAuD;AACvD,gDAAuD;AACvD,gEAAuE;AAE1D,QAAA,eAAe,GAAG;IAC9B,QAAQ,EAAE,6BAAkB;IAC5B,MAAM,EAAE,yBAAgB;IACxB,WAAW,EAAE,mCAAqB;IAClC,QAAQ,EAAE,6BAAkB;IAC5B,WAAW,EAAE,mCAAqB;IAClC,GAAG,EAAE,mBAAa;IAClB,QAAQ,EAAE,6BAAkB;IAC5B,gBAAgB,EAAE,6CAA0B;CACX,CAAC"}