@od-oneapp/analytics 2026.1.1301

package/src/shared/emitters/ai/events/product-features.ts

@@ -0,0 +1,1402 @@
+/**
+ * @fileoverview Additional AI Product Features
+ * Additional AI Product Features
+ *
+ * Comprehensive tracking for all remaining AI product features:
+ * - User interactions (copy, execute, download)
+ * - Files & attachments
+ * - Context & memory management
+ * - Collaboration & sharing
+ * - Workspace & organization
+ * - Feedback & quality
+ * - System & performance
+ * - Tools & functions
+ * - Search & citations
+ */
+
+import { createAITracker } from '../track-ai';
+import {
+  AI_EVENTS,
+  type BaseAIProperties,
+  type CodeGenerationProperties,
+  type CollaborationProperties,
+  type ContextProperties,
+  type FeedbackProperties,
+  type FileProperties,
+  type MemoryProperties,
+  type PerformanceProperties,
+  type SearchProperties,
+  type SystemProperties,
+  type ToolProperties,
+  type UserInteractionProperties,
+  type WorkspaceProperties,
+} from '../types';
+
+// ============================================================================
+// USER INTERACTIONS - User actions on generated content
+// ============================================================================
+
+/**
+ * Track code copy action
+ *
+ * @example
+ * ```typescript
+ * ai.CODE_COPIED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   code_id: 'code_789',
+ *   language: 'typescript',
+ *   code_length: 450,
+ * });
+ * ```
+ */
+export const CODE_COPIED = createAITracker<CodeGenerationProperties>(properties => ({
+  name: AI_EVENTS.CODE_COPIED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: ['task_type'],
+}));
+
+/**
+ * Track code execution
+ *
+ * @example
+ * ```typescript
+ * ai.CODE_EXECUTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   code_id: 'code_789',
+ *   language: 'typescript',
+ *   execution_status: 'success',
+ *   execution_time_ms: 120,
+ * });
+ * ```
+ */
+export const CODE_EXECUTED = createAITracker<CodeGenerationProperties>(properties => ({
+  name: AI_EVENTS.CODE_EXECUTED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: ['task_type'],
+}));
+
+/**
+ * Track general content copy
+ *
+ * @example
+ * ```typescript
+ * ai.CONTENT_COPIED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   content_id: 'content_456',
+ *   content_type: 'text',
+ *   content_length: 350,
+ * });
+ * ```
+ */
+export const CONTENT_COPIED = createAITracker<UserInteractionProperties>(properties => ({
+  name: AI_EVENTS.CONTENT_COPIED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track content download
+ *
+ * @example
+ * ```typescript
+ * ai.CONTENT_DOWNLOADED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   content_id: 'content_456',
+ *   content_type: 'document',
+ *   file_format: 'pdf',
+ *   file_size_bytes: 1024000,
+ * });
+ * ```
+ */
+export const CONTENT_DOWNLOADED = createAITracker<UserInteractionProperties>(properties => ({
+  name: AI_EVENTS.CONTENT_DOWNLOADED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track content sharing
+ *
+ * @example
+ * ```typescript
+ * ai.CONTENT_SHARED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   content_id: 'content_456',
+ *   content_type: 'code',
+ *   share_platform: 'twitter',
+ * });
+ * ```
+ */
+export const CONTENT_SHARED = createAITracker<UserInteractionProperties>(properties => ({
+  name: AI_EVENTS.CONTENT_SHARED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track AI suggestion acceptance
+ *
+ * @example
+ * ```typescript
+ * ai.SUGGESTION_ACCEPTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   suggestion_type: 'code-completion',
+ *   suggestion_id: 'sug_123',
+ * });
+ * ```
+ */
+export const SUGGESTION_ACCEPTED = createAITracker<UserInteractionProperties>(properties => ({
+  name: AI_EVENTS.SUGGESTION_ACCEPTED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track AI suggestion rejection
+ *
+ * @example
+ * ```typescript
+ * ai.SUGGESTION_REJECTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   suggestion_type: 'text-completion',
+ *   suggestion_id: 'sug_124',
+ *   rejection_reason: 'not-relevant',
+ * });
+ * ```
+ */
+export const SUGGESTION_REJECTED = createAITracker<UserInteractionProperties>(properties => ({
+  name: AI_EVENTS.SUGGESTION_REJECTED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track inline edit applied to AI content
+ *
+ * @example
+ * ```typescript
+ * ai.INLINE_EDIT_APPLIED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   content_id: 'content_456',
+ *   edit_type: 'user-refinement',
+ *   characters_changed: 25,
+ * });
+ * ```
+ */
+export const INLINE_EDIT_APPLIED = createAITracker<UserInteractionProperties>(properties => ({
+  name: AI_EVENTS.INLINE_EDIT_APPLIED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track diff/changes viewed
+ *
+ * @example
+ * ```typescript
+ * ai.DIFF_VIEWED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   content_id: 'content_456',
+ *   diff_type: 'side-by-side',
+ *   lines_added: 15,
+ *   lines_removed: 8,
+ * });
+ * ```
+ */
+export const DIFF_VIEWED = createAITracker<UserInteractionProperties>(properties => ({
+  name: AI_EVENTS.DIFF_VIEWED,
+  category: 'user-interactions',
+  properties,
+  requiredProperties: [],
+}));
+
+// ============================================================================
+// FILES & ATTACHMENTS - File upload, processing, and usage
+// ============================================================================
+
+/**
+ * Track file upload
+ *
+ * @example
+ * ```typescript
+ * ai.FILE_UPLOADED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   file_type: 'pdf',
+ *   file_size_bytes: 1024000,
+ *   file_count: 1,
+ * });
+ * ```
+ */
+export const FILE_UPLOADED = createAITracker<FileProperties>(properties => ({
+  name: AI_EVENTS.FILE_UPLOADED,
+  category: 'files',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track file processing completion
+ *
+ * @example
+ * ```typescript
+ * ai.FILE_PROCESSED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   file_id: 'file_123',
+ *   file_type: 'pdf',
+ *   processing_time_ms: 2500,
+ *   extracted_text_length: 5000,
+ *   processing_status: 'success',
+ * });
+ * ```
+ */
+export const FILE_PROCESSED = createAITracker<FileProperties>(properties => ({
+  name: AI_EVENTS.FILE_PROCESSED,
+  category: 'files',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track file processing failure
+ *
+ * @example
+ * ```typescript
+ * ai.FILE_PROCESSING_FAILED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   file_id: 'file_124',
+ *   file_type: 'docx',
+ *   processing_status: 'failed',
+ *   error_reason: 'unsupported-format',
+ * });
+ * ```
+ */
+export const FILE_PROCESSING_FAILED = createAITracker<FileProperties>(properties => ({
+  name: AI_EVENTS.FILE_PROCESSING_FAILED,
+  category: 'files',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track file download
+ *
+ * @example
+ * ```typescript
+ * ai.FILE_DOWNLOADED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   file_id: 'file_125',
+ *   file_type: 'csv',
+ *   file_size_bytes: 512000,
+ * });
+ * ```
+ */
+export const FILE_DOWNLOADED = createAITracker<FileProperties>(properties => ({
+  name: AI_EVENTS.FILE_DOWNLOADED,
+  category: 'files',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track file reference in conversation
+ *
+ * @example
+ * ```typescript
+ * ai.FILE_REFERENCED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   file_id: 'file_123',
+ *   file_type: 'pdf',
+ *   reference_context: 'answer-question',
+ * });
+ * ```
+ */
+export const FILE_REFERENCED = createAITracker<FileProperties>(properties => ({
+  name: AI_EVENTS.FILE_REFERENCED,
+  category: 'files',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track file deletion
+ *
+ * @example
+ * ```typescript
+ * ai.FILE_DELETED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   file_id: 'file_126',
+ *   file_type: 'image',
+ *   deleted_by: 'user',
+ * });
+ * ```
+ */
+export const FILE_DELETED = createAITracker<FileProperties>(properties => ({
+  name: AI_EVENTS.FILE_DELETED,
+  category: 'files',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track batch file processing
+ *
+ * @example
+ * ```typescript
+ * ai.BATCH_FILES_PROCESSED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   file_count: 5,
+ *   total_size_bytes: 5120000,
+ *   processing_time_ms: 8500,
+ *   processing_status: 'success',
+ * });
+ * ```
+ */
+export const BATCH_FILES_PROCESSED = createAITracker<FileProperties>(properties => ({
+  name: AI_EVENTS.BATCH_FILES_PROCESSED,
+  category: 'files',
+  properties,
+  requiredProperties: [],
+}));
+
+// ============================================================================
+// CONTEXT & MEMORY - Context management and long-term memory
+// ============================================================================
+
+/**
+ * Track context window update
+ *
+ * @example
+ * ```typescript
+ * ai.CONTEXT_WINDOW_UPDATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   context_size_tokens: 8000,
+ *   context_type: 'conversation',
+ * });
+ * ```
+ */
+export const CONTEXT_WINDOW_UPDATED = createAITracker<ContextProperties>(properties => ({
+  name: AI_EVENTS.CONTEXT_WINDOW_UPDATED,
+  category: 'context',
+  properties,
+  requiredProperties: ['context_type'],
+}));
+
+/**
+ * Track memory creation
+ *
+ * @example
+ * ```typescript
+ * ai.MEMORY_CREATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   memory_id: 'mem_123',
+ *   memory_type: 'user-preference',
+ *   memory_content_length: 50,
+ *   memory_source: 'explicit',
+ * });
+ * ```
+ */
+export const MEMORY_CREATED = createAITracker<MemoryProperties>(properties => ({
+  name: AI_EVENTS.MEMORY_CREATED,
+  category: 'context',
+  properties,
+  requiredProperties: ['memory_type'],
+}));
+
+/**
+ * Track memory retrieval
+ *
+ * @example
+ * ```typescript
+ * ai.MEMORY_RETRIEVED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   memory_id: 'mem_123',
+ *   memory_type: 'user-preference',
+ *   retrieval_relevance_score: 0.95,
+ * });
+ * ```
+ */
+export const MEMORY_RETRIEVED = createAITracker<MemoryProperties>(properties => ({
+  name: AI_EVENTS.MEMORY_RETRIEVED,
+  category: 'context',
+  properties,
+  requiredProperties: ['memory_type'],
+}));
+
+/**
+ * Track memory update
+ *
+ * @example
+ * ```typescript
+ * ai.MEMORY_UPDATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   memory_id: 'mem_123',
+ *   memory_type: 'fact',
+ *   update_reason: 'correction',
+ * });
+ * ```
+ */
+export const MEMORY_UPDATED = createAITracker<MemoryProperties>(properties => ({
+  name: AI_EVENTS.MEMORY_UPDATED,
+  category: 'context',
+  properties,
+  requiredProperties: ['memory_type'],
+}));
+
+/**
+ * Track memory deletion
+ *
+ * @example
+ * ```typescript
+ * ai.MEMORY_DELETED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   memory_id: 'mem_124',
+ *   memory_type: 'user-preference',
+ *   deleted_by: 'user',
+ * });
+ * ```
+ */
+export const MEMORY_DELETED = createAITracker<MemoryProperties>(properties => ({
+  name: AI_EVENTS.MEMORY_DELETED,
+  category: 'context',
+  properties,
+  requiredProperties: ['memory_type'],
+}));
+
+/**
+ * Track custom instructions update
+ *
+ * @example
+ * ```typescript
+ * ai.CUSTOM_INSTRUCTIONS_UPDATED({
+ *   model_id: 'gpt-4',
+ *   user_id: 'user_123',
+ *   instructions_length: 200,
+ *   has_preferences: true,
+ *   has_constraints: true,
+ * });
+ * ```
+ */
+export const CUSTOM_INSTRUCTIONS_UPDATED = createAITracker<ContextProperties>(properties => ({
+  name: AI_EVENTS.CUSTOM_INSTRUCTIONS_UPDATED,
+  category: 'context',
+  properties,
+  requiredProperties: ['context_type'],
+}));
+
+/**
+ * Track project context loading
+ *
+ * @example
+ * ```typescript
+ * ai.PROJECT_CONTEXT_LOADED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   context_type: 'project',
+ *   context_size_tokens: 5000,
+ *   project_id: 'proj_456',
+ * });
+ * ```
+ */
+export const PROJECT_CONTEXT_LOADED = createAITracker<ContextProperties>(properties => ({
+  name: AI_EVENTS.PROJECT_CONTEXT_LOADED,
+  category: 'context',
+  properties,
+  requiredProperties: ['context_type'],
+}));
+
+/**
+ * Track RAG query execution
+ *
+ * @example
+ * ```typescript
+ * ai.RAG_QUERY_EXECUTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   query_text: 'Find documentation about React hooks',
+ *   query_embedding_dimensions: 1536,
+ *   chunks_retrieved: 5,
+ *   retrieval_time_ms: 150,
+ *   retrieval_status: 'success',
+ * });
+ * ```
+ */
+export const RAG_QUERY_EXECUTED = createAITracker<ContextProperties>(properties => ({
+  name: AI_EVENTS.RAG_QUERY_EXECUTED,
+  category: 'context',
+  properties,
+  requiredProperties: ['context_type'],
+}));
+
+/**
+ * Track embedding generation
+ *
+ * @example
+ * ```typescript
+ * ai.EMBEDDING_GENERATED({
+ *   model_id: 'text-embedding-ada-002',
+ *   text_length: 500,
+ *   embedding_dimensions: 1536,
+ *   generation_time_ms: 80,
+ * });
+ * ```
+ */
+export const EMBEDDING_GENERATED = createAITracker<ContextProperties>(properties => ({
+  name: AI_EVENTS.EMBEDDING_GENERATED,
+  category: 'context',
+  properties,
+  requiredProperties: ['context_type'],
+}));
+
+/**
+ * Track knowledge base query
+ *
+ * @example
+ * ```typescript
+ * ai.KNOWLEDGE_BASE_QUERIED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   query_text: 'What is our refund policy?',
+ *   results_found: 3,
+ *   query_time_ms: 120,
+ * });
+ * ```
+ */
+export const KNOWLEDGE_BASE_QUERIED = createAITracker<ContextProperties>(properties => ({
+  name: AI_EVENTS.KNOWLEDGE_BASE_QUERIED,
+  category: 'context',
+  properties,
+  requiredProperties: ['context_type'],
+}));
+
+// ============================================================================
+// COLLABORATION & SHARING - Team features and sharing
+// ============================================================================
+
+/**
+ * Track conversation sharing
+ *
+ * @example
+ * ```typescript
+ * ai.CONVERSATION_SHARED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   share_type: 'public-link',
+ *   share_permissions: 'view-only',
+ *   message_count: 15,
+ * });
+ * ```
+ */
+export const CONVERSATION_SHARED = createAITracker<CollaborationProperties>(properties => ({
+  name: AI_EVENTS.CONVERSATION_SHARED,
+  category: 'collaboration',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track conversation forking
+ *
+ * @example
+ * ```typescript
+ * ai.CONVERSATION_FORKED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   original_conversation_id: 'conv_123',
+ *   new_conversation_id: 'conv_125',
+ *   forked_from_message_id: 'msg_460',
+ * });
+ * ```
+ */
+export const CONVERSATION_FORKED = createAITracker<CollaborationProperties>(properties => ({
+  name: AI_EVENTS.CONVERSATION_FORKED,
+  category: 'collaboration',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track workspace creation
+ *
+ * @example
+ * ```typescript
+ * ai.WORKSPACE_CREATED({
+ *   workspace_id: 'ws_001',
+ *   model_id: 'claude-3-5-sonnet',
+ *   workspace_type: 'team',
+ *   member_count: 5,
+ * });
+ * ```
+ */
+export const WORKSPACE_CREATED = createAITracker<WorkspaceProperties>(properties => ({
+  name: AI_EVENTS.WORKSPACE_CREATED,
+  category: 'collaboration',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+/**
+ * Track member invitation
+ *
+ * @example
+ * ```typescript
+ * ai.MEMBER_INVITED({
+ *   workspace_id: 'ws_001',
+ *   model_id: 'gpt-4',
+ *   invitee_role: 'member',
+ *   invitation_method: 'email',
+ * });
+ * ```
+ */
+export const MEMBER_INVITED = createAITracker<CollaborationProperties>(properties => ({
+  name: AI_EVENTS.MEMBER_INVITED,
+  category: 'collaboration',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track collaboration comment
+ *
+ * @example
+ * ```typescript
+ * ai.COMMENT_ADDED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   comment_target: 'message',
+ *   comment_length: 150,
+ * });
+ * ```
+ */
+export const COMMENT_ADDED = createAITracker<CollaborationProperties>(properties => ({
+  name: AI_EVENTS.COMMENT_ADDED,
+  category: 'collaboration',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track permission change
+ *
+ * @example
+ * ```typescript
+ * ai.PERMISSION_CHANGED({
+ *   workspace_id: 'ws_001',
+ *   model_id: 'gpt-4',
+ *   target_user_id: 'user_456',
+ *   old_permission: 'viewer',
+ *   new_permission: 'editor',
+ * });
+ * ```
+ */
+export const PERMISSION_CHANGED = createAITracker<CollaborationProperties>(properties => ({
+  name: AI_EVENTS.PERMISSION_CHANGED,
+  category: 'collaboration',
+  properties,
+  requiredProperties: [],
+}));
+
+// ============================================================================
+// WORKSPACE & ORGANIZATION - Organization and workspace management
+// ============================================================================
+
+/**
+ * Track conversation rename
+ *
+ * @example
+ * ```typescript
+ * ai.CONVERSATION_RENAMED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   old_title: 'Chat',
+ *   new_title: 'React Project Discussion',
+ * });
+ * ```
+ */
+export const CONVERSATION_RENAMED = createAITracker<WorkspaceProperties>(properties => ({
+  name: AI_EVENTS.CONVERSATION_RENAMED,
+  category: 'workspace',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+/**
+ * Track conversation archival
+ *
+ * @example
+ * ```typescript
+ * ai.CONVERSATION_ARCHIVED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   archive_reason: 'completed',
+ * });
+ * ```
+ */
+export const CONVERSATION_ARCHIVED = createAITracker<WorkspaceProperties>(properties => ({
+  name: AI_EVENTS.CONVERSATION_ARCHIVED,
+  category: 'workspace',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+/**
+ * Track conversation deletion
+ *
+ * @example
+ * ```typescript
+ * ai.CONVERSATION_DELETED({
+ *   conversation_id: 'conv_124',
+ *   model_id: 'claude-3-5-sonnet',
+ *   message_count: 8,
+ *   deleted_by: 'user',
+ * });
+ * ```
+ */
+export const CONVERSATION_DELETED = createAITracker<WorkspaceProperties>(properties => ({
+  name: AI_EVENTS.CONVERSATION_DELETED,
+  category: 'workspace',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+/**
+ * Track folder creation
+ *
+ * @example
+ * ```typescript
+ * ai.FOLDER_CREATED({
+ *   workspace_id: 'ws_001',
+ *   model_id: 'gpt-4',
+ *   folder_name: 'Project Ideas',
+ *   parent_folder_id: 'folder_root',
+ * });
+ * ```
+ */
+export const FOLDER_CREATED = createAITracker<WorkspaceProperties>(properties => ({
+  name: AI_EVENTS.FOLDER_CREATED,
+  category: 'workspace',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+/**
+ * Track tag addition
+ *
+ * @example
+ * ```typescript
+ * ai.TAG_ADDED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   tag_name: 'important',
+ *   tag_category: 'priority',
+ * });
+ * ```
+ */
+export const TAG_ADDED = createAITracker<WorkspaceProperties>(properties => ({
+  name: AI_EVENTS.TAG_ADDED,
+  category: 'workspace',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+/**
+ * Track conversation search
+ *
+ * @example
+ * ```typescript
+ * ai.SEARCH_PERFORMED({
+ *   model_id: 'gpt-4',
+ *   search_query: 'React hooks',
+ *   results_found: 12,
+ *   search_scope: 'all-conversations',
+ * });
+ * ```
+ */
+export const SEARCH_PERFORMED = createAITracker<WorkspaceProperties>(properties => ({
+  name: AI_EVENTS.SEARCH_PERFORMED,
+  category: 'workspace',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+/**
+ * Track filter application
+ *
+ * @example
+ * ```typescript
+ * ai.FILTER_APPLIED({
+ *   model_id: 'claude-3-5-sonnet',
+ *   filter_type: 'date-range',
+ *   filter_value: 'last-7-days',
+ *   results_count: 24,
+ * });
+ * ```
+ */
+export const FILTER_APPLIED = createAITracker<WorkspaceProperties>(properties => ({
+  name: AI_EVENTS.FILTER_APPLIED,
+  category: 'workspace',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+// ============================================================================
+// FEEDBACK & QUALITY - User feedback and quality signals
+// ============================================================================
+
+/**
+ * Track user feedback
+ *
+ * @example
+ * ```typescript
+ * ai.FEEDBACK_PROVIDED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   message_id: 'msg_457',
+ *   feedback_type: 'thumbs-up',
+ *   feedback_comment_length: 50,
+ * });
+ * ```
+ */
+export const FEEDBACK_PROVIDED = createAITracker<FeedbackProperties>(properties => ({
+  name: AI_EVENTS.FEEDBACK_PROVIDED,
+  category: 'feedback',
+  properties,
+  requiredProperties: ['feedback_type', 'message_id'],
+}));
+
+/**
+ * Track response rating
+ *
+ * @example
+ * ```typescript
+ * ai.RESPONSE_RATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   message_id: 'msg_458',
+ *   rating_value: 5,
+ *   rating_scale: '1-5',
+ * });
+ * ```
+ */
+export const RESPONSE_RATED = createAITracker<FeedbackProperties>(properties => ({
+  name: AI_EVENTS.RESPONSE_RATED,
+  category: 'feedback',
+  properties,
+  requiredProperties: ['feedback_type', 'message_id'],
+}));
+
+/**
+ * Track bug report
+ *
+ * @example
+ * ```typescript
+ * ai.BUG_REPORTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   bug_type: 'incorrect-output',
+ *   bug_severity: 'medium',
+ * });
+ * ```
+ */
+export const BUG_REPORTED = createAITracker<FeedbackProperties>(properties => ({
+  name: AI_EVENTS.BUG_REPORTED,
+  category: 'feedback',
+  properties,
+  requiredProperties: ['feedback_type', 'message_id'],
+}));
+
+/**
+ * Track feature request
+ *
+ * @example
+ * ```typescript
+ * ai.FEATURE_REQUESTED({
+ *   model_id: 'claude-3-5-sonnet',
+ *   feature_category: 'ui',
+ *   feature_description_length: 200,
+ * });
+ * ```
+ */
+export const FEATURE_REQUESTED = createAITracker<FeedbackProperties>(properties => ({
+  name: AI_EVENTS.FEATURE_REQUESTED,
+  category: 'feedback',
+  properties,
+  requiredProperties: ['feedback_type', 'message_id'],
+}));
+
+/**
+ * Track harmful content flag
+ *
+ * @example
+ * ```typescript
+ * ai.HARMFUL_CONTENT_FLAGGED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   message_id: 'msg_459',
+ *   content_type: 'misinformation',
+ *   severity: 'high',
+ * });
+ * ```
+ */
+export const HARMFUL_CONTENT_FLAGGED = createAITracker<FeedbackProperties>(properties => ({
+  name: AI_EVENTS.HARMFUL_CONTENT_FLAGGED,
+  category: 'feedback',
+  properties,
+  requiredProperties: ['feedback_type', 'message_id'],
+}));
+
+/**
+ * Track quality issue report
+ *
+ * @example
+ * ```typescript
+ * ai.QUALITY_ISSUE_REPORTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   message_id: 'msg_460',
+ *   issue_type: 'factual-error',
+ *   issue_severity: 'medium',
+ * });
+ * ```
+ */
+export const QUALITY_ISSUE_REPORTED = createAITracker<FeedbackProperties>(properties => ({
+  name: AI_EVENTS.QUALITY_ISSUE_REPORTED,
+  category: 'feedback',
+  properties,
+  requiredProperties: ['feedback_type', 'message_id'],
+}));
+
+// ============================================================================
+// SYSTEM & PERFORMANCE - Technical operations and model management
+// ============================================================================
+
+/**
+ * Track model switch
+ *
+ * @example
+ * ```typescript
+ * ai.MODEL_SWITCHED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   previous_model: 'gpt-3.5-turbo',
+ *   switch_reason: 'user-preference',
+ * });
+ * ```
+ */
+export const MODEL_SWITCHED = createAITracker<SystemProperties>(properties => ({
+  name: AI_EVENTS.MODEL_SWITCHED,
+  category: 'system',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track settings update
+ *
+ * @example
+ * ```typescript
+ * ai.SETTINGS_UPDATED({
+ *   model_id: 'claude-3-5-sonnet',
+ *   user_id: 'user_123',
+ *   settings_category: 'appearance',
+ *   settings_changed: ['theme', 'font-size'],
+ * });
+ * ```
+ */
+export const SETTINGS_UPDATED = createAITracker<SystemProperties>(properties => ({
+  name: AI_EVENTS.SETTINGS_UPDATED,
+  category: 'system',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track error occurrence
+ *
+ * @example
+ * ```typescript
+ * ai.ERROR_OCCURRED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   error_type: 'api-error',
+ *   error_code: '500',
+ *   error_message: 'Internal server error',
+ * });
+ * ```
+ */
+export const ERROR_OCCURRED = createAITracker<SystemProperties>(properties => ({
+  name: AI_EVENTS.ERROR_OCCURRED,
+  category: 'system',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track rate limit hit
+ *
+ * @example
+ * ```typescript
+ * ai.RATE_LIMIT_HIT({
+ *   model_id: 'claude-3-5-sonnet',
+ *   user_id: 'user_123',
+ *   limit_type: 'requests-per-minute',
+ *   retry_after_seconds: 60,
+ * });
+ * ```
+ */
+export const RATE_LIMIT_HIT = createAITracker<SystemProperties>(properties => ({
+  name: AI_EVENTS.RATE_LIMIT_HIT,
+  category: 'system',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track token usage
+ *
+ * @example
+ * ```typescript
+ * ai.TOKEN_USAGE_TRACKED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   input_tokens: 1500,
+ *   output_tokens: 800,
+ *   total_tokens: 2300,
+ *   cost: 0.0345,
+ *   cost_currency: 'USD',
+ * });
+ * ```
+ */
+export const TOKEN_USAGE_TRACKED = createAITracker<BaseAIProperties>(properties => ({
+  name: AI_EVENTS.TOKEN_USAGE_TRACKED,
+  category: 'system',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track performance measurement
+ *
+ * @example
+ * ```typescript
+ * ai.PERFORMANCE_MEASURED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   operation_type: 'message-generation',
+ *   duration_ms: 850,
+ *   performance_tier: 'normal',
+ * });
+ * ```
+ */
+export const PERFORMANCE_MEASURED = createAITracker<PerformanceProperties>(properties => ({
+  name: AI_EVENTS.PERFORMANCE_MEASURED,
+  category: 'system',
+  properties,
+  requiredProperties: [],
+}));
+
+// ============================================================================
+// TOOLS & FUNCTIONS - Tool calls and function execution
+// ============================================================================
+
+/**
+ * Track tool call start
+ *
+ * @example
+ * ```typescript
+ * ai.TOOL_CALL_STARTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   tool_name: 'web_search',
+ *   tool_type: 'built-in',
+ * });
+ * ```
+ */
+export const TOOL_CALL_STARTED = createAITracker<ToolProperties>(properties => ({
+  name: AI_EVENTS.TOOL_CALL_STARTED,
+  category: 'tool',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track tool call completion
+ *
+ * @example
+ * ```typescript
+ * ai.TOOL_CALL_COMPLETED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   tool_name: 'calculator',
+ *   tool_type: 'custom',
+ *   result_status: 'success',
+ *   execution_time_ms: 50,
+ * });
+ * ```
+ */
+export const TOOL_CALL_COMPLETED = createAITracker<ToolProperties>(properties => ({
+  name: AI_EVENTS.TOOL_CALL_COMPLETED,
+  category: 'tool',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track tool call failure
+ *
+ * @example
+ * ```typescript
+ * ai.TOOL_CALL_FAILED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   tool_name: 'api_caller',
+ *   tool_type: 'custom',
+ *   error_message: 'Connection timeout',
+ *   execution_time_ms: 5000,
+ * });
+ * ```
+ */
+export const TOOL_CALL_FAILED = createAITracker<ToolProperties>(properties => ({
+  name: AI_EVENTS.TOOL_CALL_FAILED,
+  category: 'tool',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track function execution
+ *
+ * @example
+ * ```typescript
+ * ai.FUNCTION_EXECUTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   function_name: 'getData',
+ *   execution_status: 'success',
+ *   execution_time_ms: 120,
+ * });
+ * ```
+ */
+export const FUNCTION_EXECUTED = createAITracker<ToolProperties>(properties => ({
+  name: AI_EVENTS.FUNCTION_EXECUTED,
+  category: 'tool',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track API request
+ *
+ * @example
+ * ```typescript
+ * ai.API_REQUEST_MADE({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   api_endpoint: '/v1/data',
+ *   api_method: 'GET',
+ *   response_status: 200,
+ *   response_time_ms: 250,
+ * });
+ * ```
+ */
+export const API_REQUEST_MADE = createAITracker<ToolProperties>(properties => ({
+  name: AI_EVENTS.API_REQUEST_MADE,
+  category: 'tool',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track plugin activation
+ *
+ * @example
+ * ```typescript
+ * ai.PLUGIN_ACTIVATED({
+ *   model_id: 'claude-3-5-sonnet',
+ *   plugin_name: 'web-browser',
+ *   plugin_version: '1.2.0',
+ * });
+ * ```
+ */
+export const PLUGIN_ACTIVATED = createAITracker<ToolProperties>(properties => ({
+  name: AI_EVENTS.PLUGIN_ACTIVATED,
+  category: 'tool',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track extension usage
+ *
+ * @example
+ * ```typescript
+ * ai.EXTENSION_USED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   extension_name: 'code-runner',
+ *   extension_action: 'execute',
+ * });
+ * ```
+ */
+export const EXTENSION_USED = createAITracker<ToolProperties>(properties => ({
+  name: AI_EVENTS.EXTENSION_USED,
+  category: 'tool',
+  properties,
+  requiredProperties: [],
+}));
+
+// ============================================================================
+// SEARCH & CITATIONS - Web search and source attribution
+// ============================================================================
+
+/**
+ * Track web search
+ *
+ * @example
+ * ```typescript
+ * ai.WEB_SEARCH_PERFORMED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   search_query: 'latest React 19 features',
+ *   search_engine: 'google',
+ *   results_count: 10,
+ *   search_time_ms: 450,
+ * });
+ * ```
+ */
+export const WEB_SEARCH_PERFORMED = createAITracker<SearchProperties>(properties => ({
+  name: AI_EVENTS.WEB_SEARCH_PERFORMED,
+  category: 'context',
+  properties,
+  requiredProperties: ['query', 'search_scope'],
+}));
+
+/**
+ * Track citation addition
+ *
+ * @example
+ * ```typescript
+ * ai.CITATION_ADDED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   message_id: 'msg_461',
+ *   citation_source: 'https://react.dev',
+ *   citation_type: 'web',
+ * });
+ * ```
+ */
+export const CITATION_ADDED = createAITracker<SearchProperties>(properties => ({
+  name: AI_EVENTS.CITATION_ADDED,
+  category: 'context',
+  properties,
+  requiredProperties: ['query', 'search_scope'],
+}));
+
+/**
+ * Track browse session start
+ *
+ * @example
+ * ```typescript
+ * ai.BROWSE_SESSION_STARTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   browse_target_url: 'https://example.com',
+ * });
+ * ```
+ */
+export const BROWSE_SESSION_STARTED = createAITracker<SearchProperties>(properties => ({
+  name: AI_EVENTS.BROWSE_SESSION_STARTED,
+  category: 'context',
+  properties,
+  requiredProperties: ['query', 'search_scope'],
+}));
+
+/**
+ * Track page content fetch
+ *
+ * @example
+ * ```typescript
+ * ai.PAGE_CONTENT_FETCHED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   page_url: 'https://example.com/article',
+ *   content_length: 5000,
+ *   fetch_time_ms: 800,
+ * });
+ * ```
+ */
+export const PAGE_CONTENT_FETCHED = createAITracker<SearchProperties>(properties => ({
+  name: AI_EVENTS.PAGE_CONTENT_FETCHED,
+  category: 'context',
+  properties,
+  requiredProperties: ['query', 'search_scope'],
+}));
+
+/**
+ * Track search results ranking
+ *
+ * @example
+ * ```typescript
+ * ai.SEARCH_RESULTS_RANKED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   results_count: 20,
+ *   ranking_algorithm: 'relevance',
+ * });
+ * ```
+ */
+export const SEARCH_RESULTS_RANKED = createAITracker<SearchProperties>(properties => ({
+  name: AI_EVENTS.SEARCH_RESULTS_RANKED,
+  category: 'context',
+  properties,
+  requiredProperties: ['query', 'search_scope'],
+}));
+
+/**
+ * Track external source access
+ *
+ * @example
+ * ```typescript
+ * ai.EXTERNAL_SOURCE_ACCESSED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   source_type: 'api',
+ *   source_url: 'https://api.example.com/data',
+ *   access_time_ms: 350,
+ * });
+ * ```
+ */
+export const EXTERNAL_SOURCE_ACCESSED = createAITracker<SearchProperties>(properties => ({
+  name: AI_EVENTS.EXTERNAL_SOURCE_ACCESSED,
+  category: 'context',
+  properties,
+  requiredProperties: ['query', 'search_scope'],
+}));