rivet-design 0.17.4 → 0.18.0

package/dist/services/TelemetryService.js

@@ -17,13 +17,7 @@ const KNOWN_MCP_EDITORS = new Set([
     'claude',
     'claude-desktop',
 ]);
-/** Commands that run as lifecycle plumbing rather than a person (or their
- *  agent) driving Rivet: the stale-registration `mcp` tombstone, the
- *  automatic-update bootstrap, and the internal `__serve` daemon. Their
- *  `cli_command_completed` events carry `is_product_use: false` so
- *  active-user metrics can exclude them. */
 const LIFECYCLE_CLI_COMMANDS = new Set(['mcp', 'update', '__serve', '__hub']);
-/** Normalizes CLI `--editor` values onto PostHog `mcp_editor` for dashboards. */
 const mcpEditorEventValue = (editor) => {
     if (editor === undefined || editor === '') {
         return 'claude';
@@ -37,7 +31,16 @@ const mcpEditorEventValue = (editor) => {
 const POSTHOG_PUBLIC_API_KEY = 'phc_Ntj9tXHbS64XgYxlTfhglRmFivFsfm0AERph4ZlnNH';
 const HASH_PREFIX_LENGTH = 12;
 class TelemetryService {
-    /** Records shared-library outcomes without project paths, labels, or exception content. */
+    trackProfileOperation(data) {
+        this.track(`mcp_profile_${data.stage}_${data.outcome}`, {
+            operation: data.operation,
+            duration_ms: data.durationMs,
+            ...(data.referenceCount !== undefined
+                ? { reference_count: data.referenceCount }
+                : {}),
+            ...(data.status ? { status: data.status } : {}),
+        });
+    }
     trackLibraryOperation(data) {
         this.track(`library_${data.operation}_${data.outcome}`, {
             duration_ms: data.durationMs,
@@ -51,9 +54,7 @@ class TelemetryService {
     }
     posthog = null;
     isEnabled;
-    /** Default `source` stamped on every event (overridable per-call). */
     defaultSource;
-    /** MCP editor (`--editor`) stamped on events when present. */
     editor;
     constructor(options = true) {
         const opts = typeof options === 'boolean' ? { enabled: options } : options;
@@ -69,9 +70,6 @@ class TelemetryService {
                     personProfiles: 'always',
                 });
                 this.identifyUser();
-                // Forward every log.error() call to PostHog as a structured event.
-                // Keeps error visibility in our analytics dashboard in sync with what
-                // the logger sees, without needing a separate log aggregation pipeline.
                 (0, logger_1.registerErrorCapture)((message, args, service) => {
                     const errorArg = args.find((a) => a instanceof Error);
                     const MAX_DETAIL_LENGTH = 512;
@@ -91,7 +89,6 @@ class TelemetryService {
                 log.debug('Telemetry initialized');
             }
             catch (error) {
-                // Use stderr directly so this is visible even if log is broken.
                 process.stderr.write(`[TelemetryService] Init failed — error capture and PostHog events DISABLED: ${error}\n`);
                 log.warn('Telemetry failed to initialize (MCP events will not be sent):', error);
                 this.isEnabled = false;
@@ -101,45 +98,26 @@ class TelemetryService {
             log.debug('Telemetry disabled');
         }
     }
-    /**
-     * Returns the canonical analytics identity: the Supabase user id when known,
-     * else the email, else a stable anonymous ID. Keying on user id means the
-     * same human is one PostHog person across surfaces and survives email changes.
-     */
     get distinctId() {
         const cm = (0, ConfigManager_1.getConfigManager)();
         return cm.getUserId() ?? cm.getEmail() ?? cm.getAnonymousId();
     }
-    /**
-     * Identify the user in PostHog keyed on the canonical Supabase user id, and
-     * merge their prior identities (email + anonymous ID) into it so history is
-     * not split. `source` is intentionally NOT set as a person property — it is
-     * an event property so the person stays merged across surfaces.
-     *
-     * No-op if the current user id has already been aliased+identified in a prior
-     * run: posthog-node has no dedup, and this is called from the constructor on
-     * every CLI/server process start. Without persistence we'd emit a
-     * $create_alias event on every invocation.
-     */
     identifyUser() {
         if (!this.isEnabled || !this.posthog)
             return;
         const cm = (0, ConfigManager_1.getConfigManager)();
         const userId = cm.getUserId();
         const email = cm.getEmail();
-        // Without a user id we can't canonicalize; wait until login provides one.
         if (!userId)
             return;
         if (cm.getTelemetryIdentifiedUserId() === userId)
             return;
         try {
             const anonymousId = cm.getAnonymousId();
-            // Merge pre-login anonymous events into the canonical person.
             this.posthog.alias({
                 distinctId: userId,
                 alias: anonymousId,
             });
-            // Merge any historical email-keyed person into the canonical person.
             if (email) {
                 this.posthog.alias({
                     distinctId: userId,
@@ -160,13 +138,6 @@ class TelemetryService {
             log.debug('Failed to identify user:', error);
         }
     }
-    /**
-     * Mirror an event to a local JSONL sink when RIVET_TELEMETRY_LOCAL_SINK is
-     * set. Benchmarks and perf tooling read this file for deterministic
-     * phase-timing data — PostHog ingestion is async/remote and filters internal
-     * users, so it can't serve as a run's authoritative timing record. Fires
-     * regardless of PostHog enablement and never throws.
-     */
     mirrorToLocalSink(event, properties) {
         const sinkPath = process.env.RIVET_TELEMETRY_LOCAL_SINK;
         if (!sinkPath)
@@ -178,13 +149,8 @@ class TelemetryService {
                 properties,
             })}\n`, 'utf8');
         }
-        catch {
-            // Sink problems must never affect the product path.
-        }
+        catch { }
     }
-    /**
-     * Track an event with properties
-     */
     track(event, properties = {}) {
         this.mirrorToLocalSink(event, properties);
         if (!this.isEnabled || !this.posthog)
@@ -224,9 +190,6 @@ class TelemetryService {
             log.warn(`Telemetry failed to send event "${event}":`, error);
         }
     }
-    /**
-     * Track CLI session start
-     */
     trackSessionStart(options) {
         this.track('cli_session_start', {
             framework: options.framework,
@@ -235,15 +198,6 @@ class TelemetryService {
             debug_mode: options.debugMode,
         });
     }
-    /**
-     * Track one `rivet` control-plane subcommand completing. Carries the
-     * caller's agent kind and model when a handoff was supplied — never the
-     * caller's chat session id. `is_product_use` discriminates engagement
-     * from lifecycle plumbing for active-user metrics: false for the
-     * stale-registration `mcp` tombstone (respawned by editors), the
-     * automatic-update bootstrap, and the internal `__serve` daemon — those
-     * fire without anyone driving Rivet and inflate raw active-user counts.
-     */
     trackCliCommandCompleted(data) {
         if (data.errorCode === 'MCP_REMOVED' &&
             !(0, ConfigManager_1.getConfigManager)().claimMcpRemovedTelemetryWindow()) {
@@ -271,7 +225,6 @@ class TelemetryService {
             is_product_use: !LIFECYCLE_CLI_COMMANDS.has(data.command),
         });
     }
-    /** Track the start of a correlated authentication attempt. */
     trackAuthStarted(data) {
         this.track(`${data.surface}_auth_started`, {
             auth_attempt_id: data.authAttemptId,
@@ -280,7 +233,6 @@ class TelemetryService {
             source: data.surface,
         });
     }
-    /** Track a successful authentication attempt without identity properties. */
     trackAuthCompleted(data) {
         this.track(`${data.surface}_auth_completed`, {
             auth_attempt_id: data.authAttemptId,
@@ -291,7 +243,6 @@ class TelemetryService {
             source: data.surface,
         });
     }
-    /** Track a failed authentication attempt with a normalized reason. */
     trackAuthFailed(data) {
         this.track(`${data.surface}_auth_failed`, {
             auth_attempt_id: data.authAttemptId,
@@ -302,9 +253,6 @@ class TelemetryService {
             source: data.surface,
         });
     }
-    /**
-     * Track code modification request - NO CODE CONTENT, just metadata
-     */
     trackCodeModification(data) {
         this.track('code_modification', {
             success: data.success,
@@ -315,9 +263,6 @@ class TelemetryService {
             modification_time_ms: data.modificationTimeMs,
         });
     }
-    /**
-     * Track agentic code modification request
-     */
     trackAgentModification(data) {
         this.track('agent_modification', {
             success: data.success,
@@ -332,23 +277,15 @@ class TelemetryService {
             trace_id: data.traceId,
             agent_run_id: data.agentRunId,
             posthog_session_id: data.posthogSessionId,
-            // Mirror onto the reserved $session_id so the event links to a session
-            // replay (posthog_session_id is a custom prop PostHog ignores for replay).
             $session_id: data.posthogSessionId,
         });
     }
-    /**
-     * Track agent abort events with enough context to distinguish inactivity timeouts,
-     * explicit user cancels, and unexpected process exits.
-     */
     trackAgentAborted(data) {
         this.track('agent_aborted', {
             trace_id: data.traceId,
             agent_run_id: data.agentRunId,
             session_id: data.sessionId,
             posthog_session_id: data.posthogSessionId,
-            // Mirror onto the reserved $session_id so the event links to a session
-            // replay (posthog_session_id is a custom prop PostHog ignores for replay).
             $session_id: data.posthogSessionId,
             model: data.model,
             abort_reason: data.abortReason,
@@ -359,9 +296,6 @@ class TelemetryService {
             source: data.source,
         });
     }
-    /**
-     * Track component search
-     */
     trackComponentSearch(data) {
         this.track('component_search', {
             success: data.success,
@@ -369,9 +303,6 @@ class TelemetryService {
             search_time_ms: data.searchTimeMs,
         });
     }
-    /**
-     * Track git operations
-     */
     trackGitOperation(data) {
         this.track('git_operation', {
             operation: data.operation,
@@ -379,19 +310,11 @@ class TelemetryService {
             error_type: data.errorType,
         });
     }
-    /**
-     * Tracks the `rivet __serve` startup lifecycle. `mode: 'static'` with a
-     * non-static framework hint means dev-server resolution fell back — the
-     * editor serves at `/` and `/rivet` redirects, which users read as "the
-     * editor is gone." These events make the startup outcome queryable without
-     * pulling `.rivet/cli/server.log`.
-     */
     trackServerStartStarted(data) {
         this.track('server_start_started', {
             has_framework_hint: data.hasFrameworkHint,
         });
     }
-    /** Records one terminal startup failure with no raw exception text. */
     trackServerStartFailed(data) {
         this.track('server_start_failed', {
             stage: data.stage,
@@ -410,11 +333,6 @@ class TelemetryService {
             duration_ms: data.durationMs,
         });
     }
-    /**
-     * A Rivet-owned user dev server process exited while the server was still
-     * running — previews and dev-server-backed endpoints start failing from
-     * this moment even though the Rivet process itself is healthy.
-     */
     trackDevServerLost(data) {
         this.track('dev_server_lost', {
             port: data.port,
@@ -422,7 +340,6 @@ class TelemetryService {
             exit_code: data.exitCode,
         });
     }
-    /** Track an operational error with normalized context. */
     trackError(data) {
         this.track('error', {
             error_type: data.errorType,
@@ -430,9 +347,6 @@ class TelemetryService {
             framework: data.framework,
         });
     }
-    /**
-     * Capture an exception with full stack trace for PostHog Error Tracking
-     */
     captureException(error, context) {
         if (!this.isEnabled || !this.posthog)
             return;
@@ -451,9 +365,6 @@ class TelemetryService {
             log.debug('Failed to capture exception:', captureError);
         }
     }
-    /**
-     * Track element selection patterns
-     */
     trackElementSelection(data) {
         this.track('element_selection', {
             method: data.method,
@@ -461,9 +372,6 @@ class TelemetryService {
             framework: data.framework,
         });
     }
-    /**
-     * Build shared MCP correlation properties for event capture.
-     */
     buildMCPCorrelationProperties(data) {
         const correlation = {};
         if (data.sessionId) {
@@ -483,9 +391,6 @@ class TelemetryService {
         }
         return correlation;
     }
-    /**
-     * Build shared first-use MCP onboarding correlation properties.
-     */
     buildMCPOnboardingProperties(data) {
         const properties = this.buildMCPCorrelationProperties(data);
         if (data.onboardingAttemptId) {
@@ -500,27 +405,23 @@ class TelemetryService {
         properties.source = data.source ?? 'mcp';
         return properties;
     }
-    /** Track the beginning of a first-use MCP onboarding attempt. */
     trackMCPOnboardingStarted(data) {
         this.track('mcp_onboarding_started', {
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track the beginning of an MCP onboarding auth attempt. */
     trackMCPAuthFlowStarted(data) {
         this.track('mcp_auth_flow_started', {
             method: data.method,
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track successful completion of an MCP onboarding auth attempt. */
     trackMCPAuthFlowCompleted(data) {
         this.track('mcp_auth_flow_completed', {
             method: data.method,
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track failed completion of an MCP onboarding auth attempt. */
     trackMCPAuthFlowFailed(data) {
         this.track('mcp_auth_flow_failed', {
             method: data.method,
@@ -528,7 +429,6 @@ class TelemetryService {
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track an OAuth handoff starting without storing raw redirect data. */
     trackMCPOAuthRedirectStarted(data) {
         this.track('mcp_oauth_redirect_started', {
             oauth_provider: data.oauthProvider,
@@ -536,21 +436,18 @@ class TelemetryService {
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track receipt of an OAuth callback with sanitized metadata only. */
     trackMCPOAuthCallbackReceived(data) {
         this.track('mcp_oauth_callback_received', {
             handoff_path_category: data.handoffPathCategory,
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track successful OAuth callback processing. */
     trackMCPOAuthCallbackProcessed(data) {
         this.track('mcp_oauth_callback_processed', {
             callback_result: data.callbackResult,
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track failed OAuth callback processing with normalized metadata. */
     trackMCPOAuthCallbackFailed(data) {
         this.track('mcp_oauth_callback_failed', {
             callback_result: data.callbackResult,
@@ -558,26 +455,22 @@ class TelemetryService {
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track the start of local MCP credential persistence. */
     trackMCPCredentialsStoreStarted(data) {
         this.track('mcp_credentials_store_started', {
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track successful local MCP credential persistence. */
     trackMCPCredentialsStoreCompleted(data) {
         this.track('mcp_credentials_store_completed', {
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track failed local MCP credential persistence with normalized metadata. */
     trackMCPCredentialsStoreFailed(data) {
         this.track('mcp_credentials_store_failed', {
             failure_reason: data.failureReason,
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /** Track successful generic MCP tool execution. */
     trackMCPToolExecuted(data) {
         this.track('mcp_tool_executed', {
             tool_name: data.toolName,
@@ -595,7 +488,6 @@ class TelemetryService {
             }),
         });
     }
-    /** Track failed generic MCP tool execution. */
     trackMCPToolFailed(data) {
         this.track('mcp_tool_failed', {
             tool_name: data.toolName,
@@ -616,7 +508,6 @@ class TelemetryService {
             }),
         });
     }
-    /** Track a metadata-only UI-to-agent MCP conversation turn. */
     trackMCPConversationTurnSent(data) {
         this.track('mcp_conversation_turn_sent', {
             round: data.round,
@@ -630,9 +521,6 @@ class TelemetryService {
             ...this.buildMCPOnboardingProperties(data),
         });
     }
-    /**
-     * Track MCP session start (includes `mcp_editor` for PostHog breakdowns: cursor / codex / claude / other).
-     */
     trackMCPSessionStart(data) {
         this.track('mcp_session_started', {
             framework: data.framework,
@@ -642,9 +530,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track MCP session end
-     */
     trackMCPSessionEnd(data) {
         this.track('mcp_session_ended', {
             rounds: data.rounds,
@@ -653,13 +538,11 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /** Track the start of variants product request evaluation. */
     trackAgentVariantsRequestStarted(data) {
         this.track('agent_variants.request_started', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)(data),
         });
     }
-    /** Track a variants request accepted into concrete product work. */
     trackAgentVariantsRequestAccepted(data) {
         this.track('agent_variants.request_accepted', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -668,7 +551,6 @@ class TelemetryService {
             }),
         });
     }
-    /** Track a variants request rejected before useful product work starts. */
     trackAgentVariantsRequestRejected(data) {
         this.track('agent_variants.request_rejected', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -677,13 +559,11 @@ class TelemetryService {
             }),
         });
     }
-    /** Track creation or lease of source-plan work. */
     trackAgentVariantsSourcePlanStarted(data) {
         this.track('agent_variants.source_plan_started', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)(data),
         });
     }
-    /** Track an accepted source-plan report. */
     trackAgentVariantsSourcePlanCompleted(data) {
         this.track('agent_variants.source_plan_completed', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -692,7 +572,6 @@ class TelemetryService {
             }),
         });
     }
-    /** Track a failed source-plan lifecycle transition. */
     trackAgentVariantsSourcePlanFailed(data) {
         this.track('agent_variants.source_plan_failed', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -701,13 +580,11 @@ class TelemetryService {
             }),
         });
     }
-    /** Track creation or lease of brief-generation work. */
     trackAgentVariantsBriefsStarted(data) {
         this.track('agent_variants.briefs_started', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)(data),
         });
     }
-    /** Track accepted generated directions becoming visible. */
     trackAgentVariantsBriefsCompleted(data) {
         this.track('agent_variants.briefs_completed', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -716,7 +593,6 @@ class TelemetryService {
             }),
         });
     }
-    /** Track a failed brief-generation lifecycle transition. */
     trackAgentVariantsBriefsFailed(data) {
         this.track('agent_variants.briefs_failed', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -725,19 +601,16 @@ class TelemetryService {
             }),
         });
     }
-    /** Track a comment/refine/Vary/history-adoption request. */
     trackAgentVariantsRefinementRequested(data) {
         this.track('agent_variants.refinement_requested', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)(data),
         });
     }
-    /** Track a refinement request associated with concrete work. */
     trackAgentVariantsRefinementLeased(data) {
         this.track('agent_variants.refinement_leased', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)(data),
         });
     }
-    /** Track a refinement request reaching a user-visible result. */
     trackAgentVariantsRefinementCompleted(data) {
         this.track('agent_variants.refinement_completed', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -746,7 +619,6 @@ class TelemetryService {
             }),
         });
     }
-    /** Track a failed refinement lifecycle transition. */
     trackAgentVariantsRefinementFailed(data) {
         this.track('agent_variants.refinement_failed', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -755,19 +627,16 @@ class TelemetryService {
             }),
         });
     }
-    /** Track deterministic variants product round start. */
     trackAgentVariantsRoundStarted(data) {
         this.track('agent_variants.round_started', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)(data),
         });
     }
-    /** Track deterministic variants product round outcome. */
     trackAgentVariantsRoundCompleted(data) {
         this.track('agent_variants.round_completed', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)(data),
         });
     }
-    /** Track selected-variant landing failures. */
     trackAgentVariantsCommitFailed(data) {
         this.track('agent_variants.commit_failed', {
             ...(0, MCPVariantsTelemetry_1.buildMCPVariantsTelemetryProperties)({
@@ -776,10 +645,6 @@ class TelemetryService {
             }),
         });
     }
-    /**
-     * Track the start of background scaffold + npm install for an agent-
-     * variants fresh-project session.
-     */
     trackAgentVariantsScaffoldStarted(data) {
         this.track('agent_variants.scaffold_started', {
             session_id: data.sessionId,
@@ -788,9 +653,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track successful completion of background scaffold + install.
-     */
     trackAgentVariantsScaffoldCompleted(data) {
         this.track('agent_variants.scaffold_completed', {
             session_id: data.sessionId,
@@ -800,9 +662,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track failure of background scaffold + install.
-     */
     trackAgentVariantsScaffoldFailed(data) {
         this.track('agent_variants.scaffold_failed', {
             session_id: data.sessionId,
@@ -811,9 +670,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track the ranked design-system list chosen for a fresh-project session.
-     */
     trackAgentVariantsFreshDesignSystemsRanked(data) {
         this.track('agent_variants.fresh_design_systems_ranked', {
             session_id: data.sessionId,
@@ -822,9 +678,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track the per-slot design-system pin chosen for a fresh-project session.
-     */
     trackAgentVariantsFreshDesignSystemsPinned(data) {
         this.track('agent_variants.fresh_design_systems_pinned', {
             session_id: data.sessionId,
@@ -836,9 +689,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track a fresh-variant dev server reaching ready state.
-     */
     trackAgentVariantsFreshDevServerStarted(data) {
         this.track('agent_variants.fresh_dev_server_started', {
             session_id: data.sessionId,
@@ -847,9 +697,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track a fresh-variant dev server failing to come up.
-     */
     trackAgentVariantsFreshDevServerFailed(data) {
         this.track('agent_variants.fresh_dev_server_failed', {
             session_id: data.sessionId,
@@ -863,9 +710,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track preview materialization beginning for any variant preview shape.
-     */
     trackAgentVariantsPreviewStarted(data) {
         this.track('agent_variants.preview_started', {
             session_id: data.sessionId,
@@ -875,9 +719,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track a variant preview becoming routable.
-     */
     trackAgentVariantsPreviewReady(data) {
         this.track('agent_variants.preview_ready', {
             session_id: data.sessionId,
@@ -890,9 +731,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track a variant preview failing before it becomes routable.
-     */
     trackAgentVariantsPreviewFailed(data) {
         this.track('agent_variants.preview_failed', {
             session_id: data.sessionId,
@@ -909,9 +747,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track an iframe proxy switch request before it mutates routing.
-     */
     trackAgentVariantsPreviewSwitchStarted(data) {
         this.track('agent_variants.preview_switch_started', {
             session_id: data.sessionId,
@@ -922,9 +757,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track a successful iframe proxy switch.
-     */
     trackAgentVariantsPreviewSwitchCompleted(data) {
         this.track('agent_variants.preview_switch_completed', {
             session_id: data.sessionId,
@@ -936,9 +768,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track a failed iframe proxy switch.
-     */
     trackAgentVariantsPreviewSwitchFailed(data) {
         this.track('agent_variants.preview_switch_failed', {
             session_id: data.sessionId,
@@ -951,10 +780,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Track materialize of a fresh-project pick into its user-facing
-     * destination after commit_variant.
-     */
     trackAgentVariantsNewProjectMaterialized(data) {
         this.track('agent_variants.new_project_materialized', {
             session_id: data.sessionId,
@@ -1003,10 +828,6 @@ class TelemetryService {
             source: 'mcp',
         });
     }
-    /**
-     * Flush pending events without tearing down the client.
-     * Safe to call between sessions when the process stays alive.
-     */
     async flush() {
         if (this.posthog) {
             try {
@@ -1018,10 +839,6 @@ class TelemetryService {
             }
         }
     }
-    /**
-     * Flush any pending events and tear down the client.
-     * Call once before the process exits.
-     */
     async shutdown() {
         if (this.posthog) {
             const client = this.posthog;
@@ -1037,5 +854,4 @@ class TelemetryService {
     }
 }
 exports.TelemetryService = TelemetryService;
-// Default telemetry instance is now instantiated where needed
 //# sourceMappingURL=TelemetryService.js.map