@od-oneapp/analytics 2026.1.1301

package/src/shared/emitters/ai/types.ts

@@ -0,0 +1,1041 @@
+/**
+ * @fileoverview Platform-standard AI product event types
+ * Platform-standard AI product event types
+ *
+ * Comprehensive tracking for AI assistant/copilot products like ChatGPT, Claude, Copilot.
+ * Tracks product features, user interactions, and system operations - NOT use-case specific.
+ *
+ * Completely separate from e-commerce tracking.
+ */
+
+// =============================================================================
+// BASE PROPERTIES
+// =============================================================================
+
+export interface BaseAIProperties {
+  agent_id?: string | undefined;
+  agent_name?: string | undefined;
+  conversation_id?: string | undefined;
+  message_id?: string | undefined;
+  model_id: string;
+  model_provider?:
+    | 'anthropic'
+    | 'openai'
+    | 'google'
+    | 'perplexity'
+    | 'cohere'
+    | 'mistral'
+    | 'other'
+    | undefined;
+  operation_id?: string | undefined;
+  session_id?: string | undefined;
+  user_id?: string | undefined;
+  workspace_id?: string | undefined;
+}
+
+export interface TokenUsageProperties {
+  cost?: number;
+  cost_currency?: string;
+  input_tokens?: number;
+  output_tokens?: number;
+  total_tokens?: number;
+}
+
+export interface ModelConfigProperties {
+  frequency_penalty?: number;
+  max_tokens?: number;
+  max_output_tokens?: number;
+  presence_penalty?: number;
+  seed?: number;
+  stop_sequences?: string[];
+  temperature?: number;
+  top_p?: number;
+}
+
+// =============================================================================
+// CONVERSATION & MESSAGING
+// =============================================================================
+
+export interface ConversationProperties extends BaseAIProperties {
+  conversation_title?: string;
+  folder_id?: string;
+  is_shared?: boolean;
+  parent_conversation_id?: string; // For branching
+  total_messages?: number;
+  conversation_type?: string;
+  last_active_timestamp?: number;
+  end_reason?: string;
+  [key: string]: any;
+}
+
+export interface MessageProperties extends BaseAIProperties, TokenUsageProperties {
+  content_length?: number;
+  has_attachments?: boolean;
+  has_code?: boolean;
+  has_images?: boolean;
+  is_edited?: boolean;
+  is_regenerated?: boolean;
+  message_index?: number;
+  message_role: 'user' | 'assistant' | 'system' | 'tool';
+  parent_message_id?: string; // For branching
+  response_time_ms?: number;
+  finish_reason?: string;
+  is_streaming?: boolean;
+  message_length?: number;
+  edit_type?: string;
+  deleted_by?: string;
+  [key: string]: any;
+}
+
+export interface RegenerationProperties extends BaseAIProperties {
+  attempt_number?: number;
+  original_message_id: string;
+  reason?: 'user-requested' | 'error-recovery' | 'quality-improvement';
+  temperature_adjusted?: boolean;
+  [key: string]: any;
+}
+
+export interface MessageEditProperties extends BaseAIProperties {
+  edit_type: 'user-message' | 'assistant-message';
+  edited_message_id: string;
+  new_length?: number;
+  original_length?: number;
+  [key: string]: any;
+}
+
+export interface BranchProperties extends BaseAIProperties {
+  branch_point_message_id: string;
+  new_conversation_id: string;
+  original_conversation_id: string;
+  reason?: 'explore-alternative' | 'correct-error' | 'user-initiated';
+  merge_strategy?: string;
+  [key: string]: any;
+}
+
+export interface StopGenerationProperties extends BaseAIProperties {
+  partial_length?: number;
+  stop_reason?: 'user-interrupted' | 'user-stopped' | 'timeout' | 'error';
+  tokens_used_at_stop?: number;
+  [key: string]: any;
+}
+
+// =============================================================================
+// CONTENT GENERATION
+// =============================================================================
+
+export interface TextGenerationProperties extends BaseAIProperties, TokenUsageProperties {
+  content_type: 'general' | 'creative' | 'technical' | 'summary' | 'translation';
+  finish_reason?: 'stop' | 'length' | 'content_filter';
+  generation_time_ms?: number;
+  output_length?: number;
+  prompt_length?: number;
+}
+
+export interface CodeGenerationProperties extends BaseAIProperties, TokenUsageProperties {
+  code_length?: number;
+  has_explanation?: boolean;
+  has_tests?: boolean;
+  language?: string;
+  source?: string;
+  task_type?: 'generate' | 'edit' | 'debug' | 'explain' | 'refactor' | 'translate';
+  code_type?: string;
+  explanation_length?: number;
+  explanation_type?: string;
+  issues_found?: number;
+  refactor_type?: string;
+  source_language?: string;
+  [key: string]: any;
+}
+
+export interface ImageGenerationProperties extends BaseAIProperties {
+  generation_time_ms?: number;
+  height?: number;
+  image_format?: 'png' | 'jpg' | 'webp';
+  model?: string; // DALL-E, Midjourney, Stable Diffusion
+  prompt_length?: number;
+  quality?: 'standard' | 'hd';
+  revisions?: number;
+  style?: string;
+  width?: number;
+  image_type?: string;
+  [key: string]: any;
+}
+
+export interface SummaryProperties extends BaseAIProperties, TokenUsageProperties {
+  input_length?: number;
+  output_length?: number;
+  source_type?: 'conversation' | 'document' | 'webpage' | 'code';
+  summary_type?: 'brief' | 'detailed' | 'key-points' | 'tldr';
+  source_length?: number;
+  [key: string]: any;
+}
+
+export interface TranslationProperties extends BaseAIProperties, TokenUsageProperties {
+  source_language?: string;
+  target_language?: string;
+  text_length?: number;
+  translation_quality?: 'literal' | 'natural' | 'formal';
+  [key: string]: any;
+}
+
+export interface ContentGenerationProperties extends BaseAIProperties, TokenUsageProperties {
+  content_type?: string;
+  generation_time_ms?: number;
+  output_length?: number;
+  prompt_length?: number;
+  content_length?: number;
+  content_format?: string;
+  completion_type?: string;
+  rewrite_style?: string;
+  email_type?: string;
+  document_type?: string;
+  section_count?: number;
+  source_language?: string;
+  [key: string]: any;
+}
+
+// =============================================================================
+// FILES & ATTACHMENTS
+// =============================================================================
+
+export interface FileUploadProperties extends BaseAIProperties {
+  file_size_bytes?: number;
+  file_type: string;
+  upload_duration_ms?: number;
+  [key: string]: any;
+}
+
+export interface FileAnalysisProperties extends BaseAIProperties, TokenUsageProperties {
+  analysis_type: 'read' | 'summarize' | 'extract' | 'question-answer';
+  file_id: string;
+  file_type: string;
+  processing_time_ms?: number;
+  [key: string]: any;
+}
+
+export interface ImageAnalysisProperties extends BaseAIProperties, TokenUsageProperties {
+  analysis_type: 'describe' | 'ocr' | 'question-answer' | 'object-detection';
+  image_id: string;
+  image_size_bytes?: number;
+  [key: string]: any;
+}
+
+// =============================================================================
+// SEARCH, BROWSE & CITATIONS
+// =============================================================================
+
+export interface WebSearchProperties extends BaseAIProperties {
+  query: string;
+  results_count?: number;
+  search_duration_ms?: number;
+  search_provider?: string;
+  [key: string]: any;
+}
+
+export interface WebBrowseProperties extends BaseAIProperties {
+  duration_ms?: number;
+  page_content_length?: number;
+  url: string;
+  [key: string]: any;
+}
+
+export interface CitationProperties extends BaseAIProperties {
+  citation_count?: number;
+  citation_format?: 'inline' | 'footnote' | 'reference-list';
+  message_id: string;
+  sources?: string[];
+  [key: string]: any;
+}
+
+// =============================================================================
+// TOOLS & FUNCTIONS
+// =============================================================================
+
+export interface ToolCallProperties extends BaseAIProperties {
+  error_message?: string;
+  execution_time_ms?: number;
+  input_params?: Record<string, any>;
+  input_size?: number;
+  output_size?: number;
+  result_status: 'success' | 'error' | 'timeout';
+  tool_name: string;
+  tool_type: 'built-in' | 'plugin' | 'custom' | 'api';
+  [key: string]: any;
+}
+
+export interface PluginProperties extends BaseAIProperties {
+  plugin_id: string;
+  plugin_name: string;
+  plugin_version?: string;
+  [key: string]: any;
+}
+
+export interface APICallProperties extends BaseAIProperties {
+  api_endpoint: string;
+  api_method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+  response_time_ms?: number;
+  status_code?: number;
+  [key: string]: any;
+}
+
+// =============================================================================
+// CONTEXT & MEMORY
+// =============================================================================
+
+export interface ContextProperties extends BaseAIProperties {
+  context_length_tokens?: number;
+  context_source?: 'history' | 'memory' | 'custom-instructions' | 'system';
+  context_type: 'added' | 'updated' | 'pruned' | 'cleared';
+  tokens_saved?: number;
+  [key: string]: any;
+}
+
+export interface MemoryProperties extends BaseAIProperties {
+  memory_id?: string;
+  memory_recalled?: boolean;
+  memory_type: 'stored' | 'retrieved' | 'updated' | 'cleared';
+  relevance_score?: number;
+  [key: string]: any;
+}
+
+export interface CustomInstructionsProperties extends BaseAIProperties {
+  instructions_length?: number;
+  instructions_type: 'created' | 'updated' | 'cleared';
+  template_used?: boolean;
+  [key: string]: any;
+}
+
+// =============================================================================
+// USER INTERACTIONS & PREFERENCES
+// =============================================================================
+
+export interface ModelSelectionProperties extends BaseAIProperties {
+  previous_model_id?: string;
+  reason?: 'user-preference' | 'feature-requirement' | 'cost-optimization';
+  selected_model_id: string;
+  [key: string]: any;
+}
+
+export interface ParameterAdjustmentProperties extends BaseAIProperties {
+  new_value: number | string;
+  parameter_name: 'temperature' | 'max_tokens' | 'top_p' | 'frequency_penalty';
+  previous_value?: number | string;
+  [key: string]: any;
+}
+
+export interface VoiceProperties extends BaseAIProperties {
+  audio_duration_ms?: number;
+  language?: string;
+  voice_type: 'input' | 'output';
+  [key: string]: any;
+}
+
+export interface StreamingProperties extends BaseAIProperties {
+  chunk_count?: number;
+  chunks_per_second?: number;
+  first_chunk_latency_ms?: number;
+  stream_duration_ms?: number;
+  stream_type?: 'text' | 'audio' | 'video' | 'image';
+  time_to_first_chunk_ms?: number;
+  was_stopped?: boolean;
+  chunk_index?: number;
+  total_bytes?: number;
+  [key: string]: any;
+}
+
+export interface CopyExportProperties extends BaseAIProperties {
+  action: 'copy-message' | 'copy-code' | 'export-conversation' | 'download-file';
+  content_length?: number;
+  export_format?: 'markdown' | 'json' | 'pdf' | 'txt';
+}
+
+// =============================================================================
+// WORKSPACE & ORGANIZATION
+// =============================================================================
+
+export interface ConversationManagementProperties extends BaseAIProperties {
+  action: 'save' | 'rename' | 'delete' | 'archive' | 'pin' | 'move' | 'duplicate';
+  new_folder_id?: string;
+  new_title?: string;
+}
+
+export interface FolderProperties extends BaseAIProperties {
+  action: 'create' | 'rename' | 'delete' | 'move';
+  conversation_count?: number;
+  folder_id: string;
+  folder_name?: string;
+  parent_folder_id?: string;
+}
+
+export interface SearchProperties extends BaseAIProperties {
+  query: string;
+  results_count?: number;
+  search_scope: 'conversations' | 'messages' | 'all';
+  search_time_ms?: number;
+}
+
+export interface TemplateProperties extends BaseAIProperties {
+  action: 'create' | 'use' | 'edit' | 'delete';
+  category?: string;
+  template_id?: string;
+  template_name?: string;
+}
+
+// =============================================================================
+// COLLABORATION & SHARING
+// =============================================================================
+
+export interface ShareProperties extends BaseAIProperties {
+  expiration_time?: string;
+  share_id?: string;
+  share_scope: 'public' | 'team' | 'private-link';
+  share_type: 'conversation' | 'message' | 'artifact';
+}
+
+export interface WorkspaceProperties extends BaseAIProperties {
+  action: 'create' | 'update' | 'delete' | 'invite';
+  member_count?: number;
+  workspace_name?: string;
+}
+
+export interface TeamProperties extends BaseAIProperties {
+  action: 'invite' | 'remove' | 'update-role';
+  member_email?: string;
+  member_role?: 'admin' | 'member' | 'viewer';
+  team_id: string;
+}
+
+export interface CommentProperties extends BaseAIProperties {
+  comment_id?: string;
+  comment_length?: number;
+  message_id: string;
+  parent_comment_id?: string;
+}
+
+// =============================================================================
+// ARTIFACTS & CANVAS (Claude-style features)
+// =============================================================================
+
+export interface ArtifactProperties extends BaseAIProperties {
+  action: 'create' | 'edit' | 'publish' | 'delete' | 'fork' | 'execute';
+  artifact_id?: string;
+  artifact_type: 'code' | 'document' | 'visualization' | 'react-component' | 'svg';
+  error_message?: string;
+  execution_status?: 'success' | 'failed' | 'pending' | 'error';
+  execution_time_ms?: number;
+  language?: string;
+  version?: number;
+  content_length?: number;
+  changes_description?: string;
+  new_artifact_id?: string;
+  [key: string]: any;
+}
+
+export interface CanvasProperties extends BaseAIProperties {
+  action: 'open' | 'edit' | 'close' | 'save' | 'execute';
+  canvas_id?: string;
+  content_type?: 'code' | 'markdown' | 'mermaid' | 'html';
+  execution_result?: 'success' | 'error';
+  canvas_type?: string;
+  artifact_id?: string;
+  preview_enabled?: boolean;
+  [key: string]: any;
+}
+
+// =============================================================================
+// FEEDBACK & QUALITY
+// =============================================================================
+
+export interface FeedbackProperties extends BaseAIProperties {
+  feedback_category?: 'accuracy' | 'helpfulness' | 'safety' | 'quality' | 'other';
+  feedback_text?: string;
+  feedback_type: 'thumbs-up' | 'thumbs-down' | 'rating' | 'detailed';
+  message_id: string;
+  rating?: number;
+  [key: string]: any;
+}
+
+export interface IssueReportProperties extends BaseAIProperties {
+  issue_category: 'bug' | 'incorrect-output' | 'inappropriate-content' | 'other';
+  issue_description?: string;
+  message_id?: string;
+  severity?: 'low' | 'medium' | 'high';
+  [key: string]: any;
+}
+
+export interface SafetyProperties extends BaseAIProperties {
+  action_taken?: 'blocked' | 'warned' | 'flagged';
+  category?: 'harmful' | 'inappropriate' | 'policy-violation';
+  message_id?: string;
+  safety_score?: number;
+  [key: string]: any;
+}
+
+// =============================================================================
+// SYSTEM & PERFORMANCE
+// =============================================================================
+
+export interface RateLimitProperties extends BaseAIProperties {
+  limit_type: 'requests' | 'tokens' | 'cost';
+  reset_time_seconds?: number;
+  tier?: string;
+  [key: string]: any;
+}
+
+export interface ErrorProperties extends BaseAIProperties {
+  error_code?: string;
+  error_message: string;
+  error_type:
+    | 'api'
+    | 'timeout'
+    | 'network'
+    | 'validation'
+    | 'content-filter'
+    | 'rate-limit'
+    | 'unknown';
+  operation: string;
+  retry_attempted?: boolean;
+  [key: string]: any;
+}
+
+export interface LatencyProperties extends BaseAIProperties {
+  latency_ms: number;
+  latency_type: 'first-token' | 'total' | 'network' | 'processing';
+  operation: string;
+  [key: string]: any;
+}
+
+export interface CostTrackingProperties extends BaseAIProperties, TokenUsageProperties {
+  cost_breakdown?: {
+    input_cost?: number;
+    output_cost?: number;
+    tool_cost?: number;
+  };
+  cost_per_request?: number;
+  pricing_tier?: string;
+  [key: string]: any;
+}
+
+// =============================================================================
+// ADDITIONAL PROPERTY GROUPS (for product-features.ts)
+// =============================================================================
+
+export interface CollaborationProperties extends BaseAIProperties {
+  member_id?: string;
+  member_role?: string;
+  permission_level?: string;
+  shared_with_count?: number;
+  share_type?: 'public' | 'team' | 'specific-users';
+  [key: string]: any;
+}
+
+export interface FileProperties extends BaseAIProperties {
+  batch_size?: number;
+  extraction_method?: string;
+  file_count?: number;
+  file_id?: string;
+  file_name?: string;
+  file_size?: number;
+  file_type?: string;
+  processing_time_ms?: number;
+  file_size_bytes?: number;
+  total_size_bytes?: number;
+  extracted_text_length?: number;
+  processing_status?: string;
+  reference_context?: string;
+  [key: string]: any;
+}
+
+export interface PerformanceProperties extends BaseAIProperties {
+  duration_ms?: number;
+  latency_ms?: number;
+  metric_name?: string;
+  metric_value?: number;
+  [key: string]: any;
+}
+
+export interface SystemProperties extends BaseAIProperties {
+  error_code?: string;
+  error_message?: string;
+  setting_name?: string;
+  setting_value?: string;
+  system_event?: string;
+  [key: string]: any;
+}
+
+export interface ToolProperties extends BaseAIProperties {
+  execution_time_ms?: number;
+  input_data?: Record<string, any>;
+  output_data?: Record<string, any>;
+  tool_id?: string;
+  tool_name?: string;
+  [key: string]: any;
+}
+
+export interface UserInteractionProperties extends BaseAIProperties {
+  action?: string;
+  content_length?: number;
+  content_type?: string;
+  interaction_type?: string;
+  target_id?: string;
+  content_id?: string;
+  suggestion_type?: string;
+  [key: string]: any;
+}
+
+// =============================================================================
+// STANDARD AI EVENT NAMES (100+ EVENTS)
+// =============================================================================
+
+export const AI_EVENTS = {
+  // ===== CONVERSATION & MESSAGING =====
+  BRANCH_CREATED: 'AI Branch Created',
+  BRANCH_MERGED: 'AI Branch Merged',
+  CONVERSATION_CONTINUED: 'AI Conversation Continued',
+  CONVERSATION_DELETED: 'AI Conversation Deleted',
+  CONVERSATION_ENDED: 'AI Conversation Ended',
+  CONVERSATION_RESUMED: 'AI Conversation Resumed',
+  CONVERSATION_STARTED: 'AI Conversation Started',
+  MESSAGE_DELETED: 'AI Message Deleted',
+  MESSAGE_EDITED: 'AI Message Edited',
+  MESSAGE_RECEIVED: 'AI Message Received',
+  MESSAGE_REGENERATED: 'AI Message Regenerated',
+  MESSAGE_SENT: 'AI Message Sent',
+  STOP_GENERATION: 'AI Stop Generation',
+  STREAMING_CHUNK_RECEIVED: 'AI Streaming Chunk Received',
+
+  // ===== CONTENT GENERATION =====
+  CODE_DEBUGGED: 'AI Code Debugged',
+  CODE_EDITED: 'AI Code Edited',
+  CODE_EXECUTED: 'AI Code Executed',
+  CODE_EXPLAINED: 'AI Code Explained',
+  CODE_GENERATED: 'AI Code Generated',
+  CODE_REFACTORED: 'AI Code Refactored',
+  CODE_TRANSLATED: 'AI Code Translated',
+  COMPLETION_GENERATED: 'AI Completion Generated',
+  CONTENT_COPIED: 'AI Content Copied',
+  CONTENT_DOWNLOADED: 'AI Content Downloaded',
+  CONTENT_REWRITTEN: 'AI Content Rewritten',
+  CONTENT_SHARED: 'AI Content Shared',
+  DIFF_VIEWED: 'AI Diff Viewed',
+  DOCUMENT_CREATED: 'AI Document Created',
+  EMAIL_DRAFTED: 'AI Email Drafted',
+  IMAGE_EDITED: 'AI Image Edited',
+  IMAGE_GENERATED: 'AI Image Generated',
+  IMAGE_REVISED: 'AI Image Revised',
+  INLINE_EDIT_APPLIED: 'AI Inline Edit Applied',
+  OUTLINE_CREATED: 'AI Outline Created',
+  REWRITE_GENERATED: 'AI Rewrite Generated',
+  SUGGESTION_ACCEPTED: 'AI Suggestion Accepted',
+  SUGGESTION_REJECTED: 'AI Suggestion Rejected',
+  SUMMARY_GENERATED: 'AI Summary Generated',
+  TEXT_GENERATED: 'AI Text Generated',
+  TEXT_TRANSLATED: 'AI Text Translated',
+  TRANSLATION_GENERATED: 'AI Translation Generated',
+
+  // ===== FILES & ATTACHMENTS =====
+  BATCH_FILES_PROCESSED: 'AI Batch Files Processed',
+  FILE_ANALYZED: 'AI File Analyzed',
+  FILE_DELETED: 'AI File Deleted',
+  FILE_DOWNLOADED: 'AI File Downloaded',
+  FILE_PROCESSED: 'AI File Processed',
+  FILE_PROCESSING_FAILED: 'AI File Processing Failed',
+  FILE_REFERENCED: 'AI File Referenced',
+  FILE_UPLOADED: 'AI File Uploaded',
+  IMAGE_ANALYZED: 'AI Image Analyzed',
+  IMAGE_UPLOADED: 'AI Image Uploaded',
+
+  // ===== SEARCH, BROWSE & CITATIONS =====
+  BROWSE_SESSION_STARTED: 'AI Browse Session Started',
+  CITATION_ADDED: 'AI Citation Added',
+  CITATION_PROVIDED: 'AI Citation Provided',
+  EXTERNAL_SOURCE_ACCESSED: 'AI External Source Accessed',
+  PAGE_CONTENT_FETCHED: 'AI Page Content Fetched',
+  SEARCH_RESULTS_RANKED: 'AI Search Results Ranked',
+  WEB_BROWSED: 'AI Web Browsed',
+  WEB_SEARCH_PERFORMED: 'AI Web Search Performed',
+  WEB_SEARCHED: 'AI Web Searched',
+
+  // ===== TOOLS & FUNCTIONS =====
+  API_CALLED: 'AI API Called',
+  API_REQUEST_MADE: 'AI API Request Made',
+  EXTENSION_USED: 'AI Extension Used',
+  FUNCTION_EXECUTED: 'AI Function Executed',
+  PLUGIN_ACTIVATED: 'AI Plugin Activated',
+  PLUGIN_DISABLED: 'AI Plugin Disabled',
+  PLUGIN_ENABLED: 'AI Plugin Enabled',
+  PLUGIN_USED: 'AI Plugin Used',
+  TOOL_CALL_COMPLETED: 'AI Tool Call Completed',
+  TOOL_CALL_FAILED: 'AI Tool Call Failed',
+  TOOL_CALL_STARTED: 'AI Tool Call Started',
+  TOOL_CALLED: 'AI Tool Called',
+  TOOL_FAILED: 'AI Tool Failed',
+
+  // ===== CONTEXT & MEMORY =====
+  CONTEXT_CLEARED: 'AI Context Cleared',
+  CONTEXT_PRUNED: 'AI Context Pruned',
+  CONTEXT_UPDATED: 'AI Context Updated',
+  CONTEXT_WINDOW_UPDATED: 'AI Context Window Updated',
+  CUSTOM_INSTRUCTIONS_CLEARED: 'AI Custom Instructions Cleared',
+  CUSTOM_INSTRUCTIONS_CREATED: 'AI Custom Instructions Created',
+  CUSTOM_INSTRUCTIONS_UPDATED: 'AI Custom Instructions Updated',
+  EMBEDDING_GENERATED: 'AI Embedding Generated',
+  KNOWLEDGE_BASE_QUERIED: 'AI Knowledge Base Queried',
+  MEMORY_CLEARED: 'AI Memory Cleared',
+  MEMORY_CREATED: 'AI Memory Created',
+  MEMORY_DELETED: 'AI Memory Deleted',
+  MEMORY_RECALLED: 'AI Memory Recalled',
+  MEMORY_RETRIEVED: 'AI Memory Retrieved',
+  MEMORY_STORED: 'AI Memory Stored',
+  MEMORY_UPDATED: 'AI Memory Updated',
+  PROJECT_CONTEXT_LOADED: 'AI Project Context Loaded',
+  RAG_QUERY_EXECUTED: 'AI RAG Query Executed',
+
+  // ===== USER INTERACTIONS =====
+  AUDIO_INPUT_USED: 'AI Audio Input Used',
+  AUDIO_OUTPUT_USED: 'AI Audio Output Used',
+  CODE_COPIED: 'AI Code Copied',
+  CONVERSATION_EXPORTED: 'AI Conversation Exported',
+  MESSAGE_COPIED: 'AI Message Copied',
+  MODEL_SELECTED: 'AI Model Selected',
+  PARAMETER_ADJUSTED: 'AI Parameter Adjusted',
+  STREAM_COMPLETED: 'AI Stream Completed',
+  STREAM_STARTED: 'AI Stream Started',
+  STREAMING_COMPLETED: 'AI Streaming Completed',
+  STREAMING_STARTED: 'AI Streaming Started',
+
+  // ===== WORKSPACE & ORGANIZATION =====
+  CONVERSATION_ARCHIVED: 'AI Conversation Archived',
+  CONVERSATION_DUPLICATED: 'AI Conversation Duplicated',
+  CONVERSATION_MOVED: 'AI Conversation Moved',
+  CONVERSATION_PINNED: 'AI Conversation Pinned',
+  CONVERSATION_RENAMED: 'AI Conversation Renamed',
+  CONVERSATION_SAVED: 'AI Conversation Saved',
+  CONVERSATION_SEARCHED: 'AI Conversation Searched',
+  FILTER_APPLIED: 'AI Filter Applied',
+  FOLDER_CREATED: 'AI Folder Created',
+  FOLDER_DELETED: 'AI Folder Deleted',
+  FOLDER_RENAMED: 'AI Folder Renamed',
+  SEARCH_PERFORMED: 'AI Search Performed',
+  TAG_ADDED: 'AI Tag Added',
+  TEMPLATE_CREATED: 'AI Template Created',
+  TEMPLATE_DELETED: 'AI Template Deleted',
+  TEMPLATE_USED: 'AI Template Used',
+
+  // ===== COLLABORATION & SHARING =====
+  COMMENT_ADDED: 'AI Comment Added',
+  CONVERSATION_FORKED: 'AI Conversation Forked',
+  CONVERSATION_SHARED: 'AI Conversation Shared',
+  MEMBER_INVITED: 'AI Member Invited',
+  PERMISSION_CHANGED: 'AI Permission Changed',
+  TEAM_MEMBER_INVITED: 'AI Team Member Invited',
+  TEAM_MEMBER_REMOVED: 'AI Team Member Removed',
+  WORKSPACE_CREATED: 'AI Workspace Created',
+
+  // ===== ARTIFACTS & CANVAS =====
+  ARTIFACT_CREATED: 'AI Artifact Created',
+  ARTIFACT_EDITED: 'AI Artifact Edited',
+  ARTIFACT_EXECUTED: 'AI Artifact Executed',
+  ARTIFACT_FORKED: 'AI Artifact Forked',
+  ARTIFACT_PUBLISHED: 'AI Artifact Published',
+  CANVAS_CLOSED: 'AI Canvas Closed',
+  CANVAS_EDITED: 'AI Canvas Edited',
+  CANVAS_OPENED: 'AI Canvas Opened',
+  CANVAS_SAVED: 'AI Canvas Saved',
+  LIVE_PREVIEW_TOGGLED: 'AI Live Preview Toggled',
+
+  // ===== FEEDBACK & QUALITY =====
+  BUG_REPORTED: 'AI Bug Reported',
+  FEATURE_REQUESTED: 'AI Feature Requested',
+  FEEDBACK_NEGATIVE: 'AI Feedback Negative',
+  FEEDBACK_POSITIVE: 'AI Feedback Positive',
+  FEEDBACK_PROVIDED: 'AI Feedback Provided',
+  HARMFUL_CONTENT_FLAGGED: 'AI Harmful Content Flagged',
+  ISSUE_REPORTED: 'AI Issue Reported',
+  QUALITY_ISSUE_REPORTED: 'AI Quality Issue Reported',
+  RATING_PROVIDED: 'AI Rating Provided',
+  RESPONSE_RATED: 'AI Response Rated',
+  SAFETY_VIOLATION: 'AI Safety Violation',
+
+  // ===== SYSTEM & PERFORMANCE =====
+  COST_TRACKED: 'AI Cost Tracked',
+  ERROR_OCCURRED: 'AI Error Occurred',
+  LATENCY_MEASURED: 'AI Latency Measured',
+  MODEL_SWITCHED: 'AI Model Switched',
+  PERFORMANCE_MEASURED: 'AI Performance Measured',
+  RATE_LIMIT_HIT: 'AI Rate Limit Hit',
+  SETTINGS_UPDATED: 'AI Settings Updated',
+  TOKEN_LIMIT_REACHED: 'AI Token Limit Reached',
+  TOKEN_USAGE_TRACKED: 'AI Token Usage Tracked',
+} as const;
+
+export type AIEventName = (typeof AI_EVENTS)[keyof typeof AI_EVENTS];
+
+/**
+ * Valid AI event categories
+ */
+export type AIEventCategory =
+  | 'ai'
+  | 'conversation'
+  | 'content'
+  | 'artifacts'
+  | 'tool'
+  | 'feedback'
+  | 'system'
+  | 'workspace'
+  | 'content-generation'
+  | 'user-interactions'
+  | 'files'
+  | 'context'
+  | 'collaboration';
+
+export interface AIEventSpec<T = any> {
+  category: AIEventCategory;
+  name: AIEventName;
+  properties: T;
+  requiredProperties: (keyof T)[];
+}
+
+export type AIEventProperties =
+  | BaseAIProperties
+  | ConversationProperties
+  | MessageProperties
+  | RegenerationProperties
+  | MessageEditProperties
+  | BranchProperties
+  | TextGenerationProperties
+  | CodeGenerationProperties
+  | ImageGenerationProperties
+  | SummaryProperties
+  | TranslationProperties
+  | FileUploadProperties
+  | FileAnalysisProperties
+  | ImageAnalysisProperties
+  | WebSearchProperties
+  | WebBrowseProperties
+  | CitationProperties
+  | ToolCallProperties
+  | PluginProperties
+  | APICallProperties
+  | ContextProperties
+  | MemoryProperties
+  | CustomInstructionsProperties
+  | ModelSelectionProperties
+  | ParameterAdjustmentProperties
+  | VoiceProperties
+  | StreamingProperties
+  | CopyExportProperties
+  | ConversationManagementProperties
+  | FolderProperties
+  | SearchProperties
+  | TemplateProperties
+  | ShareProperties
+  | WorkspaceProperties
+  | TeamProperties
+  | CommentProperties
+  | ArtifactProperties
+  | CanvasProperties
+  | FeedbackProperties
+  | IssueReportProperties
+  | SafetyProperties
+  | RateLimitProperties
+  | ErrorProperties
+  | LatencyProperties
+  | CostTrackingProperties;
+
+// =============================================================================
+// AI SDK V6 EVENTS & TYPES
+// =============================================================================
+
+/**
+ * AI SDK v6 event constants
+ * For tracking AI SDK operations: agents, completions, tools, streaming, chat
+ */
+export const AI_SDK_EVENTS = {
+  // Agent events
+  AGENT_CREATED: 'ai_sdk_agent_created',
+  AGENT_EXECUTION_STARTED: 'ai_sdk_agent_execution_started',
+  AGENT_EXECUTION_COMPLETED: 'ai_sdk_agent_execution_completed',
+  AGENT_EXECUTION_FAILED: 'ai_sdk_agent_execution_failed',
+
+  // Completion events
+  COMPLETION_REQUESTED: 'ai_sdk_completion_requested',
+  COMPLETION_GENERATED: 'ai_sdk_completion_generated',
+  COMPLETION_FAILED: 'ai_sdk_completion_failed',
+
+  // Tool call events
+  TOOL_CALL_STARTED: 'ai_sdk_tool_call_started',
+  TOOL_CALL_COMPLETED: 'ai_sdk_tool_call_completed',
+  TOOL_CALL_FAILED: 'ai_sdk_tool_call_failed',
+
+  // Streaming events
+  STREAM_STARTED: 'ai_sdk_stream_started',
+  STREAM_CHUNK_RECEIVED: 'ai_sdk_stream_chunk_received',
+  STREAM_COMPLETED: 'ai_sdk_stream_completed',
+  STREAM_FAILED: 'ai_sdk_stream_failed',
+
+  // Chat session events
+  CHAT_SESSION_STARTED: 'ai_sdk_chat_session_started',
+  CHAT_SESSION_ENDED: 'ai_sdk_chat_session_ended',
+  CHAT_MESSAGE_SENT: 'ai_sdk_chat_message_sent',
+  CHAT_MESSAGE_RECEIVED: 'ai_sdk_chat_message_received',
+
+  // E-commerce chatbot events
+  CHATBOT_INTENT_DETECTED: 'ai_sdk_chatbot_intent_detected',
+  CHATBOT_CART_ASSISTED: 'ai_sdk_chatbot_cart_assisted',
+  CHATBOT_ORDER_ASSISTED: 'ai_sdk_chatbot_order_assisted',
+  CHATBOT_PRODUCT_RECOMMENDED: 'ai_sdk_chatbot_product_recommended',
+
+  // Token usage tracking
+  TOKEN_USAGE_TRACKED: 'ai_sdk_token_usage_tracked',
+
+  // Multi-step reasoning
+  MULTI_STEP_STARTED: 'ai_sdk_multi_step_started',
+  MULTI_STEP_PROGRESSED: 'ai_sdk_multi_step_progressed',
+  MULTI_STEP_COMPLETED: 'ai_sdk_multi_step_completed',
+} as const;
+
+/**
+ * Base properties for AI SDK events
+ */
+export interface BaseAISDKProperties {
+  model_id: string;
+  model_provider?:
+    | 'anthropic'
+    | 'openai'
+    | 'google'
+    | 'cohere'
+    | 'mistral'
+    | 'other'
+    | 'perplexity'
+    | undefined;
+  session_id?: string | undefined;
+  user_id?: string | undefined;
+  operation_id?: string | undefined;
+  conversation_id?: string | undefined;
+  message_id?: string | undefined;
+  timestamp?: number | undefined;
+}
+
+/**
+ * Agent execution properties
+ */
+export interface AgentProperties extends BaseAISDKProperties, TokenUsageProperties {
+  agent_id?: string;
+  agent_name?: string;
+  agent_type?: string;
+  agent_version?: string;
+  system_prompt_length?: number;
+  tools_available?: string[];
+  tools_count?: number;
+  execution_time_ms?: number;
+  iterations?: number;
+  completion_type?: string;
+  status?: 'success' | 'failed' | 'pending';
+  total_duration_ms?: number;
+  step_count?: number;
+  retry_count?: number;
+  has_tools?: boolean;
+}
+
+/**
+ * Completion properties
+ */
+export interface CompletionProperties
+  extends BaseAISDKProperties, TokenUsageProperties, ModelConfigProperties {
+  prompt_length?: number;
+  completion_length?: number;
+  finish_reason?: 'stop' | 'length' | 'content_filter' | 'tool_calls';
+  generation_time_ms?: number;
+  stream?: boolean;
+  completion_type?: string;
+  status?: 'success' | 'failed' | 'pending' | 'completed';
+  total_duration_ms?: number;
+  step_count?: number;
+  retry_count?: number;
+  has_tools?: boolean;
+  agent_id?: string;
+  conversation_id?: string;
+}
+
+/**
+ * Tool call SDK properties (for AI SDK v6 events)
+ */
+export interface ToolCallSDKProperties extends BaseAISDKProperties {
+  tool_name: string;
+  tool_id?: string;
+  tool_call_id?: string;
+  tool_type?: string;
+  input_schema?: Record<string, any>;
+  input_size?: number;
+  output_schema?: Record<string, any>;
+  output_size?: number;
+  execution_time_ms?: number;
+  success?: boolean;
+  result_status?: 'success' | 'error' | 'partial';
+}
+
+/**
+ * Streaming SDK properties (for AI SDK v6 events)
+ */
+export interface StreamingSDKProperties extends BaseAISDKProperties {
+  chunk_index?: number | undefined;
+  chunks_total?: number | undefined;
+  chunk_count?: number | undefined;
+  bytes_streamed?: number | undefined;
+  stream_duration_ms?: number | undefined;
+  first_chunk_time_ms?: number | undefined;
+  stream_type?: 'text' | 'audio' | 'video' | 'image' | undefined;
+  time_to_first_chunk_ms?: number | undefined;
+  chunks_per_second?: number | undefined;
+  was_stopped?: boolean | undefined;
+}
+
+/**
+ * Chat session properties
+ */
+export interface SessionProperties extends BaseAISDKProperties, TokenUsageProperties {
+  session_id: string;
+  session_type?: 'chat' | 'completion' | 'streaming';
+  duration_ms?: number;
+  message_count?: number;
+  tool_calls_count?: number;
+  session_end_reason?: 'user-ended' | 'timeout' | 'error' | 'completed';
+}
+
+/**
+ * Chat message properties
+ */
+export interface ChatMessageProperties extends BaseAISDKProperties, TokenUsageProperties {
+  chat_id?: string;
+  conversation_id?: string;
+  message_id?: string;
+  message_role: 'user' | 'assistant' | 'system' | 'tool';
+  message_length?: number;
+  has_attachments?: boolean;
+  response_time_ms?: number;
+  message_index?: number;
+  has_images?: boolean;
+  parent_message_id?: string;
+  finish_reason?: string;
+  is_streaming?: boolean;
+}
+
+/**
+ * E-commerce chatbot properties
+ */
+export interface ChatbotEcommerceProperties extends BaseAISDKProperties {
+  conversation_id?: string;
+  intent?: string;
+  confidence?: number;
+  product_ids?: string[];
+  product_count?: number;
+  cart_value?: number;
+  order_id?: string;
+  recommendation_type?: string;
+  intent_detected?: string;
+  cart_id?: string;
+}
+
+// Re-export AISdkEventSpec from track-ai-sdk for convenience
+export type { AISdkEventSpec } from './track-ai-sdk';