@od-oneapp/analytics 2026.1.1301

package/src/shared/emitters/ai/events/agent.ts

@@ -0,0 +1,130 @@
+/**
+ * @fileoverview Agent-related AI SDK v6 events
+ * Agent-related AI SDK v6 events
+ */
+
+import { trackAISDK } from '../track-ai-sdk';
+import {
+  type AgentProperties,
+  AI_SDK_EVENTS,
+  type AISdkEventSpec,
+  type CompletionProperties,
+} from '../types';
+import {
+  cleanProperties,
+  normalizeBaseProperties,
+  normalizeTokenUsage,
+  validateRequiredProperties,
+} from '../utils';
+
+import type { EmitterOptions, EmitterTrackPayload } from '../../emitter-types';
+
+/**
+ * Track when an AI agent is created
+ */
+export function agentCreated(
+  properties: AgentProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    agent_type: properties.agent_type,
+    system_prompt_length: properties.system_prompt_length,
+    tools_available: properties.tools_available,
+    tools_count: properties.tools_count,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.AGENT_CREATED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when an AI agent execution starts
+ */
+export function agentExecutionStarted(
+  properties: AgentProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'agent_id']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    agent_type: properties.agent_type,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.AGENT_EXECUTION_STARTED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'agent_id'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when an AI agent execution completes successfully
+ */
+export function agentExecutionCompleted(
+  properties: CompletionProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'agent_id', 'status']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    ...normalizeTokenUsage(properties),
+    completion_type: properties.completion_type,
+    status: properties.status,
+    total_duration_ms: properties.total_duration_ms,
+    step_count: properties.step_count,
+    finish_reason: properties.finish_reason,
+    has_tools: properties.has_tools,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.AGENT_EXECUTION_COMPLETED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'agent_id', 'status'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when an AI agent execution fails
+ */
+export function agentExecutionFailed(
+  properties: CompletionProperties & { error_message: string },
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'agent_id', 'error_message']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    ...normalizeTokenUsage(properties),
+    completion_type: properties.completion_type,
+    status: 'failed' as const,
+    error_message: properties.error_message,
+    retry_count: properties.retry_count,
+    total_duration_ms: properties.total_duration_ms,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.AGENT_EXECUTION_FAILED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'agent_id', 'error_message'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}

package/src/shared/emitters/ai/events/artifacts.ts

@@ -0,0 +1,167 @@
+/**
+ * @fileoverview Artifacts & Canvas Events
+ * Artifacts & Canvas Events
+ *
+ * Interactive artifacts and canvas mode features (Claude-style).
+ * Track creation, editing, execution, and interaction with artifacts.
+ */
+
+import { createAITracker } from '../track-ai';
+import { AI_EVENTS, type ArtifactProperties, type CanvasProperties } from '../types';
+
+/**
+ * Track artifact creation
+ *
+ * @example
+ * ```typescript
+ * ai.ARTIFACT_CREATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   artifact_id: 'art_001',
+ *   artifact_type: 'react-component',
+ *   action: 'create',
+ *   language: 'tsx',
+ *   content_length: 850,
+ * });
+ * ```
+ */
+export const ARTIFACT_CREATED = createAITracker<ArtifactProperties>(properties => ({
+  name: AI_EVENTS.ARTIFACT_CREATED,
+  category: 'artifacts',
+  properties,
+  requiredProperties: ['action', 'artifact_type'],
+}));
+
+/**
+ * Track artifact editing
+ *
+ * @example
+ * ```typescript
+ * ai.ARTIFACT_EDITED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   artifact_id: 'art_001',
+ *   artifact_type: 'react-component',
+ *   action: 'edit',
+ *   version: 2,
+ *   changes_description: 'Updated button styling',
+ * });
+ * ```
+ */
+export const ARTIFACT_EDITED = createAITracker<ArtifactProperties>(properties => ({
+  name: AI_EVENTS.ARTIFACT_EDITED,
+  category: 'artifacts',
+  properties,
+  requiredProperties: ['action', 'artifact_type'],
+}));
+
+/**
+ * Track artifact execution
+ *
+ * @example
+ * ```typescript
+ * ai.ARTIFACT_EXECUTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   artifact_id: 'art_001',
+ *   artifact_type: 'code',
+ *   action: 'execute',
+ *   execution_status: 'success',
+ *   execution_time_ms: 150,
+ * });
+ * ```
+ */
+export const ARTIFACT_EXECUTED = createAITracker<ArtifactProperties>(properties => ({
+  name: AI_EVENTS.ARTIFACT_EXECUTED,
+  category: 'artifacts',
+  properties,
+  requiredProperties: ['action', 'artifact_type'],
+}));
+
+/**
+ * Track artifact publishing
+ *
+ * @example
+ * ```typescript
+ * ai.ARTIFACT_PUBLISHED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   artifact_id: 'art_001',
+ *   artifact_type: 'visualization',
+ *   action: 'publish',
+ *   visibility: 'public',
+ *   publish_platform: 'web',
+ * });
+ * ```
+ */
+export const ARTIFACT_PUBLISHED = createAITracker<ArtifactProperties>(properties => ({
+  name: AI_EVENTS.ARTIFACT_PUBLISHED,
+  category: 'artifacts',
+  properties,
+  requiredProperties: ['action', 'artifact_type'],
+}));
+
+/**
+ * Track artifact forking
+ *
+ * @example
+ * ```typescript
+ * ai.ARTIFACT_FORKED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   artifact_id: 'art_001',
+ *   artifact_type: 'react-component',
+ *   action: 'fork',
+ *   new_artifact_id: 'art_002',
+ *   fork_reason: 'experiment',
+ * });
+ * ```
+ */
+export const ARTIFACT_FORKED = createAITracker<ArtifactProperties>(properties => ({
+  name: AI_EVENTS.ARTIFACT_FORKED,
+  category: 'artifacts',
+  properties,
+  requiredProperties: ['action', 'artifact_type'],
+}));
+
+/**
+ * Track canvas mode opened
+ *
+ * @example
+ * ```typescript
+ * ai.CANVAS_OPENED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   canvas_type: 'code',
+ *   initial_content_length: 500,
+ *   canvas_size: 'full-screen',
+ * });
+ * ```
+ */
+export const CANVAS_OPENED = createAITracker<CanvasProperties>(properties => ({
+  name: AI_EVENTS.CANVAS_OPENED,
+  category: 'artifacts',
+  properties,
+  requiredProperties: ['action'],
+}));
+
+/**
+ * Track live preview toggle
+ *
+ * @example
+ * ```typescript
+ * ai.LIVE_PREVIEW_TOGGLED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-net',
+ *   artifact_id: 'art_001',
+ *   preview_enabled: true,
+ *   preview_type: 'browser',
+ * });
+ * ```
+ */
+export const LIVE_PREVIEW_TOGGLED = createAITracker<CanvasProperties>(properties => ({
+  name: AI_EVENTS.LIVE_PREVIEW_TOGGLED,
+  category: 'artifacts',
+  properties,
+  requiredProperties: ['action'],
+}));

package/src/shared/emitters/ai/events/chat.ts

@@ -0,0 +1,126 @@
+/**
+ * @fileoverview Chat-related AI SDK v6 events
+ * Chat-related AI SDK v6 events
+ */
+
+import { trackAISDK } from '../track-ai-sdk';
+import {
+  AI_SDK_EVENTS,
+  type AISdkEventSpec,
+  type ChatMessageProperties,
+  type SessionProperties,
+} from '../types';
+import { cleanProperties, normalizeBaseProperties, validateRequiredProperties } from '../utils';
+
+import type { EmitterOptions, EmitterTrackPayload } from '../../emitter-types';
+
+/**
+ * Track when a chat session starts
+ */
+export function chatSessionStarted(
+  properties: SessionProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'session_id']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    session_type: properties.session_type,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.CHAT_SESSION_STARTED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'session_id'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when a chat session ends
+ */
+export function chatSessionEnded(
+  properties: SessionProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'session_id']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    duration_ms: properties.duration_ms,
+    message_count: properties.message_count,
+    tool_calls_count: properties.tool_calls_count,
+    total_tokens: properties.total_tokens,
+    session_end_reason: properties.session_end_reason,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.CHAT_SESSION_ENDED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'session_id'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when a user sends a chat message
+ */
+export function chatMessageSent(
+  properties: ChatMessageProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'message_role']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    message_id: properties.message_id,
+    message_role: properties.message_role,
+    message_length: properties.message_length,
+    message_index: properties.message_index,
+    has_images: properties.has_images,
+    parent_message_id: properties.parent_message_id,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.CHAT_MESSAGE_SENT,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'message_role'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when the assistant's chat message is received
+ */
+export function chatMessageReceived(
+  properties: ChatMessageProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'message_role']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    message_id: properties.message_id,
+    message_role: properties.message_role,
+    message_length: properties.message_length,
+    message_index: properties.message_index,
+    finish_reason: properties.finish_reason,
+    response_time_ms: properties.response_time_ms,
+    is_streaming: properties.is_streaming,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.CHAT_MESSAGE_RECEIVED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'message_role'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}

package/src/shared/emitters/ai/events/chatbot-ecommerce.ts

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview E-commerce chatbot-specific AI SDK v6 events
+ * E-commerce chatbot-specific AI SDK v6 events
+ */
+
+import { trackAISDK } from '../track-ai-sdk';
+import { AI_SDK_EVENTS, type AISdkEventSpec, type ChatbotEcommerceProperties } from '../types';
+import {
+  cleanProperties,
+  detectChatbotIntent,
+  normalizeBaseProperties,
+  truncateArray,
+  validateRequiredProperties,
+} from '../utils';
+
+import type { EmitterOptions, EmitterTrackPayload } from '../../emitter-types';
+
+/**
+ * Maximum number of product IDs to include in chatbot ecommerce events.
+ * Limits payload size and prevents excessive data in analytics.
+ */
+export const MAX_PRODUCT_IDS = 20;
+
+/**
+ * Track when chatbot detects user intent
+ */
+export function chatbotIntentDetected(
+  properties: ChatbotEcommerceProperties & { message: string },
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'message']);
+
+  // Auto-detect intent if not provided
+  const intent = properties.intent_detected ?? detectChatbotIntent(properties.message);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    intent_detected: intent,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.CHATBOT_INTENT_DETECTED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when chatbot assists with cart operations
+ */
+export function chatbotCartAssisted(
+  properties: ChatbotEcommerceProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'cart_id']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    cart_id: properties.cart_id,
+    cart_value: properties.cart_value,
+    product_count: properties.product_count,
+    product_ids: properties.product_ids
+      ? truncateArray(properties.product_ids, MAX_PRODUCT_IDS)
+      : undefined,
+    intent_detected: properties.intent_detected,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.CHATBOT_CART_ASSISTED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'cart_id'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when chatbot assists with order-related queries
+ */
+export function chatbotOrderAssisted(
+  properties: ChatbotEcommerceProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'order_id']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    order_id: properties.order_id,
+    intent_detected: properties.intent_detected,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.CHATBOT_ORDER_ASSISTED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'order_id'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when chatbot shows product recommendations
+ */
+export function chatbotProductRecommended(
+  properties: ChatbotEcommerceProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'product_ids']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    product_count: properties.product_count ?? properties.product_ids?.length,
+    product_ids: properties.product_ids
+      ? truncateArray(properties.product_ids, MAX_PRODUCT_IDS)
+      : undefined,
+    recommendation_shown: true,
+    intent_detected: properties.intent_detected,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.CHATBOT_PRODUCT_RECOMMENDED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'product_ids'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}

package/src/shared/emitters/ai/events/completion.ts

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview Completion-related AI SDK v6 events
+ * Completion-related AI SDK v6 events
+ */
+
+import { trackAISDK } from '../track-ai-sdk';
+import { AI_SDK_EVENTS, type AISdkEventSpec, type CompletionProperties } from '../types';
+import {
+  cleanProperties,
+  normalizeBaseProperties,
+  normalizeModelConfig,
+  normalizeTokenUsage,
+  validateRequiredProperties,
+} from '../utils';
+
+import type { EmitterOptions, EmitterTrackPayload } from '../../emitter-types';
+
+/**
+ * Track when a completion is requested
+ */
+export function completionRequested(
+  properties: CompletionProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'completion_type']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    ...normalizeModelConfig(properties),
+    completion_type: properties.completion_type,
+    prompt_length: properties.prompt_length,
+    has_tools: properties.has_tools,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.COMPLETION_REQUESTED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'completion_type'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when a completion is successfully generated
+ */
+export function completionGenerated(
+  properties: CompletionProperties,
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'completion_type', 'status']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    ...normalizeTokenUsage(properties),
+    ...normalizeModelConfig(properties),
+    completion_type: properties.completion_type,
+    status: properties.status,
+    finish_reason: properties.finish_reason,
+    total_duration_ms: properties.total_duration_ms,
+    step_count: properties.step_count,
+    retry_count: properties.retry_count,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.COMPLETION_GENERATED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'completion_type', 'status'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}
+
+/**
+ * Track when a completion fails
+ */
+export function completionFailed(
+  properties: CompletionProperties & { error_message: string },
+  options?: EmitterOptions,
+): EmitterTrackPayload {
+  validateRequiredProperties(properties, ['model_id', 'completion_type', 'error_message']);
+
+  const normalizedProps = {
+    ...normalizeBaseProperties(properties),
+    ...normalizeTokenUsage(properties),
+    completion_type: properties.completion_type,
+    status: 'failed' as const,
+    error_message: properties.error_message,
+    retry_count: properties.retry_count,
+    total_duration_ms: properties.total_duration_ms,
+  };
+
+  const eventSpec: AISdkEventSpec = {
+    name: AI_SDK_EVENTS.COMPLETION_FAILED,
+    category: 'ai-sdk',
+    properties: cleanProperties(normalizedProps),
+    requiredProperties: ['model_id', 'completion_type', 'error_message'],
+  };
+
+  return trackAISDK(eventSpec, options);
+}