orca/src/shared/feature-education-telemetry.ts

import type { ContextualTourId } from './contextual-tours'

export const FEATURE_EDUCATION_CONTEXTUAL_TOUR_IDS = [
  'workspace-board',
  'workspace-agent-sessions',
  'browser',
  'client-hosted-browser',
  'tasks',
  'automations',
  'floating-workspace',
  'workspace-creation'
] as const satisfies readonly ContextualTourId[]

export const FEATURE_EDUCATION_SOURCES = [
  'workspace_board_visible',
  'workspace_agent_sessions_visible',
  'browser_visible',
  'client_hosted_browser_visible',
  'tasks_open',
  'automations_open',
  'floating_workspace_visible',
  'workspace_creation_visible',
  'workspace_creation_modal',
  'setup_guide_parallel_work',
  'unknown'
] as const

export const CONTEXTUAL_TOUR_OUTCOMES = ['completed', 'skipped', 'cancelled'] as const
export const SETUP_GUIDE_SOURCES = [
  'sidebar',
  'contextual_tour',
  'settings',
  'feature_wall',
  'help_menu',
  'unknown'
] as const
export const SETUP_GUIDE_CLOSE_OUTCOMES = ['completed', 'dismissed', 'interrupted'] as const
export const TERMINAL_PANE_SPLIT_SOURCES = [
  'contextual_tour',
  'keyboard',
  'context_menu',
  'command',
  'unknown'
] as const

export type FeatureEducationSource = (typeof FEATURE_EDUCATION_SOURCES)[number]
export type ContextualTourOutcome = (typeof CONTEXTUAL_TOUR_OUTCOMES)[number]
export type SetupGuideSource = (typeof SETUP_GUIDE_SOURCES)[number]
export type SetupGuideCloseOutcome = (typeof SETUP_GUIDE_CLOSE_OUTCOMES)[number]
export type TerminalPaneSplitSource = (typeof TERMINAL_PANE_SPLIT_SOURCES)[number]

export function normalizeFeatureEducationSource(
  value: string | null | undefined
): FeatureEducationSource {
  return FEATURE_EDUCATION_SOURCES.includes(value as FeatureEducationSource)
    ? (value as FeatureEducationSource)
    : 'unknown'
}

export function normalizeSetupGuideSource(value: string | null | undefined): SetupGuideSource {
  return SETUP_GUIDE_SOURCES.includes(value as SetupGuideSource)
    ? (value as SetupGuideSource)
    : 'unknown'
}