wiil-core-js 0.0.82

package/dist/core/conversation/outbound-call.schema.d.ts

@@ -0,0 +1,209 @@
+import { z } from "zod";
+import { CallRequestStatus, ScheduleType } from "../type-definitions";
+/**
+ * @fileoverview Outbound call request schema definitions.
+ * @module conversation/outbound-call
+ *
+ * Outbound call requests represent scheduled or immediate AI-powered voice calls
+ * to customers. Supports scheduling, retry logic, calling hours compliance, and
+ * integration with agent configurations for AI behavior.
+ */
+/**
+ * Calling hours configuration for outbound calls.
+ *
+ * This schema represents the **Time Window** configuration:
+ *
+ * ```
+ * Call Request
+ *      │
+ *      ▼ restricted by
+ * Calling Hours ← THIS SCHEMA
+ *      │
+ *      ▼ queued until
+ * Next Available Window
+ * ```
+ *
+ * Ensures compliance with TCPA regulations and respects customer preferences.
+ *
+ * @see BusinessCallRequestSchema - Uses this for time-restricted campaigns
+ */
+export declare const CallingHoursSchema: z.ZodObject<{
+    startTime: z.ZodString;
+    endTime: z.ZodString;
+    daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export type CallingHours = z.infer<typeof CallingHoursSchema>;
+/**
+ * Business call request schema.
+ *
+ * @typedef {Object} BusinessCallRequest
+ * @property {string} [phoneConfigurationId] - Phone configuration for caller ID
+ * @property {string} to - Destination phone number in E.164 format
+ * @property {string} from - Caller ID phone number in E.164 format
+ * @property {string} agentConfigurationId - Agent configuration for AI behavior
+ * @property {string} [instructionConfigurationId] - Instruction override for call
+ * @property {number} [maxDuration] - Maximum call duration in seconds
+ * @property {string} scheduleType - Call timing strategy
+ * @property {string} [serviceConversationConfigId] - Linked conversation record
+ * @property {string} [timeZone] - IANA timezone identifier
+ * @property {number} [scheduledAt] - Unix timestamp for scheduled execution
+ * @property {Object} [callingHours] - Permitted calling window configuration
+ * @property {number} [maxRetries] - Maximum retry attempts (0-5)
+ * @property {number} [retryDelayMinutes] - Delay between retries in minutes
+ * @property {string} status - Current call request status
+ * @property {Object} [metadata] - Additional custom metadata
+ */
+export declare const BusinessCallRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    phoneConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    to: z.ZodString;
+    from: z.ZodString;
+    agentConfigurationId: z.ZodString;
+    instructionConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxDuration: z.ZodOptional<z.ZodNumber>;
+    scheduleType: z.ZodEnum<typeof ScheduleType>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    timeZone: z.ZodOptional<z.ZodString>;
+    scheduledAt: z.ZodOptional<z.ZodNumber>;
+    callingHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        startTime: z.ZodString;
+        endTime: z.ZodString;
+        daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryDelayMinutes: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodDefault<z.ZodEnum<typeof CallRequestStatus>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new call request.
+ * Omits auto-generated fields.
+ */
+export declare const CreateCallRequestSchema: z.ZodObject<{
+    status: z.ZodDefault<z.ZodEnum<typeof CallRequestStatus>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    instructionConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentConfigurationId: z.ZodString;
+    phoneConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    from: z.ZodString;
+    to: z.ZodString;
+    maxDuration: z.ZodOptional<z.ZodNumber>;
+    scheduleType: z.ZodEnum<typeof ScheduleType>;
+    timeZone: z.ZodOptional<z.ZodString>;
+    scheduledAt: z.ZodOptional<z.ZodNumber>;
+    callingHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        startTime: z.ZodString;
+        endTime: z.ZodString;
+        daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryDelayMinutes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing call request.
+ * All fields optional except id (required).
+ */
+export declare const UpdateCallRequestSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof CallRequestStatus>>>;
+    metadata: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    instructionConfigurationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    agentConfigurationId: z.ZodOptional<z.ZodString>;
+    phoneConfigurationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    maxDuration: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    scheduleType: z.ZodOptional<z.ZodEnum<typeof ScheduleType>>;
+    timeZone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    scheduledAt: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    callingHours: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        startTime: z.ZodString;
+        endTime: z.ZodString;
+        daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>>>;
+    maxRetries: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    retryDelayMinutes: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Call request result schema.
+ * Response payload from telephony provider after initiating a call.
+ */
+export declare const CallRequestResultSchema: z.ZodObject<{
+    success: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    request: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodOptional<z.ZodNumber>;
+        updatedAt: z.ZodOptional<z.ZodNumber>;
+        phoneConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        to: z.ZodString;
+        from: z.ZodString;
+        agentConfigurationId: z.ZodString;
+        instructionConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        maxDuration: z.ZodOptional<z.ZodNumber>;
+        scheduleType: z.ZodEnum<typeof ScheduleType>;
+        serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        scheduledAt: z.ZodOptional<z.ZodNumber>;
+        callingHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            startTime: z.ZodString;
+            endTime: z.ZodString;
+            daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryDelayMinutes: z.ZodOptional<z.ZodNumber>;
+        status: z.ZodDefault<z.ZodEnum<typeof CallRequestStatus>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>>>;
+    error_message: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type BusinessCallRequest = z.infer<typeof BusinessCallRequestSchema>;
+export type CreateCallRequest = z.infer<typeof CreateCallRequestSchema>;
+export type UpdateCallRequest = z.infer<typeof UpdateCallRequestSchema>;
+export type CallRequestResult = z.infer<typeof CallRequestResultSchema>;
+/**
+ * Call request filter options.
+ * @interface CallRequestFilters
+ */
+export interface CallRequestFilters {
+    /** Text search across phone numbers */
+    search?: string;
+    /** Filter by call status */
+    status?: CallRequestStatus;
+    /** Filter by schedule type */
+    scheduleType?: ScheduleType;
+    /** Filter by agent configuration ID */
+    agentConfigurationId?: string;
+    /** Filter by date range (scheduledAt) */
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+}
+/**
+ * Call request sorting options.
+ * @interface CallRequestSorting
+ */
+export interface CallRequestSorting {
+    /** Field to sort by */
+    field: "scheduledAt" | "status" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Call request query options.
+ * @interface CallRequestQueryOptions
+ */
+export interface CallRequestQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: CallRequestFilters;
+    /** Optional sorting */
+    sorting?: CallRequestSorting;
+}

package/dist/core/conversation/outbound-call.schema.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallRequestResultSchema = exports.UpdateCallRequestSchema = exports.CreateCallRequestSchema = exports.BusinessCallRequestSchema = exports.CallingHoursSchema = void 0;
+const zod_1 = require("zod");
+const type_definitions_1 = require("../type-definitions");
+const base_schema_1 = require("../base.schema");
+/**
+ * @fileoverview Outbound call request schema definitions.
+ * @module conversation/outbound-call
+ *
+ * Outbound call requests represent scheduled or immediate AI-powered voice calls
+ * to customers. Supports scheduling, retry logic, calling hours compliance, and
+ * integration with agent configurations for AI behavior.
+ */
+// ============================================================================
+// CALLING HOURS SCHEMA
+// ============================================================================
+/**
+ * Calling hours configuration for outbound calls.
+ *
+ * This schema represents the **Time Window** configuration:
+ *
+ * ```
+ * Call Request
+ *      │
+ *      ▼ restricted by
+ * Calling Hours ← THIS SCHEMA
+ *      │
+ *      ▼ queued until
+ * Next Available Window
+ * ```
+ *
+ * Ensures compliance with TCPA regulations and respects customer preferences.
+ *
+ * @see BusinessCallRequestSchema - Uses this for time-restricted campaigns
+ */
+exports.CallingHoursSchema = zod_1.z.object({
+    startTime: zod_1.z.string().regex(/^([01]?[0-9]|2[0-3]):[0-5][0-9]$/).describe("Start time for permitted calling window in HH:MM 24-hour format (e.g., '09:00' for 9 AM). Calls before this time are queued until the window opens."),
+    endTime: zod_1.z.string().regex(/^([01]?[0-9]|2[0-3]):[0-5][0-9]$/).describe("End time for permitted calling window in HH:MM 24-hour format (e.g., '17:00' for 5 PM). Calls after this time are queued until the next available window."),
+    daysOfWeek: zod_1.z.array(zod_1.z.number().int().min(0).max(6)).default([1, 2, 3, 4, 5]).describe("Array of permitted days of week for calling (0=Sunday through 6=Saturday). Defaults to weekdays [1,2,3,4,5]. Use [0,1,2,3,4,5,6] for all days."),
+});
+// ============================================================================
+// BUSINESS CALL REQUEST SCHEMA
+// ============================================================================
+/**
+ * Business call request schema.
+ *
+ * @typedef {Object} BusinessCallRequest
+ * @property {string} [phoneConfigurationId] - Phone configuration for caller ID
+ * @property {string} to - Destination phone number in E.164 format
+ * @property {string} from - Caller ID phone number in E.164 format
+ * @property {string} agentConfigurationId - Agent configuration for AI behavior
+ * @property {string} [instructionConfigurationId] - Instruction override for call
+ * @property {number} [maxDuration] - Maximum call duration in seconds
+ * @property {string} scheduleType - Call timing strategy
+ * @property {string} [serviceConversationConfigId] - Linked conversation record
+ * @property {string} [timeZone] - IANA timezone identifier
+ * @property {number} [scheduledAt] - Unix timestamp for scheduled execution
+ * @property {Object} [callingHours] - Permitted calling window configuration
+ * @property {number} [maxRetries] - Maximum retry attempts (0-5)
+ * @property {number} [retryDelayMinutes] - Delay between retries in minutes
+ * @property {string} status - Current call request status
+ * @property {Object} [metadata] - Additional custom metadata
+ */
+exports.BusinessCallRequestSchema = base_schema_1.BaseModelSchema.safeExtend({
+    phoneConfigurationId: zod_1.z.string().nullable().optional().describe("Phone configuration ID for caller ID display and telephony routing settings (references PhoneConfiguration). When omitted, uses organization default."),
+    to: zod_1.z.string().min(1, "Destination phone number is required").describe("Destination phone number in E.164 international format (e.g., '+12125551234'). Must be a valid, dialable phone number for outbound calling."),
+    from: zod_1.z.string().min(1, "Caller ID is required").describe("Caller ID phone number in E.164 format displayed to the recipient. Must be a verified number owned by the organization in PhoneConfiguration."),
+    agentConfigurationId: zod_1.z.string().min(1, "Agent configuration is required").describe("Agent configuration ID defining AI behavior, persona, and capabilities for this call (references AgentConfiguration). Determines how the AI handles the conversation."),
+    instructionConfigurationId: zod_1.z.string().nullable().optional().describe("Optional instruction configuration ID to override agent defaults with call-specific behavioral guidelines and prompts (references InstructionConfiguration)."),
+    maxDuration: zod_1.z.number().int().positive().optional().describe("Maximum call duration in seconds to prevent runaway calls. Call automatically terminates with graceful goodbye when limit is reached."),
+    scheduleType: zod_1.z.enum(type_definitions_1.ScheduleType).describe("Call timing strategy: 'immediate' executes ASAP within calling hours, 'scheduled' executes at scheduledAt timestamp, 'recurring' executes on callingHours schedule."),
+    serviceConversationConfigId: zod_1.z.string().nullable().optional().describe("Linked conversation record ID for tracking call outcomes, messages, and analytics (references ServiceConversationConfig). Created automatically when call connects."),
+    // Time constraints
+    timeZone: zod_1.z.string().optional().describe("IANA timezone identifier for interpreting scheduledAt and callingHours (e.g., 'America/New_York', 'Europe/London'). Defaults to UTC if not specified."),
+    scheduledAt: zod_1.z.number().optional().describe("Unix timestamp in milliseconds for scheduled call execution. Required when scheduleType is 'scheduled'. Call executes at this time if within callingHours."),
+    callingHours: exports.CallingHoursSchema.nullable().optional().describe("Permitted calling window configuration restricting when calls can be placed. Ensures TCPA compliance and respects customer preferences. Calls outside window are queued."),
+    // Retry configuration
+    maxRetries: zod_1.z.number().int().min(0).max(5).optional().describe("Maximum number of retry attempts if call fails due to no answer, busy signal, or technical error (0-5). Set to 0 to disable retries."),
+    retryDelayMinutes: zod_1.z.number().int().positive().optional().describe("Delay in minutes between retry attempts. Provides spacing to increase likelihood of reaching the recipient on subsequent attempts."),
+    // Status tracking
+    status: zod_1.z.enum(type_definitions_1.CallRequestStatus).default(type_definitions_1.CallRequestStatus.PENDING).describe("Current status of the call request lifecycle (pending, scheduled, in_progress, completed, failed, cancelled)."),
+    // Extensibility
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Additional custom metadata as key-value pairs for campaign tracking, CRM integration, or application-specific data. Not processed by the platform."),
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new call request.
+ * Omits auto-generated fields.
+ */
+exports.CreateCallRequestSchema = exports.BusinessCallRequestSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing call request.
+ * All fields optional except id (required).
+ */
+exports.UpdateCallRequestSchema = exports.CreateCallRequestSchema.partial().safeExtend({
+    id: zod_1.z.string().describe("Unique identifier of the CallRequest to update"),
+});
+// ============================================================================
+// CALL REQUEST RESULT SCHEMA
+// ============================================================================
+/**
+ * Call request result schema.
+ * Response payload from telephony provider after initiating a call.
+ */
+exports.CallRequestResultSchema = zod_1.z.object({
+    success: zod_1.z.boolean().optional().default(false).describe("Whether the telephony request was successful"),
+    request: exports.BusinessCallRequestSchema.optional().nullable().describe("Original call request details"),
+    error_message: zod_1.z.string().optional().nullable().describe("Error message if the request failed"),
+});

package/dist/core/conversation/outbound-email.schema.d.ts

@@ -0,0 +1,338 @@
+import { z } from "zod";
+import { EmailStatus } from "../type-definitions";
+/**
+ * @fileoverview Outbound email request and delivery tracking schema definitions.
+ * @module conversation/outbound-email
+ *
+ * Email requests represent outbound email communications sent through the platform.
+ * Supports scheduling, templates, attachments, and delivery tracking with retry logic.
+ */
+/**
+ * Email recipient schema (embedded in EmailRequestSchema).
+ *
+ * @see EmailRequestSchema - Uses this for recipient arrays
+ */
+export declare const EmailRecipientSchema: z.ZodObject<{
+    email: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EmailRecipient = z.infer<typeof EmailRecipientSchema>;
+/**
+ * Email attachment schema (embedded in EmailRequestSchema).
+ *
+ * @see EmailRequestSchema - Uses this for file attachments
+ */
+export declare const EmailAttachmentSchema: z.ZodObject<{
+    filename: z.ZodString;
+    content: z.ZodString;
+    contentType: z.ZodString;
+}, z.core.$strip>;
+export type EmailAttachment = z.infer<typeof EmailAttachmentSchema>;
+/**
+ * Email request schema.
+ *
+ * @typedef {Object} EmailRequest
+ * @property {string} [emailConfigurationId] - Email configuration for sender settings. May be provided or system falls back to default platform email
+ * @property {string} [configuredEmailAddress] - Configured sender email address. May be provided or system falls back to default platform email
+ * @property {string} [templateId] - Pre-defined template ID for structured content
+ * @property {Array} to - Primary recipients (required, at least one)
+ * @property {Array} [cc] - Carbon copy recipients
+ * @property {Array} [bcc] - Blind carbon copy recipients
+ * @property {string} [replyTo] - Reply-to email address
+ * @property {string} subject - Email subject line
+ * @property {string} bodyHtml - HTML content of the email body
+ * @property {string} [bodyText] - Plain text alternative content
+ * @property {Object} [variables] - Template variable substitutions
+ * @property {Array} [attachments] - File attachments
+ * @property {number} [scheduledAt] - Unix timestamp for scheduled delivery
+ * @property {string} [serviceConversationConfigId] - Linked conversation record
+ * @property {Object} [metadata] - Additional custom metadata
+ */
+export declare const EmailRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    emailConfigurationId: z.ZodOptional<z.ZodString>;
+    configuredEmailAddress: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodString>;
+    to: z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    cc: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    bcc: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    replyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    subject: z.ZodString;
+    bodyHtml: z.ZodString;
+    bodyText: z.ZodOptional<z.ZodString>;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    attachments: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        filename: z.ZodString;
+        content: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strip>>>>;
+    scheduledAt: z.ZodOptional<z.ZodNumber>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<typeof EmailStatus>>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryCount: z.ZodDefault<z.ZodNumber>;
+    retryDelayMinutes: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new email request.
+ * Omits auto-generated fields.
+ */
+export declare const CreateEmailRequestSchema: z.ZodObject<{
+    status: z.ZodDefault<z.ZodEnum<typeof EmailStatus>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    to: z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    subject: z.ZodString;
+    scheduledAt: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryDelayMinutes: z.ZodOptional<z.ZodNumber>;
+    emailConfigurationId: z.ZodOptional<z.ZodString>;
+    configuredEmailAddress: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodString>;
+    cc: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    bcc: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    replyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bodyHtml: z.ZodString;
+    bodyText: z.ZodOptional<z.ZodString>;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    attachments: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        filename: z.ZodString;
+        content: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strip>>>>;
+    retryCount: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing email request.
+ * All fields optional except id (required).
+ */
+export declare const UpdateEmailRequestSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof EmailStatus>>>;
+    metadata: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    to: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    subject: z.ZodOptional<z.ZodString>;
+    scheduledAt: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    maxRetries: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    retryDelayMinutes: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    emailConfigurationId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    configuredEmailAddress: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    templateId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    cc: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>>;
+    bcc: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>>;
+    replyTo: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    bodyHtml: z.ZodOptional<z.ZodString>;
+    bodyText: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    variables: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    attachments: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        filename: z.ZodString;
+        content: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strip>>>>>;
+    retryCount: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Email record schema for tracking delivery status.
+ *
+ * Records individual delivery events and status updates from email providers.
+ * Links to the original EmailRequest and tracks provider-specific message IDs.
+ *
+ * @typedef {Object} EmailRecord
+ * @property {string} emailRequestId - Reference to the original email request
+ * @property {string} providerMessageId - Provider-specific message ID
+ * @property {EmailStatus} status - Current delivery status
+ * @property {number} [sentAt] - Timestamp when email was sent
+ * @property {number} [deliveredAt] - Timestamp when email was delivered
+ * @property {number} [bouncedAt] - Timestamp when email bounced
+ * @property {string} [errorCode] - Provider error code if failed
+ * @property {string} [errorMessage] - Provider error message if failed
+ * @property {Object} [metadata] - Additional provider metadata
+ */
+export declare const EmailRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    emailRequestId: z.ZodString;
+    providerMessageId: z.ZodString;
+    status: z.ZodEnum<typeof EmailStatus>;
+    sentAt: z.ZodOptional<z.ZodNumber>;
+    deliveredAt: z.ZodOptional<z.ZodNumber>;
+    bouncedAt: z.ZodOptional<z.ZodNumber>;
+    errorCode: z.ZodOptional<z.ZodString>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Email request result schema.
+ * Response payload after submitting an email request.
+ */
+export declare const EmailRequestResultSchema: z.ZodObject<{
+    success: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    request: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodOptional<z.ZodNumber>;
+        updatedAt: z.ZodOptional<z.ZodNumber>;
+        emailConfigurationId: z.ZodOptional<z.ZodString>;
+        configuredEmailAddress: z.ZodOptional<z.ZodString>;
+        templateId: z.ZodOptional<z.ZodString>;
+        to: z.ZodArray<z.ZodObject<{
+            email: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        cc: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            email: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        bcc: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            email: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        replyTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        subject: z.ZodString;
+        bodyHtml: z.ZodString;
+        bodyText: z.ZodOptional<z.ZodString>;
+        variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        attachments: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            content: z.ZodString;
+            contentType: z.ZodString;
+        }, z.core.$strip>>>>;
+        scheduledAt: z.ZodOptional<z.ZodNumber>;
+        serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodDefault<z.ZodEnum<typeof EmailStatus>>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryCount: z.ZodDefault<z.ZodNumber>;
+        retryDelayMinutes: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>>>;
+    error_message: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type EmailRequest = z.infer<typeof EmailRequestSchema>;
+export type CreateEmailRequest = z.infer<typeof CreateEmailRequestSchema>;
+export type UpdateEmailRequest = z.infer<typeof UpdateEmailRequestSchema>;
+export type EmailRecord = z.infer<typeof EmailRecordSchema>;
+export type EmailRequestResult = z.infer<typeof EmailRequestResultSchema>;
+/**
+ * Email request filter options.
+ * @interface EmailRequestFilters
+ */
+export interface EmailRequestFilters {
+    /** Text search across subject */
+    search?: string;
+    /** Filter by email configuration ID */
+    emailConfigurationId?: string;
+    /** Filter by configured email address */
+    configuredEmailAddress?: string;
+    /** Filter by template ID */
+    templateId?: string;
+    /** Filter by delivery status */
+    status?: EmailStatus;
+    /** Filter by linked conversation ID */
+    serviceConversationConfigId?: string;
+    /** Filter by scheduled date range */
+    scheduledAtRange?: {
+        from?: number;
+        to?: number;
+    };
+}
+/**
+ * Email request sorting options.
+ * @interface EmailRequestSorting
+ */
+export interface EmailRequestSorting {
+    /** Field to sort by */
+    field: "createdAt" | "scheduledAt" | "status" | "subject" | "retryCount";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Email request query options.
+ * @interface EmailRequestQueryOptions
+ */
+export interface EmailRequestQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: EmailRequestFilters;
+    /** Optional sorting */
+    sorting?: EmailRequestSorting;
+}
+/**
+ * Email record filter options.
+ * @interface EmailRecordFilters
+ */
+export interface EmailRecordFilters {
+    /** Filter by email request ID */
+    emailRequestId?: string;
+    /** Filter by provider message ID */
+    providerMessageId?: string;
+    /** Filter by delivery status */
+    status?: EmailStatus;
+    /** Filter by sent date range */
+    sentAtRange?: {
+        from?: number;
+        to?: number;
+    };
+    /** Filter by delivered date range */
+    deliveredAtRange?: {
+        from?: number;
+        to?: number;
+    };
+}
+/**
+ * Email record sorting options.
+ * @interface EmailRecordSorting
+ */
+export interface EmailRecordSorting {
+    /** Field to sort by */
+    field: "createdAt" | "status" | "sentAt" | "deliveredAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Email record query options.
+ * @interface EmailRecordQueryOptions
+ */
+export interface EmailRecordQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: EmailRecordFilters;
+    /** Optional sorting */
+    sorting?: EmailRecordSorting;
+}