wiil-core-js 0.0.82

package/dist/core/conversation/conversation-config.schema.d.ts

@@ -0,0 +1,644 @@
+import { z } from "zod";
+import { MessageType } from "./conversation-message.schema";
+import { ConversationDirection, ConversationStatus, ConversationSummarySentiment, ServiceConversationType } from "../type-definitions";
+/**
+ * @fileoverview Conversation configuration schema definitions.
+ *
+ * Conversations represent individual interaction sessions between users and AI agents through various channels
+ * (phone, SMS, web chat, email). They track message history, status progression, call metadata, and relationship
+ * to deployment configurations. Each conversation is scoped to a project.
+ *
+ * @module conversation/conversation-config
+ */
+/**
+ * Conversation summary schema.
+ *
+ * AI-generated summary capturing the essence of a conversation including key discussion points,
+ * required follow-up actions, and overall sentiment analysis. Generated post-conversation for
+ * reporting, analytics, and customer service quality assurance.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Generated By**: Post-conversation AI summarization pipeline
+ * - **Used For**: Analytics dashboards, quality assurance, and customer service reports
+ * - **Stored In**: ServiceConversationConfig.conversationSummary field (optional)
+ *
+ * @typedef {Object} ConversationSummary
+ * @property {string} summary - Concise 1-3 sentence overview of the entire conversation capturing main topics and outcomes
+ * @property {string[]} key_points - Bullet points highlighting important discussion topics, decisions made, or information exchanged during the conversation
+ * @property {string[]} action_items - Specific follow-up tasks, commitments, or next steps identified during the conversation (e.g., 'Send quote by Friday', 'Schedule follow-up call')
+ * @property {string} sentiment - Overall emotional tone and customer satisfaction level detected from the conversation (POSITIVE, NEGATIVE, NEUTRAL, MIXED)
+ */
+export declare const ConversationSummarySchema: z.ZodObject<{
+    summary: z.ZodString;
+    key_points: z.ZodArray<z.ZodString>;
+    action_items: z.ZodArray<z.ZodString>;
+    sentiment: z.ZodEnum<typeof ConversationSummarySentiment>;
+}, z.core.$strip>;
+/**
+ * Message schema for conversation messages.
+ *
+ * Lightweight message representation used within conversation configurations. Simplified version
+ * compared to the full ConversationMessageSchema for efficient storage and retrieval in conversation
+ * message arrays.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Used In**: Conversation message arrays for quick access
+ * - **Relationship**: Simplified version of full message schemas (UserChatMessage, AssistantChatMessage, etc.)
+ * - **Storage**: Embedded within conversation documents for fast message loading
+ *
+ * @typedef {Object} Message
+ * @property {string} [id] - Optional internal database ID for the message record
+ * @property {string} messageId - Unique identifier for this message used for deduplication and reference (typically UUID)
+ * @property {string} content - Text content of the message sent by user or assistant
+ * @property {string} message_type - Type of message sender indicating who sent this message (user or assistant)
+ * @property {Date} timestamp - JavaScript Date object representing when the message was created and sent
+ * @property {Object} metadata - Additional message-specific metadata including attachments, formatting, media URLs, delivery status, or channel-specific attributes
+ * @property {number} [created_at] - Unix timestamp in milliseconds when the message was created (for sorting and filtering)
+ */
+export declare const MessageSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodString;
+    content: z.ZodString;
+    message_type: z.ZodEnum<typeof MessageType>;
+    timestamp: z.ZodDate;
+    metadata: z.ZodRecord<z.ZodString, z.ZodAny>;
+    created_at: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Message = z.infer<typeof MessageSchema>;
+/**
+ * Display message schema.
+ *
+ * Simplified message format for UI display purposes, containing only the
+ * essential fields needed for rendering messages in chat interfaces.
+ *
+ * @typedef {Object} DisplayMessage
+ * @property {string} id - Unique identifier for display purposes
+ * @property {string} sender - Who sent this message (user or assistant)
+ * @property {string} content - Message content to display
+ * @property {Date} timestamp - When the message was sent
+ */
+export declare const DisplayMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    sender: z.ZodUnion<readonly [z.ZodLiteral<"user">, z.ZodLiteral<"assistant">]>;
+    content: z.ZodString;
+    timestamp: z.ZodDate;
+}, z.core.$strip>;
+export type DisplayMessage = z.infer<typeof DisplayMessageSchema>;
+/**
+ * Conversation context schema.
+ *
+ * Optional context to guide conversations, enabling deep-linking to specific
+ * products, services, or resources. Used to pre-populate conversation context
+ * when users click through from specific pages or marketing campaigns.
+ *
+ * @typedef {Object} ConversationContext
+ * @property {string} [message] - Auto-sends as the user's first message
+ * @property {string} [productId] - Deep-link to a product
+ * @property {string} [menuItemId] - Deep-link to a menu item
+ * @property {string} [serviceId] - Deep-link to a service
+ * @property {string} [propertyId] - Deep-link to a property
+ * @property {string} [resourceId] - Deep-link to a resource (rental/room)
+ * @property {string} [requiredServiceId] - Pre-select a required service
+ * @property {string} [locationId] - Context of a specific business location
+ */
+export declare const ConversationContextSchema: z.ZodObject<{
+    message: z.ZodOptional<z.ZodString>;
+    productId: z.ZodOptional<z.ZodString>;
+    menuItemId: z.ZodOptional<z.ZodString>;
+    serviceId: z.ZodOptional<z.ZodString>;
+    propertyId: z.ZodOptional<z.ZodString>;
+    resourceId: z.ZodOptional<z.ZodString>;
+    requiredServiceId: z.ZodOptional<z.ZodString>;
+    locationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ConversationContext = z.infer<typeof ConversationContextSchema>;
+/**
+ * Union of all conversation message types.
+ *
+ * Discriminated union supporting user, AI agent, human agent, and system messages
+ * for both chat and email channels.
+ */
+export declare const ConversationMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
+    conversation_config_id: z.ZodString;
+    message: z.ZodString;
+    timestamp: z.ZodDefault<z.ZodNumber>;
+    llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    message_type: z.ZodDefault<z.ZodLiteral<MessageType.USER>>;
+    user_message_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    last_assistant_message_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    conversation_config_id: z.ZodString;
+    message: z.ZodString;
+    timestamp: z.ZodDefault<z.ZodNumber>;
+    llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    message_type: z.ZodDefault<z.ZodLiteral<MessageType.AGENT>>;
+    assistant_message_id: z.ZodString;
+    last_user_message_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    conversation_config_id: z.ZodString;
+    message: z.ZodString;
+    timestamp: z.ZodDefault<z.ZodNumber>;
+    llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    subject: z.ZodString;
+    isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+    message_type: z.ZodDefault<z.ZodLiteral<MessageType.USER>>;
+    provider_message_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    conversation_config_id: z.ZodString;
+    message: z.ZodString;
+    timestamp: z.ZodDefault<z.ZodNumber>;
+    llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    subject: z.ZodString;
+    isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+    message_type: z.ZodDefault<z.ZodLiteral<MessageType.AGENT>>;
+}, z.core.$strip>, z.ZodObject<{
+    conversation_config_id: z.ZodString;
+    message: z.ZodString;
+    timestamp: z.ZodDefault<z.ZodNumber>;
+    llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    message_type: z.ZodDefault<z.ZodLiteral<MessageType.HUMAN_AGENT>>;
+    agent_message_id: z.ZodString;
+    agent_session_id: z.ZodString;
+    last_user_message_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    conversation_config_id: z.ZodString;
+    message: z.ZodString;
+    timestamp: z.ZodDefault<z.ZodNumber>;
+    llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    subject: z.ZodString;
+    isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+    message_type: z.ZodDefault<z.ZodLiteral<MessageType.HUMAN_AGENT>>;
+    agent_session_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    conversation_config_id: z.ZodString;
+    message: z.ZodString;
+    timestamp: z.ZodDefault<z.ZodNumber>;
+    llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    message_type: z.ZodDefault<z.ZodLiteral<MessageType.SYSTEM>>;
+    system_message_id: z.ZodString;
+    event_type: z.ZodEnum<typeof import("./conversation-message.schema").SystemMessageEventType>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>]>;
+/**
+ * Conversation state history schema for tracking status changes.
+ *
+ * Audit trail recording each status transition throughout a conversation's lifecycle. Enables tracking
+ * conversation progression from initiation to completion, understanding conversation flow patterns, and
+ * analyzing resolution times.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Used In**: ServiceConversationConfig.state_history array
+ * - **Purpose**: Audit trail for status transitions and conversation lifecycle tracking
+ * - **Analytics**: Used for measuring average handling time, resolution rates, and conversation flow analysis
+ *
+ * **Status Lifecycle:**
+ * - **ACTIVE**: Conversation currently in progress with ongoing message exchange
+ * - **COMPLETED**: Conversation successfully concluded with issue resolved or information provided
+ * - **FAILED**: Conversation encountered errors or technical failures
+ * - **ABANDONED**: User left conversation without resolution
+ * - **TRANSFERRED**: Call transferred to human agent
+ *
+ * @typedef {Object} ConversationStateHistory
+ * @property {string} status - The conversation status at this point in the lifecycle (ACTIVE, COMPLETED, FAILED, ABANDONED, TRANSFERRED)
+ * @property {number} timestamp - Unix timestamp in milliseconds when this status was set and recorded
+ * @property {string|null} [reason] - Optional human-readable explanation for why the status changed (e.g., 'User requested transfer', 'Timeout after 5 minutes of inactivity', 'Issue resolved')
+ * @property {Object|null} [metadata] - Additional context about the state change including triggering events, system metrics, or escalation details
+ */
+export declare const ConversationStateHistorySchema: z.ZodObject<{
+    status: z.ZodEnum<typeof ConversationStatus>;
+    timestamp: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+}, z.core.$strip>;
+/**
+ * Base conversation configuration schema.
+ *
+ * Foundation schema for all conversation types capturing the essential attributes of an interaction session
+ * between a user and an AI agent. Conversations link to deployment configurations, track message history,
+ * monitor status progression, and collect voice processing metadata for telephony interactions.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Relationship to Deployments**: N:1 - Multiple conversations use one deployment configuration
+ * - **Relationship to Projects**: N:1 - Conversations are scoped to projects for organizational grouping
+ * - **Relationship to Channels**: N:1 - Multiple conversations occur through one channel
+ * - **Extended By**: ServiceConversationConfigSchema adds conversation-specific fields (id, call transfer, etc.)
+ * - **Storage**: Primary conversation record with embedded messages for performance
+ *
+ * **Conversation Types:**
+ * - **OTT_CHAT**: Over-the-top chat (web, mobile app messaging)
+ * - **TELEPHONY_CALL**: Voice phone calls with STT/TTS processing
+ * - **SMS**: Text message conversations
+ * - **EMAIL**: Email-based interactions
+ * - **WHATSAPP**: WhatsApp messaging conversations
+ *
+ * @typedef {Object} BaseConversationConfig
+ * @property {string} channel_id - ID of the deployment channel through which this conversation is conducted (references DeploymentChannel)
+ * @property {string} project_id - ID of the project this conversation is associated with for organizational grouping and access control (references Project)
+ * @property {string} deployment_config_id - ID of the deployment configuration that powers this conversation (N:1 relationship, references DeploymentConfiguration)
+ * @property {string} channel_identifier - Unique identifier for the specific communication endpoint (phone number in E.164 format, chat widget ID, email address, WhatsApp number)
+ * @property {string} [instruction_config_id] - Optional ID of the instruction configuration overriding deployment defaults for this specific conversation (references InstructionConfiguration)
+ * @property {string} [partner_user_id] - External partner or user identifier from integrated systems for cross-platform user tracking and CRM integration
+ * @property {string} conversation_type - Type of conversation defining the communication channel and interaction mode (OTT_CHAT, TELEPHONY_CALL, SMS, EMAIL, WHATSAPP)
+ * @property {string} [model_id] - AI model ID used for this conversation, may override deployment configuration model for A/B testing or specialized scenarios
+ * @property {number} [user_id] - Internal platform user ID for authenticated users, null for anonymous conversations
+ * @property {number} [created_at] - Unix timestamp in milliseconds when conversation was initiated (default: current time)
+ * @property {Array} [messages] - Array of messages exchanged in this conversation for quick access without separate queries (embedded for performance)
+ * @property {boolean} is_campaign - Flag indicating if this conversation is part of a marketing or outreach campaign (default: false for inbound conversations)
+ * @property {string} [customer_id] - Customer or contact ID from CRM or external system for customer relationship tracking and conversation history aggregation
+ * @property {string} [status] - Current operational status of the conversation (ACTIVE, COMPLETED, FAILED, ABANDONED, TRANSFERRED)
+ * @property {number} durationInSeconds - Duration of the conversation in seconds for billing, analytics, and average handling time calculations (default: 15)
+ * @property {string} [stt_model_id] - Speech-to-Text model ID used for voice conversations to transcribe user speech (e.g., 'whisper-v3', references WiilSupportModel)
+ * @property {string} [tts_model_id] - Text-to-Speech model ID used for voice conversations to synthesize agent responses (e.g., 'eleven-labs-v2', references WiilSupportModel)
+ * @property {Object} [conversationSummary] - Optional AI-generated summary of the conversation including key points, action items, and sentiment analysis (populated post-conversation)
+ * @property {string} [created_day] - The day the conversation was created in YYYY-MM-DD format for daily aggregation queries and analytics partitioning
+ * @property {Array} [state_history] - Historical audit trail of status changes throughout the conversation lifecycle for flow analysis and troubleshooting
+ * @property {number} [updated_at] - Unix timestamp in milliseconds when conversation was last modified (message added, status changed, summary generated)
+ * @property {number} [deleted_at] - Unix timestamp in milliseconds when conversation was soft-deleted, null if active (supports data retention policies)
+ */
+export declare const BaseConversationConfigSchema: z.ZodObject<{
+    channel_id: z.ZodString;
+    project_id: z.ZodString;
+    deployment_config_id: z.ZodString;
+    channel_identifier: z.ZodString;
+    instruction_config_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    partner_user_id: z.ZodOptional<z.ZodString>;
+    conversation_type: z.ZodEnum<typeof ServiceConversationType>;
+    model_id: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodNumber>;
+    created_at: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    messages: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.USER>>;
+        user_message_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        last_assistant_message_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.AGENT>>;
+        assistant_message_id: z.ZodString;
+        last_user_message_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        subject: z.ZodString;
+        isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.USER>>;
+        provider_message_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        subject: z.ZodString;
+        isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.AGENT>>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.HUMAN_AGENT>>;
+        agent_message_id: z.ZodString;
+        agent_session_id: z.ZodString;
+        last_user_message_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        subject: z.ZodString;
+        isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.HUMAN_AGENT>>;
+        agent_session_id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.SYSTEM>>;
+        system_message_id: z.ZodString;
+        event_type: z.ZodEnum<typeof import("./conversation-message.schema").SystemMessageEventType>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>]>>>>;
+    is_campaign: z.ZodDefault<z.ZodBoolean>;
+    customer_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    location_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof ConversationStatus>>>;
+    durationInSeconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    stt_model_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    tts_model_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    conversationSummary: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodString;
+        key_points: z.ZodArray<z.ZodString>;
+        action_items: z.ZodArray<z.ZodString>;
+        sentiment: z.ZodEnum<typeof ConversationSummarySentiment>;
+    }, z.core.$strip>>>;
+    created_day: z.ZodOptional<z.ZodString>;
+    state_history: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        status: z.ZodEnum<typeof ConversationStatus>;
+        timestamp: z.ZodNumber;
+        reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    }, z.core.$strip>>>>;
+    updated_at: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    deleted_at: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    is_test_conversation: z.ZodDefault<z.ZodBoolean>;
+    conversation_context: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        message: z.ZodOptional<z.ZodString>;
+        productId: z.ZodOptional<z.ZodString>;
+        menuItemId: z.ZodOptional<z.ZodString>;
+        serviceId: z.ZodOptional<z.ZodString>;
+        propertyId: z.ZodOptional<z.ZodString>;
+        resourceId: z.ZodOptional<z.ZodString>;
+        requiredServiceId: z.ZodOptional<z.ZodString>;
+        locationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Call transfer schema for tracking call transfer details in telephony conversations.
+ *
+ * Captures metadata about call transfers to human agents including transfer type, timing, destination,
+ * and outcome. Used for measuring transfer rates, analyzing escalation patterns, and tracking agent
+ * handoff performance in telephony deployments.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Used In**: ServiceConversationConfig.call_transfer field for telephony conversations
+ * - **Triggered By**: Agent detecting escalation keywords, user request, or configured transfer conditions
+ * - **References**: CallTransferConfig from agent configuration for transfer destinations
+ * - **Analytics**: Used for measuring AI containment rates and identifying improvement areas
+ *
+ * **Transfer Types:**
+ * - **blind**: Immediate unattended transfer without agent introduction (faster, no screening)
+ * - **warm**: Attended transfer where agent is briefed before caller is connected (professional, allows declining)
+ *
+ * **Transfer Lifecycle:**
+ * - **pending**: Transfer initiated, waiting for recipient to answer
+ * - **completed**: Transfer successful, caller connected to human agent
+ * - **failed**: Transfer failed due to busy line, no answer, or technical error
+ * - **returned**: Call returned to AI agent after human agent consultation
+ */
+export declare const CallTransferSchema: z.ZodObject<{
+    transfer_type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        blind: "blind";
+        warm: "warm";
+    }>>>;
+    transfer_target: z.ZodString;
+    transfer_initiated_at: z.ZodOptional<z.ZodNumber>;
+    transfer_completed_at: z.ZodOptional<z.ZodNumber>;
+    transfer_status: z.ZodEnum<{
+        pending: "pending";
+        completed: "completed";
+        failed: "failed";
+        returned: "returned";
+    }>;
+    transfer_reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Service conversation configuration schema.
+ *
+ * Complete conversation record extending base configuration with conversation-specific identifiers,
+ * provider metadata, call direction, recording URLs, and transfer details. This is the primary
+ * schema used for storing and retrieving conversation records in the system.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Extends**: BaseConversationConfigSchema with conversation-specific fields
+ * - **Storage**: Primary conversation entity in database with unique id
+ * - **Provider Integration**: Tracks external provider IDs for email services, telephony platforms
+ * - **Call Recordings**: resource_url links to call recording storage for compliance and quality assurance
+ *
+ * **Use Cases:**
+ * - Creating new conversations for inbound/outbound interactions
+ * - Retrieving conversation history with full message arrays
+ * - Analyzing call recordings and transfer patterns
+ * - Integrating with external email providers (Gmail, Outlook, etc.)
+ */
+export declare const ServiceConversationConfigSchema: z.ZodObject<{
+    channel_id: z.ZodString;
+    project_id: z.ZodString;
+    deployment_config_id: z.ZodString;
+    channel_identifier: z.ZodString;
+    instruction_config_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    partner_user_id: z.ZodOptional<z.ZodString>;
+    conversation_type: z.ZodEnum<typeof ServiceConversationType>;
+    model_id: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodNumber>;
+    created_at: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    messages: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.USER>>;
+        user_message_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        last_assistant_message_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.AGENT>>;
+        assistant_message_id: z.ZodString;
+        last_user_message_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        subject: z.ZodString;
+        isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.USER>>;
+        provider_message_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        subject: z.ZodString;
+        isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.AGENT>>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.HUMAN_AGENT>>;
+        agent_message_id: z.ZodString;
+        agent_session_id: z.ZodString;
+        last_user_message_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        subject: z.ZodString;
+        isEmail: z.ZodDefault<z.ZodLiteral<true>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.HUMAN_AGENT>>;
+        agent_session_id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        conversation_config_id: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodNumber>;
+        llm_conversation_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        message_type: z.ZodDefault<z.ZodLiteral<MessageType.SYSTEM>>;
+        system_message_id: z.ZodString;
+        event_type: z.ZodEnum<typeof import("./conversation-message.schema").SystemMessageEventType>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>]>>>>;
+    is_campaign: z.ZodDefault<z.ZodBoolean>;
+    customer_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    location_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof ConversationStatus>>>;
+    durationInSeconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    stt_model_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    tts_model_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    conversationSummary: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodString;
+        key_points: z.ZodArray<z.ZodString>;
+        action_items: z.ZodArray<z.ZodString>;
+        sentiment: z.ZodEnum<typeof ConversationSummarySentiment>;
+    }, z.core.$strip>>>;
+    created_day: z.ZodOptional<z.ZodString>;
+    state_history: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        status: z.ZodEnum<typeof ConversationStatus>;
+        timestamp: z.ZodNumber;
+        reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    }, z.core.$strip>>>>;
+    updated_at: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    deleted_at: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    is_test_conversation: z.ZodDefault<z.ZodBoolean>;
+    conversation_context: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        message: z.ZodOptional<z.ZodString>;
+        productId: z.ZodOptional<z.ZodString>;
+        menuItemId: z.ZodOptional<z.ZodString>;
+        serviceId: z.ZodOptional<z.ZodString>;
+        propertyId: z.ZodOptional<z.ZodString>;
+        resourceId: z.ZodOptional<z.ZodString>;
+        requiredServiceId: z.ZodOptional<z.ZodString>;
+        locationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    id: z.ZodString;
+    record_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    provider_message_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    direction: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof ConversationDirection>>>;
+    resource_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    call_transfer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        transfer_type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            blind: "blind";
+            warm: "warm";
+        }>>>;
+        transfer_target: z.ZodString;
+        transfer_initiated_at: z.ZodOptional<z.ZodNumber>;
+        transfer_completed_at: z.ZodOptional<z.ZodNumber>;
+        transfer_status: z.ZodEnum<{
+            pending: "pending";
+            completed: "completed";
+            failed: "failed";
+            returned: "returned";
+        }>;
+        transfer_reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Test configuration schema.
+ * Base configuration for testing AI agents.
+ */
+export declare const TestConfigSchema: z.ZodObject<{
+    account_id: z.ZodString;
+    project_id: z.ZodString;
+    agent_id: z.ZodString;
+    instruction_config_id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Evaluation schema for running AI agent evaluations.
+ */
+export declare const EvaluationSchema: z.ZodObject<{
+    instructionId: z.ZodString;
+    agentId: z.ZodString;
+    evaluationConfigId: z.ZodString;
+    speechConfig: z.ZodNullable<z.ZodOptional<z.ZodObject<{}, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * OTT conversation configuration schema.
+ * Configuration for OTT (over-the-top) chat widget connections.
+ */
+export declare const ConversationConfigSchema: z.ZodObject<{
+    platform_user_id: z.ZodOptional<z.ZodNumber>;
+    channel_identifier: z.ZodString;
+    partner_user_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * OTT conversation configuration with connection details.
+ */
+export declare const OttConversationConfigSchema: z.ZodObject<{
+    platform_user_id: z.ZodOptional<z.ZodNumber>;
+    channel_identifier: z.ZodString;
+    partner_user_id: z.ZodOptional<z.ZodString>;
+    sdrtn_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    channel_token: z.ZodString;
+    connection_url: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type ConversationSummary = z.infer<typeof ConversationSummarySchema>;
+export type ServiceConversationConfigType = z.infer<typeof ServiceConversationConfigSchema>;
+export type CallTransfer = z.infer<typeof CallTransferSchema>;
+export type ConversationStateHistory = z.infer<typeof ConversationStateHistorySchema>;
+/**
+ * Conversation filter options.
+ * @interface ConversationFilters
+ */
+export interface ConversationFilters {
+    /** Text search across conversation content */
+    search?: string;
+    /** Filter by conversation type(s) */
+    conversationType?: ServiceConversationType[];
+    /** Filter by channel ID */
+    channelId?: string;
+    /** Filter by location ID */
+    locationId?: string;
+    /** Filter by customer ID */
+    customerId?: string;
+    /** Filter by presence of messages */
+    hasMessages?: boolean;
+    /** Filter by date range */
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+}
+/**
+ * Conversation sorting options.
+ * @interface ConversationSorting
+ */
+export interface ConversationSorting {
+    /** Field to sort by */
+    field: 'created_at' | 'customer_id';
+    /** Sort direction */
+    direction: 'asc' | 'desc';
+}
+/**
+ * Conversation query options.
+ * @interface ConversationQueryOptions
+ */
+export interface ConversationQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: ConversationFilters;
+    /** Optional sorting */
+    sorting?: ConversationSorting;
+}