wiil-core-js 0.0.82

package/dist/core/service-configuration/phone-number.schema.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhoneNumberPricingSchema = exports.PhoneNumberPurchaseRequestSchema = exports.BusinessPhoneNumberPurchaseRequestSchema = exports.CreatePhoneNumberPurchaseSchema = exports.PhoneNumberPurchaseSchema = exports.PhoneProviderResponseSchema = exports.BasePhoneNumberInfoSchema = void 0;
+const zod_1 = require("zod");
+const service_config_definitions_1 = require("../type-definitions/service-config.definitions");
+const base_schema_1 = require("../base.schema");
+/**
+ * @fileoverview Phone number configuration and purchase schema definitions.
+ *
+ * Phone number schemas manage the complete lifecycle of phone number acquisition from telephony providers:
+ * discovery of available inventory, purchase transactions, and provisioning into Phone Configurations.
+ * Supports multiple providers (SignalWire, Twilio) with provider-specific extensions.
+ *
+ * @module service-configuration/phone-number
+ */
+/**
+ * Zod schema for base phone number information.
+ *
+ * Common properties shared across all phone number providers.
+ *
+ * @typedef {Object} BasePhoneNumberInfoProperties
+ * @property {string} friendlyName - Human-readable name for the phone number
+ * @property {string} phoneNumber - The phone number in E.164 format
+ * @property {string | null} [lata] - Local Access and Transport Area code
+ * @property {string} [rateCenter] - Rate center for the phone number
+ * @property {string} [region] - Geographic region
+ * @property {string} [postalCode] - Postal/ZIP code for the phone number
+ * @property {string} countryCode - ISO country code
+ * @property {Object} capabilities - Phone number capabilities
+ * @property {boolean} capabilities.voice - Supports voice calls
+ * @property {boolean} capabilities.SMS - Supports SMS messaging
+ * @property {boolean} capabilities.MMS - Supports MMS messaging
+ * @property {boolean} beta - Whether this is a beta number
+ * @property {PhoneNumberType} numberType - Type of phone number (local, toll-free, etc.)
+ *
+ * @example
+ * ```typescript
+ * const phoneInfo: BasePhoneNumberInfo = {
+ *   friendlyName: 'Customer Support Line',
+ *   phoneNumber: '+12125551234',
+ *   countryCode: 'US',
+ *   capabilities: { voice: true, SMS: true, MMS: false },
+ *   beta: false,
+ *   numberType: PhoneNumberType.LOCAL
+ * };
+ * ```
+ */
+exports.BasePhoneNumberInfoSchema = zod_1.z.object({
+    friendlyName: zod_1.z.string().describe("Human-readable display name for this phone number (e.g., 'New York Local', 'Customer Support Line')"),
+    phoneNumber: zod_1.z.string().describe("Phone number in E.164 international format (e.g., '+12125551234')"),
+    lata: zod_1.z.string().nullable().optional().describe("Local Access and Transport Area (LATA) code for North American numbers (telecom routing identifier)"),
+    rateCenter: zod_1.z.string().optional().describe("Rate center name for billing and routing purposes (North American telephony concept)"),
+    region: zod_1.z.string().optional().describe("State or province code where the number is registered (e.g., 'NY', 'CA', 'ON')"),
+    postalCode: zod_1.z.string().optional().describe("Postal or ZIP code associated with this phone number's geographic location"),
+    countryCode: zod_1.z.string().describe("ISO 3166-1 alpha-2 country code for this phone number (e.g., 'US', 'GB', 'CA')"),
+    capabilities: zod_1.z.object({
+        voice: zod_1.z.boolean().describe("Whether this phone number supports voice calls (inbound/outbound telephony)"),
+        SMS: zod_1.z.boolean().describe("Whether this phone number supports SMS text messaging"),
+        MMS: zod_1.z.boolean().describe("Whether this phone number supports MMS multimedia messaging"),
+    }).describe("Capabilities supported by this phone number for voice and messaging"),
+    beta: zod_1.z.boolean().describe("Whether this is a beta phone number (experimental or limited availability)"),
+    numberType: zod_1.z.enum(service_config_definitions_1.PhoneNumberType).describe("Type of phone number (LOCAL for geographic, TOLL_FREE for 1-800 numbers, MOBILE for cellular, etc.)"),
+});
+/**
+ * Zod schema for phone provider response.
+ *
+ * Response from phone number provider API calls.
+ *
+ * @example
+ * ```typescript
+ * const response: PhoneProviderResponse = {
+ *   success: true,
+ *   status: 200,
+ *   data: { availableNumbers: [...] }
+ * };
+ * ```
+ */
+exports.PhoneProviderResponseSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    status: zod_1.z.number().optional(),
+    data: zod_1.z.unknown(),
+});
+/**
+ * Zod schema for phone number purchase transaction.
+ *
+ * Represents a phone number purchase request and its lifecycle through the purchase process.
+ *
+ * @typedef {Object} PhoneNumberPurchaseProperties
+ * @property {string} id - Unique identifier for the purchase transaction
+ * @property {string} friendlyName - Human-readable name for the purchased number
+ * @property {string} phoneNumber - The phone number being purchased
+ * @property {ProviderType} providerType - Provider from which the number is being purchased
+ * @property {string} countryCode - ISO country code for the phone number (e.g., 'US', 'GB', 'CA')
+ * @property {number} amount - Purchase amount (must be positive)
+ * @property {string} currency - Currency code (3 characters, default: "USD")
+ * @property {PhonePurchaseStatus} status - Current status of the purchase (default: PENDING)
+ * @property {PhoneNumberType} numberType - Type of phone number (default: LOCAL)
+ * @property {string | null} [statusDetails] - Additional details about the current status
+ * @property {number | null} [completedAt] - Timestamp when purchase was completed
+ * @property {Record<string, any> | null} [metadata] - Additional metadata for the purchase
+ * @property {number} [createdAt] - Timestamp when created
+ * @property {number} [updatedAt] - Timestamp when last updated
+ *
+ * @example
+ * ```typescript
+ * const purchase: PhoneNumberPurchase = {
+ *   id: '32422DEGER56',
+ *   friendlyName: 'Main Support Line',
+ *   phoneNumber: '+12125551234',
+ *   countryCode: 'US',
+ *   chargedCredits: 1500,
+ *   status: PhonePurchaseStatus.COMPLETED,
+ *   numberType: PhoneNumberType.LOCAL,
+ *   completedAt: Date.now(),
+ *   createdAt: Date.now(),
+ *   updatedAt: Date.now()
+ * };
+ * ```
+ */
+exports.PhoneNumberPurchaseSchema = base_schema_1.BaseModelSchema.safeExtend({
+    friendlyName: zod_1.z.string().describe("Human-readable name for the phone number being purchased (e.g., 'Customer Support Line', 'Sales Main Number')"),
+    phoneNumber: base_schema_1.PhoneNumberSchema.describe("Phone number in E.164 international format being purchased (e.g., '+12125551234')"),
+    countryCode: zod_1.z.string().length(2).describe("ISO 3166-1 alpha-2 country code for the phone number (e.g., 'US', 'GB', 'CA')"),
+    chargedCredits: zod_1.z.number().positive().describe("Amount charged for the phone number purchase (must be a positive number)"),
+    status: zod_1.z.enum(service_config_definitions_1.PhonePurchaseStatus).default(service_config_definitions_1.PhonePurchaseStatus.PENDING).describe("Current status of the purchase transaction (PENDING, PROCESSING, COMPLETED, FAILED, CANCELLED)"),
+    numberType: zod_1.z.enum(service_config_definitions_1.PhoneNumberType).default(service_config_definitions_1.PhoneNumberType.LOCAL).describe("Type of phone number being purchased (LOCAL for geographic, TOLL_FREE for 1-800, MOBILE for cellular)"),
+    statusDetails: zod_1.z.string().nullable().optional().describe("Additional details about the current status (error messages, provider notes, or completion details)"),
+    completedAt: zod_1.z.number().nullable().optional().describe("Unix timestamp (milliseconds) when the purchase was successfully completed and number became active"),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).nullable().optional().describe("Additional metadata for the purchase including provider-specific details, billing information, or custom attributes"),
+});
+/**
+ * Zod schema for creating a new phone number purchase.
+ *
+ * Omits auto-generated and transaction-specific fields.
+ *
+ * @remarks
+ * Use this schema when initiating a new phone number purchase.
+ *
+ * @example
+ * ```typescript
+ * const newPurchase: CreatePhoneNumberPurchase = {
+ *   friendlyName: 'New Support Line',
+ *   phoneNumber: '+12125551234',
+ *   countryCode: 'US',
+ *   providerType: ProviderType.TWILIO,
+ *   phoneNumberInfo: { ... },
+ *   numberType: PhoneNumberType.LOCAL
+ * };
+ * ```
+ */
+exports.CreatePhoneNumberPurchaseSchema = exports.PhoneNumberPurchaseSchema.omit({
+    id: true,
+    amount: true,
+    chargedCredits: true,
+    status: true,
+    createdAt: true,
+    updatedAt: true,
+    statusDetails: true,
+    completedAt: true,
+    metadata: true,
+});
+exports.BusinessPhoneNumberPurchaseRequestSchema = zod_1.z.object({
+    phoneNumber: base_schema_1.PhoneNumberSchema.describe("Phone number in international format to be purchased"),
+    friendlyName: zod_1.z.string().optional().describe("Human-readable display name for the phone number being purchased"),
+}).describe("Schema for business phone number purchase request, containing necessary information to initiate a phone number purchase for a business account");
+/**
+ * Legacy schema export for backwards compatibility.
+ * @deprecated Use CreatePhoneNumberPurchaseSchema instead.
+ */
+exports.PhoneNumberPurchaseRequestSchema = exports.CreatePhoneNumberPurchaseSchema;
+/**
+ * Zod schema for phone number pricing information.
+ *
+ * Represents pricing details for phone numbers from various providers.
+ *
+ * @typedef {Object} PhoneNumberPricingProperties
+ * @property {PhoneNumberType} number_type - Type of phone number
+ * @property {string} country - Full country name
+ * @property {string} countryCode - ISO country code
+ * @property {Array} phoneNumberPrices - Array of pricing tiers
+ * @property {number} price - Final price for the number
+ * @property {string} priceUnit - Unit of pricing (e.g., "per month")
+ * @property {string} currency - Currency code (3 characters, default: "USD")
+ *
+ * @example
+ * ```typescript
+ * const pricing: PhoneNumberPricing = {
+ *   number_type: PhoneNumberType.LOCAL,
+ *   country: 'United States',
+ *   countryCode: 'US',
+ *   phoneNumberPrices: [
+ *     { base_price: '1.00', current_price: '1.00' }
+ *   ],
+ *   price: 1.00,
+ *   priceUnit: 'per month',
+ *   currency: 'USD'
+ * };
+ * ```
+ */
+exports.PhoneNumberPricingSchema = zod_1.z.object({
+    number_type: zod_1.z.enum(service_config_definitions_1.PhoneNumberType),
+    country: zod_1.z.string(),
+    countryCode: zod_1.z.string(),
+    phoneNumberPrices: zod_1.z.array(zod_1.z.object({
+        base_price: zod_1.z.string(),
+        current_price: zod_1.z.string(),
+    })),
+    price: zod_1.z.number(),
+    priceUnit: zod_1.z.string(),
+    currency: zod_1.z.string().length(3).default('USD'),
+});

package/dist/core/service-configuration/provisioning-config.d.ts

@@ -0,0 +1,429 @@
+import z from "zod";
+/**
+ * @fileoverview Provisioning configuration chain schema definitions.
+ *
+ * Provisioning chains orchestrate the complete voice interaction pipeline by linking Speech-to-Text (STT),
+ * Agent Configuration, and Text-to-Speech (TTS) models. Used for voice-based deployments with CHAINED
+ * provisioning type.
+ *
+ * @module service-configuration/provisioning-config
+ */
+/**
+ * Zod schema for Speech-to-Text (STT) model configuration.
+ *
+ * Defines the STT model used to convert user speech to text in voice-based interactions.
+ * Part of the provisioning chain's input processing stage.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Used In**: ProvisioningConfigChain (sttConfig field)
+ * - **Purpose**: Converts incoming voice to text for agent processing
+ * - **Pipeline Position**: First stage (Speech → Text)
+ *
+ * @typedef {Object} SttModelConfigProperties
+ * @property {string} modelId - Identifier of the STT model from Wiil registry (e.g., 'whisper-v3', 'google-stt-enhanced')
+ * @property {string} defaultLanguage - Default language code for speech recognition in ISO format (default: "en-US")
+ *
+ * @example
+ * ```typescript
+ * const sttConfig: SttModelConfig = {
+ *   modelId: 'whisper-v3',
+ *   defaultLanguage: 'en-US'
+ * };
+ * ```
+ */
+export declare const SttModelConfigSchema: z.ZodObject<{
+    modelId: z.ZodString;
+    defaultLanguage: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Type definition for STT model configuration.
+ */
+export type SttModelConfig = z.infer<typeof SttModelConfigSchema>;
+/**
+ * Zod schema for Text-to-Speech (TTS) model configuration.
+ *
+ * Defines the TTS model and voice used to convert agent text responses to speech in voice interactions.
+ * Part of the provisioning chain's output generation stage.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Used In**: ProvisioningConfigChain (ttsConfig field)
+ * - **Purpose**: Converts agent text responses to natural speech
+ * - **Pipeline Position**: Final stage (Text → Speech)
+ * - **Voice Selection**: References voices from WiilSupportModel.supportedVoices
+ *
+ * @typedef {Object} TtsModelConfigProperties
+ * @property {string} modelId - Identifier of the TTS model from Wiil registry (e.g., 'eleven-labs-v2', 'google-tts-wavenet')
+ * @property {string} voiceId - Identifier of the specific voice for speech synthesis (e.g., 'adam', 'rachel', 'en-us-neural-female')
+ * @property {string} defaultLanguage - Default language code for speech synthesis (default: "en-US")
+ * @property {Record<string, any>} [voiceSettings] - Optional voice-specific settings (pitch, speed, stability, etc.)
+ *
+ * @example
+ * ```typescript
+ * const ttsConfig: TtsModelConfig = {
+ *   modelId: 'eleven-labs-v2',
+ *   voiceId: 'adam',
+ *   defaultLanguage: 'en-US',
+ *   voiceSettings: { stability: 0.75, similarity_boost: 0.5 }
+ * };
+ * ```
+ */
+export declare const TtsModelConfigSchema: z.ZodObject<{
+    modelId: z.ZodString;
+    voiceId: z.ZodString;
+    defaultLanguage: z.ZodDefault<z.ZodString>;
+    voiceSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Type definition for TTS model configuration.
+ */
+export type TtsModelConfig = z.infer<typeof TtsModelConfigSchema>;
+/**
+ * Zod schema for provisioning configuration chain.
+ *
+ * Represents a complete voice interaction processing pipeline that chains Speech-to-Text (STT),
+ * Agent Configuration, and Text-to-Speech (TTS) for end-to-end voice conversations. Referenced
+ * by Deployment Configurations with CHAINED provisioning type.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Used By**: Deployment Configuration (provisioningConfigChainId for CHAINED type)
+ * - **Purpose**: Orchestrates complete voice interaction pipeline
+ * - **Pipeline Flow**: User Speech → STT → Text → Agent → Text Response → TTS → Agent Speech
+ * - **Organization**: Scoped to organization for multi-tenant isolation
+ *
+ * **Voice Processing Pipeline:**
+ * 1. **STT Stage**: Converts incoming user speech to text using sttConfig
+ * 2. **Agent Stage**: Processes text through agent (referenced by agentConfigurationId)
+ * 3. **TTS Stage**: Converts agent text response to speech using ttsConfig
+ *
+ * @typedef {Object} ProvisioningConfigChainProperties
+ * @property {string} id - Unique identifier for the provisioning chain
+ * @property {string} chainName - Human-readable name for the provisioning chain for administrative identification
+ * @property {string} [description] - Optional description of the chain's purpose, use case, and configuration details
+ * @property {SttModelConfig} sttConfig - Speech-to-text model configuration for converting user voice to text (pipeline stage 1)
+ * @property {string} agentConfigurationId - ID of the agent configuration to use for processing text interactions (pipeline stage 2)
+ * @property {TtsModelConfig} ttsConfig - Text-to-speech model configuration for converting agent responses to voice (pipeline stage 3)
+ * @property {number} [createdAt] - Unix timestamp (milliseconds) when created
+ * @property {number} [updatedAt] - Unix timestamp (milliseconds) when last updated
+ *
+ * @example
+ * ```typescript
+ * const provisioningChain: ProvisioningConfigChain = {
+ *   id: 'chain-123',
+ *   chainName: 'Customer Support Voice Chain',
+ *   description: 'Voice processing chain for customer support calls',
+ *   sttConfig: {
+ *     modelId: 'whisper-v3',
+ *     defaultLanguage: 'en-US'
+ *   },
+ *   agentConfigurationId: 'agent-789',
+ *   ttsConfig: {
+ *     modelId: 'eleven-labs-v2',
+ *     voiceId: 'adam',
+ *     defaultLanguage: 'en-US'
+ *   },
+ *   createdAt: Date.now(),
+ *   updatedAt: Date.now()
+ * };
+ * ```
+ */
+export declare const ProvisioningConfigChainSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    chainName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sttConfig: z.ZodObject<{
+        modelId: z.ZodString;
+        defaultLanguage: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    agentConfigurationId: z.ZodString;
+    ttsConfig: z.ZodObject<{
+        modelId: z.ZodString;
+        voiceId: z.ZodString;
+        defaultLanguage: z.ZodDefault<z.ZodString>;
+        voiceSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Type definition for provisioning configuration chain.
+ */
+export type ProvisioningConfigChain = z.infer<typeof ProvisioningConfigChainSchema>;
+/**
+ * Zod schema for creating a new provisioning configuration chain.
+ *
+ * Omits auto-generated fields that are populated by the system.
+ *
+ * @remarks
+ * Use this schema when creating new provisioning chains.
+ *
+ * @example
+ * ```typescript
+ * const newChain: CreateProvisioningConfig = {
+ *   chainName: 'New Voice Chain',
+ *   description: 'Processing chain for multilingual support',
+ *   sttConfig: {
+ *     providerType: 'Deepgram',
+ *     providerModelId: 'nova-2',
+ *     languageId: 'en'
+ *   },
+ *   processingConfig: {
+ *     providerType: 'OpenAI',
+ *     providerModelId: 'gpt-4o-mini'
+ *   },
+ *   ttsConfig: {
+ *     providerType: 'ElevenLabs',
+ *     providerModelId: 'eleven_multilingual_v2',
+ *     languageId: 'en',
+ *     voiceId: 'rachel'
+ *   }
+ * };
+ * ```
+ */
+export declare const CreateProvisioningConfigSchema: z.ZodObject<{
+    chainName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sttConfig: z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>;
+    processingConfig: z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+    }, z.core.$strip>;
+    ttsConfig: z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        voiceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Type definition for creating a provisioning configuration chain.
+ */
+export type CreateProvisioningConfig = z.infer<typeof CreateProvisioningConfigSchema>;
+/**
+ * Zod schema for updating an existing provisioning configuration chain.
+ *
+ * All fields are optional (partial) except id, which is required to identify the chain.
+ *
+ * @remarks
+ * Supports partial updates - only include the fields you want to modify.
+ *
+ * @example
+ * ```typescript
+ * const updateChain: UpdateProvisioningConfig = {
+ *   id: 'chain-123',
+ *   chainName: 'Updated Voice Chain',
+ *   description: 'Updated description'
+ * };
+ * ```
+ */
+export declare const UpdateProvisioningConfigSchema: z.ZodObject<{
+    chainName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    sttConfig: z.ZodOptional<z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
+    processingConfig: z.ZodOptional<z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+    }, z.core.$strip>>;
+    ttsConfig: z.ZodOptional<z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        voiceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Type definition for updating a provisioning configuration chain.
+ */
+export type UpdateProvisioningConfig = z.infer<typeof UpdateProvisioningConfigSchema>;
+/**
+ * Zod schema for translation chain configuration.
+ *
+ * Extends the provisioning chain concept with translation-specific processing capabilities.
+ * Enables real-time language translation in voice interactions (e.g., English caller to Spanish agent).
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Extension Of**: ProvisioningConfigChain with translation capabilities
+ * - **Purpose**: Real-time language translation for multilingual support
+ * - **Pipeline Flow**: Speech (Lang A) → STT → Text (Lang A) → Translation → Text (Lang B) → TTS → Speech (Lang B)
+ * - **Use Case**: Cross-language customer support, international business
+ *
+ * **Translation Pipeline:**
+ * 1. **STT Stage**: Converts incoming speech to text in source language
+ * 2. **Translation Stage**: Translates text between languages using processingModelId
+ * 3. **TTS Stage**: Converts translated text to speech in target language
+ *
+ * @typedef {Object} TranslationChainConfigProperties
+ * @property {string} id - Unique identifier for the translation chain
+ * @property {string} chainName - Human-readable name for the translation chain (e.g., 'EN-ES Translation', 'Multilingual Support')
+ * @property {string} [description] - Optional description of language pair, use case, and configuration
+ * @property {SttModelConfig} sttConfig - Speech-to-text configuration for source language recognition
+ * @property {string} processingModelId - ID of the LLM model used for translation processing between languages
+ * @property {TtsModelConfig} ttsConfig - Text-to-speech configuration for target language synthesis
+ * @property {boolean} isTranslation - Flag indicating this chain performs translation (default: true)
+ * @property {number} [createdAt] - Unix timestamp (milliseconds) when created
+ * @property {number} [updatedAt] - Unix timestamp (milliseconds) when last updated
+ *
+ * @example
+ * ```typescript
+ * const translationChain: TranslationChainConfig = {
+ *   id: 'chain-123',
+ *   chainName: 'EN-ES Translation Chain',
+ *   description: 'English to Spanish translation for customer support',
+ *   sttConfig: {
+ *     modelId: 'whisper-v3',
+ *     defaultLanguage: 'en-US'
+ *   },
+ *   processingModelId: 'gpt-4-translator',
+ *   ttsConfig: {
+ *     modelId: 'eleven-labs-v2',
+ *     voiceId: 'spanish-voice',
+ *     defaultLanguage: 'es-ES'
+ *   },
+ *   isTranslation: true,
+ *   createdAt: Date.now(),
+ *   updatedAt: Date.now()
+ * };
+ * ```
+ */
+export declare const TranslationChainConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    chainName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sttConfig: z.ZodObject<{
+        modelId: z.ZodString;
+        defaultLanguage: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    processingModelId: z.ZodString;
+    ttsConfig: z.ZodObject<{
+        modelId: z.ZodString;
+        voiceId: z.ZodString;
+        defaultLanguage: z.ZodDefault<z.ZodString>;
+        voiceSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>;
+    isTranslation: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Type definition for translation chain configuration.
+ */
+export type TranslationChainConfig = z.infer<typeof TranslationChainConfigSchema>;
+/**
+ * Zod schema for creating a new translation chain configuration.
+ *
+ * Omits auto-generated fields and sets isTranslation to true by default.
+ *
+ * @example
+ * ```typescript
+ * const newTranslationChain: CreateTranslationChainConfig = {
+ *   chainName: 'FR-EN Translation',
+ *   description: 'French to English translation chain',
+ *   sttConfig: {
+ *     providerType: 'Deepgram',
+ *     providerModelId: 'nova-2',
+ *     languageId: 'fr'
+ *   },
+ *   processingConfig: {
+ *     providerType: 'OpenAI',
+ *     providerModelId: 'gpt-4o-mini'
+ *   },
+ *   ttsConfig: {
+ *     providerType: 'ElevenLabs',
+ *     providerModelId: 'eleven_multilingual_v2',
+ *     languageId: 'en',
+ *     voiceId: 'english-voice'
+ *   },
+ *   isTranslation: true
+ * };
+ * ```
+ */
+export declare const CreateTranslationChainConfigSchema: z.ZodObject<{
+    chainName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sttConfig: z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>;
+    processingConfig: z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+    }, z.core.$strip>;
+    ttsConfig: z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        voiceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    isTranslation: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Type definition for creating a translation chain configuration.
+ */
+export type CreateTranslationChainConfig = z.infer<typeof CreateTranslationChainConfigSchema>;
+/**
+ * Zod schema for updating an existing translation chain configuration.
+ *
+ * All fields are optional (partial) except id.
+ *
+ * @example
+ * ```typescript
+ * const updateTranslationChain: UpdateTranslationChainConfig = {
+ *   id: 'chain-123',
+ *   chainName: 'Updated Translation Chain',
+ *   processingConfig: {
+ *     providerType: 'OpenAI',
+ *     providerModelId: 'gpt-4.1-mini'
+ *   }
+ * };
+ * ```
+ */
+export declare const UpdateTranslationChainConfigSchema: z.ZodObject<{
+    chainName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    sttConfig: z.ZodOptional<z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
+    processingConfig: z.ZodOptional<z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+    }, z.core.$strip>>;
+    ttsConfig: z.ZodOptional<z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        voiceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    isTranslation: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Type definition for updating a translation chain configuration.
+ */
+export type UpdateTranslationChainConfig = z.infer<typeof UpdateTranslationChainConfigSchema>;
+/**
+ * Union type for any chain configuration (provisioning or translation).
+ */
+export type ChainConfiguration = ProvisioningConfigChain | TranslationChainConfig;
+/**
+ * Union type for creating any chain configuration.
+ */
+export type CreateChainConfiguration = CreateProvisioningConfig | CreateTranslationChainConfig;
+/**
+ * Union type for updating any chain configuration.
+ */
+export type UpdateChainConfiguration = UpdateProvisioningConfig | UpdateTranslationChainConfig;