wiil-core-js 0.0.82

package/dist/core/service-configuration/deployment-config.schema.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentConfigurationDetailsSchema = exports.DeploymentConfigurationResultSchema = exports.UpdateDeploymentConfigurationSchema = exports.CreateChainDeploymentConfigurationSchema = exports.CreateDeploymentConfigurationSchema = exports.DeploymentConfigurationSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../base.schema");
+const agent_config_schema_1 = require("./agent-config.schema");
+const instruction_config_schema_1 = require("./instruction-config.schema");
+const interaction_channels_schema_1 = require("./interaction-channels.schema");
+const type_definitions_1 = require("../type-definitions");
+const project_schema_1 = require("../account/project.schema");
+/**
+ * @fileoverview Deployment configuration schema definitions.
+ *
+ * Deployment Configuration is the central composition entity in the Service Configuration architecture.
+ * It brings together agent behavior, instructions, organizational context, and channel configuration
+ * to create a complete deployable unit. Each deployment has exactly one channel (1:1 relationship).
+ *
+ * @module service-configuration/deployment-config
+ */
+/**
+ * Zod schema for deployment configuration validation.
+ *
+ * The Deployment Configuration is the central composition entity that brings together agent behavior,
+ * instructions, and organizational context to create a deployable unit. It serves as the primary
+ * entity that operators interact with when setting up new agent deployments.
+ *
+ * @remarks
+ * **Architecture Context:**
+ * - **Central Entity**: Primary composition point for all deployment components
+ * - **Managed By**: Service Configuration (administrative oversight)
+ * - **Uses**: Agent Configuration (N:1), Instruction Configuration (N:1)
+ * - **Associated With**: Project (N:1 for organizational grouping)
+ * - **Has**: Deployment Channel (1:1 - each deployment exposes through exactly one channel)
+ * - **Pattern**: Multi-channel deployments require separate Deployment Configurations per channel
+ *
+ * **Provisioning Types:**
+ * - **DIRECT**: Agent processes interactions directly without additional chains
+ * - **CHAINED**: Uses provisioning chain (STT → Agent → TTS) for voice processing
+ *
+ * **Deployment Lifecycle:**
+ * - **PENDING**: Created but not yet activated
+ * - **ACTIVE**: Operational and accepting interactions
+ * - **SUSPENDED**: Temporarily paused
+ * - **FAILED**: Deployment encountered errors
+ *
+ * @typedef {Object} DeploymentConfigurationProperties
+ * @property {string} id - Unique identifier for the deployment configuration
+ * @property {string} projectId - ID of the project this deployment belongs to for organizational grouping and access control
+ * @property {string} deploymentChannelId - ID of the deployment channel (1:1 relationship - phone, SMS, web, or mobile)
+ * @property {string} [deploymentName] - Optional human-readable name for administrative identification
+ * @property {string} agentConfigurationId - ID of the agent configuration defining core behavior and capabilities (N:1)
+ * @property {string} instructionConfigurationId - ID of the instruction configuration providing behavioral guidelines (N:1)
+ * @property {DeploymentStatus} deploymentStatus - Current operational status (PENDING, ACTIVE, SUSPENDED, FAILED)
+ * @property {DeploymentProvisioningType} provisioningType - How this deployment processes interactions (DIRECT or CHAINED) (default: DIRECT)
+ * @property {string | null} [provisioningConfigChainId] - ID of the provisioning chain for voice processing (required for CHAINED type)
+ * @property {boolean} isActive - Whether this deployment is currently active and accepting interactions (default: false)
+ * @property {DeploymentChannel | null} [channel] - Populated deployment channel configuration (for detail views)
+ * @property {Project | null} [project] - Populated project information (for detail views)
+ * @property {AgentConfiguration | null} [agent] - Populated agent configuration (for detail views)
+ * @property {InstructionConfiguration | null} [instruction] - Populated instruction configuration (for detail views)
+ * @property {number} [createdAt] - Unix timestamp (milliseconds) when created
+ * @property {number} [updatedAt] - Unix timestamp (milliseconds) when last updated
+ *
+ * @example
+ * ```typescript
+ * const deployment: DeploymentConfiguration = {
+ *   id: '123*',
+ *   projectId: '456*',
+ *   deploymentChannelId: 'abc*',
+ *   deploymentName: 'Production Customer Support',
+ *   agentConfigurationId: 'def*',
+ *   instructionConfigurationId: 'ghi*',
+ *   deploymentStatus: DeploymentStatus.ACTIVE,
+ *   provisioningType: DeploymentProvisioningType.DIRECT,
+ *   isActive: true,
+ *   createdAt: Date.now(),
+ *   updatedAt: Date.now()
+ * };
+ * ```
+ */
+exports.DeploymentConfigurationSchema = base_schema_1.BaseModelSchema.safeExtend({
+    projectId: zod_1.z.string().describe("ID of the project this deployment belongs to for organizational grouping, access control, and resource management"),
+    deploymentChannelId: zod_1.z.string().describe("ID of the deployment channel through which this deployment is accessible (1:1 relationship - each deployment has exactly one channel)"),
+    deploymentName: zod_1.z.string().optional().describe("Optional human-readable name for the deployment used in administrative interfaces and reporting"),
+    agentConfigurationId: zod_1.z.string().describe("ID of the agent configuration that defines the agent's core behavior, capabilities, and LLM model (N:1 relationship - multiple deployments can share an agent)"),
+    instructionConfigurationId: zod_1.z.string().describe("ID of the instruction configuration that provides behavioral guidelines, role definition, and conversation patterns for the agent (N:1 relationship)"),
+    deploymentStatus: zod_1.z.enum(type_definitions_1.DeploymentStatus).describe("Current operational status of the deployment (PENDING: awaiting activation, ACTIVE: operational, SUSPENDED: temporarily paused, FAILED: encountered errors)"),
+    provisioningType: zod_1.z.enum(type_definitions_1.DeploymentProvisioningType).default(type_definitions_1.DeploymentProvisioningType.DIRECT).describe("How this deployment processes interactions: DIRECT for direct agent processing, CHAINED for provisioning chain (STT → Agent → TTS) voice processing"),
+    provisioningConfigChainId: zod_1.z.string().optional().nullable().describe("ID of the provisioning configuration chain for voice processing (required for CHAINED provisioning type, links STT, agent, and TTS models)"),
+    isActive: zod_1.z.boolean().default(false).describe("Whether this deployment is currently active and accepting user interactions (independent of deploymentStatus for granular control)"),
+    channel: interaction_channels_schema_1.DeploymentChannelSchema.optional().nullable().describe("Populated deployment channel configuration including type, identifier, and channel-specific settings (null if not loaded, populated for detail views)"),
+    project: project_schema_1.ProjectSchema.optional().nullable().describe("Populated project information including name and organizational details (null if not loaded, populated for detail views)"),
+    agent: agent_config_schema_1.AgentConfigurationSchema.optional().nullable().describe("Populated agent configuration including model, operational mode, and capabilities (null if not loaded, populated for detail views)"),
+    instruction: instruction_config_schema_1.InstructionConfigurationSchema.optional().nullable().describe("Populated instruction configuration including role, guidelines, and knowledge sources (null if not loaded, populated for detail views)"),
+});
+/**
+ * Zod schema for creating a new deployment configuration.
+ *
+ * Omits auto-generated fields and populated relations. Sets deployment to PENDING status
+ * with DIRECT provisioning by default.
+ *
+ * @remarks
+ * This schema enforces required fields for deployment creation while excluding
+ * fields that are automatically generated or populated by the system.
+ *
+ * @example
+ * ```typescript
+ * const newDeployment: CreateDeploymentConfiguration = {
+ *   projectId: '456*',
+ *   deploymentChannelId: 'abc*',
+ *   deploymentName: 'Customer Support Line',
+ *   agentConfigurationId: 'def*',
+ *   instructionConfigurationId: 'ghi*',
+ *   isActive: false,
+ *   deploymentStatus: DeploymentStatus.PENDING,
+ *   provisioningType: DeploymentProvisioningType.DIRECT
+ * };
+ * ```
+ */
+exports.CreateDeploymentConfigurationSchema = exports.DeploymentConfigurationSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    channel: true,
+    project: true,
+    agent: true,
+    instruction: true,
+    deploymentStatus: true,
+    provisioningType: true,
+});
+/**
+ * Zod schema for creating a chained deployment configuration.
+ *
+ * Similar to CreateDeploymentConfigurationSchema but requires a provisioningConfigChainId
+ * and sets provisioningType to CHAINED by default.
+ *
+ * @remarks
+ * Use this schema when creating deployments that are part of a provisioning chain.
+ * The provisioningConfigChainId is required to link this deployment to the chain.
+ *
+ * @example
+ * ```typescript
+ * const chainedDeployment: CreateChainDeploymentConfiguration = {
+ *   projectId: '456*',
+ *   deploymentChannelId: 'abc*',
+ *   deploymentName: 'Multi-Step Support Flow',
+ *   agentConfigurationId: 'def*',
+ *   instructionConfigurationId: 'ghi*',
+ *   provisioningConfigChainId: 'xyz*',
+ *   isActive: false,
+ *   deploymentStatus: DeploymentStatus.PENDING,
+ *   provisioningType: DeploymentProvisioningType.CHAINED
+ * };
+ * ```
+ */
+exports.CreateChainDeploymentConfigurationSchema = exports.DeploymentConfigurationSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    channel: true,
+    project: true,
+    agent: true,
+    instruction: true,
+    deploymentStatus: true,
+    provisioningType: true,
+    provisioningConfigChainId: true,
+}).safeExtend({
+    provisioningConfigChainId: zod_1.z.string(),
+    deploymentStatus: zod_1.z.literal(type_definitions_1.DeploymentStatus.PENDING),
+    provisioningType: zod_1.z.enum(type_definitions_1.DeploymentProvisioningType).default(type_definitions_1.DeploymentProvisioningType.CHAINED),
+});
+/**
+ * Zod schema for updating an existing deployment configuration.
+ *
+ * All fields from CreateDeploymentConfigurationSchema are optional (partial),
+ * with the id field required to identify the deployment to update.
+ *
+ * @remarks
+ * Supports partial updates - only include the fields you want to modify.
+ * The id field is mandatory to specify which deployment configuration to update.
+ *
+ * @example
+ * ```typescript
+ * const updateDeployment: UpdateDeploymentConfiguration = {
+ *   id: '123*',
+ *   deploymentName: 'Updated Support Line',
+ *   isActive: true,
+ *   deploymentStatus: DeploymentStatus.ACTIVE
+ * };
+ * ```
+ */
+exports.UpdateDeploymentConfigurationSchema = exports.CreateDeploymentConfigurationSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+    provisioningConfigChainId: zod_1.z.string().optional(),
+});
+/**
+ * Zod schema for deployment configuration result (lightweight version).
+ *
+ * Omits populated relation fields (channel, project, agent, instruction) to provide
+ * a lighter payload suitable for list views and search results.
+ *
+ * @remarks
+ * Use this schema when returning deployment configurations in lists or search results
+ * where full relation details are not needed.
+ *
+ * @example
+ * ```typescript
+ * const deploymentResult: DeploymentConfigurationResult = {
+ *   id: '123*',
+ *   projectId: '456*',
+ *   deploymentChannelId: 'abc*',
+ *   deploymentName: 'Customer Support',
+ *   agentConfigurationId: 'def*',
+ *   instructionConfigurationId: 'ghi*',
+ *   deploymentStatus: DeploymentStatus.ACTIVE,
+ *   provisioningType: DeploymentProvisioningType.DIRECT,
+ *   isActive: true,
+ *   createdAt: Date.now(),
+ *   updatedAt: Date.now()
+ * };
+ * ```
+ */
+exports.DeploymentConfigurationResultSchema = exports.DeploymentConfigurationSchema.omit({
+    channel: true,
+    project: true,
+    agent: true,
+    instruction: true,
+});
+/**
+ * Zod schema for deployment configuration details (full version with all relations).
+ *
+ * Extends the base schema by requiring all relation fields to be fully populated
+ * with their complete schemas.
+ *
+ * @remarks
+ * Use this schema when returning a single deployment configuration with all
+ * associated details fully populated. Ideal for detail views where complete
+ * information about the deployment, channel, project, agent, and instruction is needed.
+ *
+ * @example
+ * ```typescript
+ * const deploymentDetails: DeploymentConfigurationDetails = {
+ *   id: '123*',
+ *   projectId: '456*',
+ *   deploymentChannelId: 'abc*',
+ *   deploymentName: 'Customer Support',
+ *   agentConfigurationId: 'def*',
+ *   instructionConfigurationId: 'ghi*',
+ *   deploymentStatus: DeploymentStatus.ACTIVE,
+ *   provisioningType: DeploymentProvisioningType.DIRECT,
+ *   isActive: true,
+ *   channel: { /* full DeploymentChannel object *\/ },
+ *   project: { /* full Project object *\/ },
+ *   agent: { /* full AgentConfiguration object *\/ },
+ *   instruction: { /* full InstructionConfiguration object *\/ },
+ *   createdAt: Date.now(),
+ *   updatedAt: Date.now()
+ * };
+ * ```
+ */
+exports.DeploymentConfigurationDetailsSchema = exports.DeploymentConfigurationSchema.omit({
+    channel: true,
+    project: true,
+    agent: true,
+    instruction: true,
+}).safeExtend({
+    channel: interaction_channels_schema_1.DeploymentChannelSchema,
+    project: project_schema_1.ProjectSchema,
+    agent: agent_config_schema_1.AgentConfigurationSchema,
+    instruction: instruction_config_schema_1.InstructionConfigurationSchema,
+});

package/dist/core/service-configuration/dynamic_setup/base-agent-setup.d.ts

@@ -0,0 +1,130 @@
+import z from "zod";
+import { AgentRoleTemplateIdentifier, SupportedProprietor } from "../../type-definitions";
+/**
+ * @fileoverview Dynamic agent setup base schemas for AI assistant configuration.
+ * @module service-configuration/dynamic_setup/base-agent-setup
+ *
+ * Provides foundational schemas for configuring AI assistants across different
+ * channels (phone, web). These base schemas are extended by channel-specific
+ * configurations in phone-agent-setup.ts and web-agent-setup.ts.
+ */
+/**
+ * Base agent setup schema.
+ *
+ * @typedef {Object} DynamicBaseAgentSetup
+ * @property {string} assistantName - Name of the AI assistant (max 30 characters)
+ * @property {string} [instructionConfigurationId] - ID of the instruction configuration
+ * @property {AgentRoleTemplateIdentifier} [role_template_identifier] - Role/persona for the agent
+ * @property {AgentCapabilities[]} [capabilities] - List of enabled platform services
+ * @property {string[]} [knowledgeSourceIds] - Knowledge source IDs to associate
+ * @property {string} [language] - Language ID (e.g., en, es, fr)
+ * @property {string} [voice] - Voice ID for voice interactions
+ * @property {SupportedProprietor} [providerType] - AI model provider type
+ * @property {string} [providerModelId] - Specific model ID from the provider
+ */
+export declare const DynamicBaseAgentSetupSchema: z.ZodObject<{
+    assistantName: z.ZodString;
+    instructionConfigurationId: z.ZodOptional<z.ZodString>;
+    role_template_identifier: z.ZodOptional<z.ZodEnum<typeof AgentRoleTemplateIdentifier>>;
+    capabilities: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../../type-definitions").BusinessSupportServices>>>>;
+    knowledgeSourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    language: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    voice: z.ZodOptional<z.ZodString>;
+    providerType: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof SupportedProprietor>>>;
+    providerModelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Model configuration schema.
+ *
+ * @typedef {Object} DynamicModelConfiguration
+ * @property {SupportedProprietor} providerType - AI model provider type
+ * @property {string} providerModelId - Specific model ID from the provider
+ */
+export declare const DynamicModelConfigurationSchema: z.ZodObject<{
+    providerType: z.ZodEnum<typeof SupportedProprietor>;
+    providerModelId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Speech-to-text model configuration schema.
+ *
+ * @typedef {Object} DynamicSTTModelConfiguration
+ * @property {SupportedProprietor} providerType - AI model provider type
+ * @property {string} providerModelId - Specific model ID from the provider
+ * @property {string} [languageId] - Language ID for speech recognition
+ */
+export declare const DynamicSTTModelConfigurationSchema: z.ZodObject<{
+    providerType: z.ZodEnum<typeof SupportedProprietor>;
+    providerModelId: z.ZodString;
+    languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Text-to-speech model configuration schema.
+ *
+ * @typedef {Object} DynamicTTSModelConfiguration
+ * @property {SupportedProprietor} providerType - AI model provider type
+ * @property {string} providerModelId - Specific model ID from the provider
+ * @property {string} [languageId] - Language ID for speech synthesis
+ * @property {string} [voiceId] - Voice ID for speech output
+ */
+export declare const DynamicTTSModelConfigurationSchema: z.ZodObject<{
+    providerType: z.ZodEnum<typeof SupportedProprietor>;
+    providerModelId: z.ZodString;
+    languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    voiceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Agent processing state schema for tracking long-running setup operations.
+ *
+ * @typedef {Object} DynamicAgentProcessingState
+ * @property {string} status - Current processing status (pending, in_progress, completed, failed)
+ * @property {number} progressPercentage - Progress percentage (0-100)
+ * @property {string} [message] - Additional details about current state
+ */
+export declare const DynamicAgentProcessingStateSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        pending: "pending";
+        completed: "completed";
+        failed: "failed";
+        in_progress: "in_progress";
+    }>;
+    progressPercentage: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Agent setup result schema.
+ * Extends BaseModelSchema to include id, createdAt, and updatedAt fields.
+ *
+ * @typedef {Object} DynamicAgentSetupResult
+ * @property {Object} processingState - Real-time processing state for async operations
+ * @property {boolean} [success] - Whether the setup was successful (nullable during processing)
+ * @property {string} [agentConfigurationId] - ID of the created agent configuration
+ * @property {string} [instructionConfigurationId] - ID of the created instruction configuration
+ * @property {string} [errorMessage] - Error message if setup failed
+ * @property {Object} [metadata] - Additional metadata about the setup
+ */
+export declare const DynamicAgentSetupResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    processingState: z.ZodObject<{
+        status: z.ZodEnum<{
+            pending: "pending";
+            completed: "completed";
+            failed: "failed";
+            in_progress: "in_progress";
+        }>;
+        progressPercentage: z.ZodNumber;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    success: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    agentConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    instructionConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+}, z.core.$strip>;
+export type DynamicBaseAgentSetup = z.infer<typeof DynamicBaseAgentSetupSchema>;
+export type DynamicModelConfiguration = z.infer<typeof DynamicModelConfigurationSchema>;
+export type DynamicSTTModelConfiguration = z.infer<typeof DynamicSTTModelConfigurationSchema>;
+export type DynamicTTSModelConfiguration = z.infer<typeof DynamicTTSModelConfigurationSchema>;
+export type DynamicAgentProcessingState = z.infer<typeof DynamicAgentProcessingStateSchema>;
+export type DynamicAgentSetupResult = z.infer<typeof DynamicAgentSetupResultSchema>;

package/dist/core/service-configuration/dynamic_setup/base-agent-setup.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamicAgentSetupResultSchema = exports.DynamicAgentProcessingStateSchema = exports.DynamicTTSModelConfigurationSchema = exports.DynamicSTTModelConfigurationSchema = exports.DynamicModelConfigurationSchema = exports.DynamicBaseAgentSetupSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const type_definitions_1 = require("../../type-definitions");
+const base_schema_1 = require("../../base.schema");
+/**
+ * @fileoverview Dynamic agent setup base schemas for AI assistant configuration.
+ * @module service-configuration/dynamic_setup/base-agent-setup
+ *
+ * Provides foundational schemas for configuring AI assistants across different
+ * channels (phone, web). These base schemas are extended by channel-specific
+ * configurations in phone-agent-setup.ts and web-agent-setup.ts.
+ */
+/**
+ * Base agent setup schema.
+ *
+ * @typedef {Object} DynamicBaseAgentSetup
+ * @property {string} assistantName - Name of the AI assistant (max 30 characters)
+ * @property {string} [instructionConfigurationId] - ID of the instruction configuration
+ * @property {AgentRoleTemplateIdentifier} [role_template_identifier] - Role/persona for the agent
+ * @property {AgentCapabilities[]} [capabilities] - List of enabled platform services
+ * @property {string[]} [knowledgeSourceIds] - Knowledge source IDs to associate
+ * @property {string} [language] - Language ID (e.g., en, es, fr)
+ * @property {string} [voice] - Voice ID for voice interactions
+ * @property {SupportedProprietor} [providerType] - AI model provider type
+ * @property {string} [providerModelId] - Specific model ID from the provider
+ */
+exports.DynamicBaseAgentSetupSchema = zod_1.default.object({
+    assistantName: zod_1.default.string().max(30).describe("Name of the AI assistant to use in conversations"),
+    instructionConfigurationId: zod_1.default.string().optional().describe("ID of the instruction configuration to use for this assistant"),
+    role_template_identifier: zod_1.default.enum(type_definitions_1.AgentRoleTemplateIdentifier).optional().describe("The role or persona that the agent adopts with this instruction set"),
+    capabilities: zod_1.default.array(zod_1.default.enum(type_definitions_1.AgentCapabilities)).optional().default([]).describe("List of platform services (tools) enabled for this agent configuration"),
+    knowledgeSourceIds: zod_1.default.array(zod_1.default.string()).optional().describe("List of knowledge source IDs to associate with this assistant"),
+    language: zod_1.default.string().optional().default("en").describe("Language ID for the assistant, e.g., en, es, fr, etc."),
+    voice: zod_1.default.string().optional().describe("Voice ID for the assistant, if applicable, used for voice interactions"),
+    providerType: zod_1.default.enum(type_definitions_1.SupportedProprietor).nullable().optional().describe("The AI model provider type for this agent configuration, e.g., OPENAI, AZURE, etc."),
+    providerModelId: zod_1.default.string().nullable().optional().describe("The specific model ID from the provider to use for this agent, e.g., gpt-4, gpt-3.5-turbo, etc."),
+}).describe("Base schema for setting up an AI assistant, used for both phone and web channels");
+/**
+ * Model configuration schema.
+ *
+ * @typedef {Object} DynamicModelConfiguration
+ * @property {SupportedProprietor} providerType - AI model provider type
+ * @property {string} providerModelId - Specific model ID from the provider
+ */
+exports.DynamicModelConfigurationSchema = zod_1.default.object({
+    providerType: zod_1.default.enum(type_definitions_1.SupportedProprietor).describe("The AI model provider type for this agent configuration, e.g., OPENAI, AZURE, etc."),
+    providerModelId: zod_1.default.string().describe("The specific model ID from the provider to use for this agent, e.g., gpt-4, gpt-3.5-turbo, etc."),
+}).describe("Base schema for model configuration");
+/**
+ * Speech-to-text model configuration schema.
+ *
+ * @typedef {Object} DynamicSTTModelConfiguration
+ * @property {SupportedProprietor} providerType - AI model provider type
+ * @property {string} providerModelId - Specific model ID from the provider
+ * @property {string} [languageId] - Language ID for speech recognition
+ */
+exports.DynamicSTTModelConfigurationSchema = exports.DynamicModelConfigurationSchema.extend({
+    languageId: zod_1.default.string().optional().default("en").describe("Language ID for the speech-to-text model, e.g., en, es, fr, etc."),
+}).describe("Schema for speech-to-text model configuration, extending the base model configuration with language support");
+/**
+ * Text-to-speech model configuration schema.
+ *
+ * @typedef {Object} DynamicTTSModelConfiguration
+ * @property {SupportedProprietor} providerType - AI model provider type
+ * @property {string} providerModelId - Specific model ID from the provider
+ * @property {string} [languageId] - Language ID for speech synthesis
+ * @property {string} [voiceId] - Voice ID for speech output
+ */
+exports.DynamicTTSModelConfigurationSchema = exports.DynamicModelConfigurationSchema.extend({
+    languageId: zod_1.default.string().optional().default("en").describe("Language ID for the text-to-speech model, e.g., en, es, fr, etc."),
+    voiceId: zod_1.default.string().optional().describe("Voice ID for the text-to-speech model, if applicable"),
+}).describe("Schema for text-to-speech model configuration, extending the base model configuration with language and voice support");
+/**
+ * Agent processing state schema for tracking long-running setup operations.
+ *
+ * @typedef {Object} DynamicAgentProcessingState
+ * @property {string} status - Current processing status (pending, in_progress, completed, failed)
+ * @property {number} progressPercentage - Progress percentage (0-100)
+ * @property {string} [message] - Additional details about current state
+ */
+exports.DynamicAgentProcessingStateSchema = zod_1.default.object({
+    status: zod_1.default.enum(["pending", "in_progress", "completed", "failed"]).describe("Current processing status of the agent setup"),
+    progressPercentage: zod_1.default.number().min(0).max(100).describe("Progress percentage of the agent setup process"),
+    message: zod_1.default.string().optional().describe("Optional message providing additional details about the current processing state"),
+}).describe("Schema for representing the processing state of a dynamic agent setup, useful for tracking long-running setup operations");
+/**
+ * Agent setup result schema.
+ * Extends BaseModelSchema to include id, createdAt, and updatedAt fields.
+ *
+ * @typedef {Object} DynamicAgentSetupResult
+ * @property {Object} processingState - Real-time processing state for async operations
+ * @property {boolean} [success] - Whether the setup was successful (nullable during processing)
+ * @property {string} [agentConfigurationId] - ID of the created agent configuration
+ * @property {string} [instructionConfigurationId] - ID of the created instruction configuration
+ * @property {string} [errorMessage] - Error message if setup failed
+ * @property {Object} [metadata] - Additional metadata about the setup
+ */
+exports.DynamicAgentSetupResultSchema = base_schema_1.BaseModelSchema.safeExtend({
+    processingState: exports.DynamicAgentProcessingStateSchema.describe("Optional field to provide real-time processing state of the agent setup, useful for asynchronous operations"),
+    success: zod_1.default.boolean().nullable().optional().describe("Indicates if the assistant setup was successful"),
+    agentConfigurationId: zod_1.default.string().nullable().optional().describe("ID of the agent configuration created for this assistant"),
+    instructionConfigurationId: zod_1.default.string().nullable().optional().describe("ID of the instruction configuration created for this assistant"),
+    errorMessage: zod_1.default.string().optional().describe("Error message if the setup failed, otherwise undefined"),
+    metadata: zod_1.default.record(zod_1.default.string(), zod_1.default.any()).nullable().optional().describe("Additional metadata about the assistant setup, if any"),
+}).describe("Schema for the result of creating or setting up a new AI assistant with dynamic setup");

package/dist/core/service-configuration/dynamic_setup/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Central export point for dynamic agent setup schemas.
+ * @module service-configuration/dynamic_setup
+ *
+ * Provides schemas for dynamically configuring AI assistants across different
+ * communication channels (phone, web). Includes base configuration schemas
+ * and channel-specific extensions for voice and text interactions.
+ */
+export * from './phone-agent-setup';
+export * from './web-agent-setup';

package/dist/core/service-configuration/dynamic_setup/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * @fileoverview Central export point for dynamic agent setup schemas.
+ * @module service-configuration/dynamic_setup
+ *
+ * Provides schemas for dynamically configuring AI assistants across different
+ * communication channels (phone, web). Includes base configuration schemas
+ * and channel-specific extensions for voice and text interactions.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./phone-agent-setup"), exports);
+__exportStar(require("./web-agent-setup"), exports);

package/dist/core/service-configuration/dynamic_setup/phone-agent-setup.d.ts

@@ -0,0 +1,111 @@
+import z from "zod";
+/**
+ * @fileoverview Phone agent setup schemas for AI assistant configuration.
+ * @module service-configuration/dynamic_setup/phone-agent-setup
+ *
+ * Provides schemas for configuring AI assistants deployed on phone/telephony channels.
+ * Extends the base agent setup with phone-specific settings like phone configuration,
+ * test numbers, and required voice interaction configurations (STT/TTS).
+ */
+/**
+ * Phone agent setup schema.
+ *
+ * @typedef {Object} DynamicPhoneAgentSetup
+ * @property {string} [phoneConfigurationId] - ID of the phone configuration
+ * @property {string} [testPhoneNumber] - Phone number for testing
+ * @property {Object} [sttConfiguration] - Speech-to-text configuration (required for voice)
+ * @property {Object} [ttsConfiguration] - Text-to-speech configuration (required for voice)
+ */
+export declare const DynamicPhoneAgentSchema: z.ZodObject<{
+    assistantName: z.ZodString;
+    instructionConfigurationId: z.ZodOptional<z.ZodString>;
+    role_template_identifier: z.ZodOptional<z.ZodEnum<typeof import("../..").AgentRoleTemplateIdentifier>>;
+    capabilities: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../..").BusinessSupportServices>>>>;
+    knowledgeSourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    textKnowledgeSource: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+    language: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    voice: z.ZodOptional<z.ZodString>;
+    providerType: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../..").SupportedProprietor>>>;
+    providerModelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phoneConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    testPhoneNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sttConfiguration: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("../..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>>;
+    ttsConfiguration: z.ZodOptional<z.ZodNullable<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>;
+/**
+ * Phone agent setup result schema.
+ *
+ * @typedef {Object} DynamicPhoneAgentSetupResult
+ * @property {boolean} success - Whether the setup was successful
+ * @property {string} agentConfigurationId - ID of the created agent configuration
+ * @property {string} instructionConfigurationId - ID of the created instruction configuration
+ * @property {string} phoneNumber - Phone number associated with the configuration
+ */
+export declare const DynamicPhoneAgentSetupResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    processingState: z.ZodObject<{
+        status: z.ZodEnum<{
+            pending: "pending";
+            completed: "completed";
+            failed: "failed";
+            in_progress: "in_progress";
+        }>;
+        progressPercentage: z.ZodNumber;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    success: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    agentConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    instructionConfigurationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    phoneNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing phone agent configuration.
+ * All fields are optional except id.
+ */
+export declare const UpdateDynamicPhoneAgentSchema: z.ZodObject<{
+    id: z.ZodString;
+    voice: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    language: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodString>>>;
+    instructionConfigurationId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    assistantName: z.ZodOptional<z.ZodString>;
+    role_template_identifier: z.ZodOptional<z.ZodOptional<z.ZodEnum<typeof import("../..").AgentRoleTemplateIdentifier>>>;
+    capabilities: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../..").BusinessSupportServices>>>>>;
+    knowledgeSourceIds: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    textKnowledgeSource: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+    providerType: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../..").SupportedProprietor>>>>;
+    providerModelId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    testPhoneNumber: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    sttConfiguration: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        providerType: z.ZodEnum<typeof import("../..").SupportedProprietor>;
+        providerModelId: z.ZodString;
+        languageId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>>>;
+    ttsConfiguration: z.ZodOptional<z.ZodOptional<z.ZodNullable<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>;
+export type DynamicPhoneAgentSetup = z.infer<typeof DynamicPhoneAgentSchema>;
+export type UpdateDynamicPhoneAgent = z.infer<typeof UpdateDynamicPhoneAgentSchema>;
+export type DynamicPhoneAgentSetupResult = z.infer<typeof DynamicPhoneAgentSetupResultSchema>;