@tellescope/validation 1.256.0 → 1.256.2

package/src/validation.ts

@@ -350,13 +350,18 @@ import {
   MetriportSyncAutomationAction,
   AIDecisionAutomationAction,
   GenerateEnduserSummaryAutomationAction,
+  StartAIConversationAutomationAction,
+  StartAIConversationActionInfo,
   AssignInboxItemAutomationAction,
   CreateScriptSureDraftAutomationAction,
   BelugaAutoRxAutomationAction,
   BelugaAutoRxPatientPreferenceItem,
   BelugaUpdateVisitAutomationAction,
   BelugaUpdateVisitPatientPreferenceItem,
+  BelugaTriggerRefillAutomationAction,
+  BelugaTriggerRefillPatientPreferenceItem,
   OnAIDecisionAutomationEvent,
+  OnAIConversationOutcomeAutomationEvent,
   OnErrorEventInfo,
   OnErrorAutomationEvent,
   AIContextSource,
@@ -1453,13 +1458,19 @@ export const journeysValidator: ValidatorDefinition<Indexable> = {
 
 export const escape_phone_number = (p='') => p.replace(/[^\d+]/g, '')
 
+// SMS short codes are valid message endpoints but not E.164: no country code and no leading '+'.
+// escape_phone_number preserves '+', so '+1894546' fails this and falls through to the strict
+// path below — which is what keeps short codes stored in the bare form inbound matching expects.
+const SHORT_CODE_REGEX = /^\d{5,6}$/
+
 export const phoneValidator: ValidatorDefinition<string> = {
   validate: (options={}) => build_validator(
     phone => {
       if (typeof phone !== "string") throw new Error(`Expecting phone to be string but got ${phone}`)
 
-      let escaped = escape_phone_number(phone) 
+      let escaped = escape_phone_number(phone)
       if (escaped === '311') return escaped
+      if (SHORT_CODE_REGEX.test(escaped)) return escaped
       if (escaped.length < 10) throw new Error(`Phone number must be at least 10 digits`)
 
       escaped = escaped.startsWith('+') ? escaped
@@ -1487,8 +1498,9 @@ export const phoneValidatorOptional: ValidatorDefinition<string> = {
     phone => {
       if (typeof phone !== "string") throw new Error(`Expecting phone to be string but got ${phone}`)
 
-      let escaped = escape_phone_number(phone) 
+      let escaped = escape_phone_number(phone)
       if (escaped === '311') return escaped
+      if (SHORT_CODE_REGEX.test(escaped)) return escaped
       if (escaped.length < 10) throw new Error(`Phone number must be at least 10 digits`)
 
       escaped = escaped.startsWith('+') ? escaped
@@ -1505,7 +1517,7 @@ export const phoneValidatorOptional: ValidatorDefinition<string> = {
       }
 
       return escaped
-    }, 
+    },
     { ...options, maxLength: 25, listOf: false, isOptional: true, emptyStringOk: true }
   ),
   getExample: () => "+15555555555",
@@ -2647,6 +2659,7 @@ const _AUTOMATION_EVENTS: { [K in AutomationEventType]: any } = {
   waitForTrigger: '',
   onCallOutcome: '',
   onAIDecision: '',
+  onAIConversationOutcome: '',
   onError: '',
 }
 export const AUTOMATION_EVENTS = Object.keys(_AUTOMATION_EVENTS) as AutomationEventType[]
@@ -2681,6 +2694,7 @@ const _AUTOMATION_ACTIONS: { [K in AutomationActionType]: any } = {
   smartMeterPlaceOrder: '',
   belugaAutoRx: '',
   belugaUpdateVisit: '',
+  belugaTriggerRefill: '',
   healthieSync: '',
   healthieAddToCourse: '',
   healthieSendChat: '',
@@ -2713,6 +2727,7 @@ const _AUTOMATION_ACTIONS: { [K in AutomationActionType]: any } = {
   metriportSync: '',
   aiDecision: '',
   generateEnduserSummary: '',
+  startAIConversation: '',
   assignInboxItem: '',
   createScriptSureDraft: '',
 }
@@ -2921,6 +2936,13 @@ export const automationEventValidator = orValidator<{ [K in AutomationEventType]
       outcomes: listOfStringsValidator,
     }, { emptyOk: false }),
   }),
+  onAIConversationOutcome: objectValidator<OnAIConversationOutcomeAutomationEvent>({
+    type: exactMatchValidator(['onAIConversationOutcome']),
+    info: objectValidator<OnAIConversationOutcomeAutomationEvent['info']>({
+      automationStepId: mongoIdStringRequired,
+      outcome: stringValidator,
+    }, { emptyOk: false }),
+  }),
   onError: objectValidator<OnErrorAutomationEvent>({
     type: exactMatchValidator(['onError']),
     info: objectValidator<OnErrorEventInfo>({
@@ -3101,6 +3123,26 @@ export const AIMessageInputValidator = objectValidator<{ role: 'user' | 'assista
   text: stringValidator100000,
 }, { emptyOk: false })
 
+// capabilities granted to an AI agent (phone tree 'AI Agent' node or 'startAIConversation' journey
+// action) — extensible like phoneTreeActionValidator (one branch per tool type). Defined ABOVE
+// automationActionValidator, which references it (const TDZ — declaration order matters at module load).
+export const phoneTreeAgentToolValidator = orValidator<{ [K in PhoneTreeAgentToolType]: PhoneTreeAgentTools[K] }>({
+  "Submit Form": objectValidator<PhoneTreeAgentTools["Submit Form"]>({
+    type: exactMatchValidator(['Submit Form']),
+    info: objectValidator<PhoneTreeAgentTools["Submit Form"]['info']>({
+      formId: mongoIdStringRequired,
+      useWhen: stringValidator1000Optional,
+    }),
+  }),
+  "Book Appointment": objectValidator<PhoneTreeAgentTools["Book Appointment"]>({
+    type: exactMatchValidator(['Book Appointment']),
+    info: objectValidator<PhoneTreeAgentTools["Book Appointment"]['info']>({
+      appointmentBookingPageId: mongoIdStringRequired,
+      useWhen: stringValidator1000Optional,
+    }),
+  }),
+})
+
 export const automationActionValidator = orValidator<{ [K in AutomationActionType]: AutomationAction & { type: K } } | { [K in BrandedWebhookActions]: SendWebhookAutomationAction } >({
   developHealthMedEligibility: objectValidator<DevelopHealthMedicationEligibilityAutomationAction>({
     type: exactMatchValidator(['developHealthMedEligibility']),
@@ -3438,6 +3480,18 @@ export const automationActionValidator = orValidator<{ [K in AutomationActionTyp
       customFieldName: stringValidatorOptional,
     }),
   }),
+  belugaTriggerRefill: objectValidator<BelugaTriggerRefillAutomationAction>({
+    ...sharedAutomationActionValidators,
+    type: exactMatchValidator(['belugaTriggerRefill']),
+    info: objectValidator<BelugaTriggerRefillAutomationAction['info']>({
+      formId: mongoIdStringRequired,
+      patientPreferences: listValidatorOptionalOrEmptyOk(objectValidator<BelugaTriggerRefillPatientPreferenceItem>({
+        medId: stringValidatorOptional,
+      })),
+      useOrganizationMapping: booleanValidatorOptional,
+      customFieldName: stringValidatorOptional,
+    }),
+  }),
   sendChat: objectValidator<SendChatAutomationAction>({
     ...sharedAutomationActionValidators,
     type: exactMatchValidator(['sendChat']),
@@ -3661,6 +3715,27 @@ export const automationActionValidator = orValidator<{ [K in AutomationActionTyp
       aiSummaryConfiguration: aiSummaryConfigurationValidator, // optional shared config
     }, { emptyOk: true }) // config is optional; an empty info is valid
   }),
+  startAIConversation: objectValidator<StartAIConversationAutomationAction>({
+    ...sharedAutomationActionValidators,
+    type: exactMatchValidator(['startAIConversation']),
+    info: objectValidator<StartAIConversationActionInfo>({
+      channel: exactMatchValidator(['SMS']),
+      senderId: mongoIdStringRequired,
+      fromNumber: phoneValidatorOptional,
+      initialMessage: SMSMessageValidator, // required, ≤1200 chars (SMS cap)
+      prompt: stringValidator5000,
+      outcomes: listValidator(objectValidator({
+        value: stringValidator250,
+        description: stringValidator1000,
+      })),
+      tools: listValidatorOptionalOrEmptyOk(phoneTreeAgentToolValidator),
+      model: selectableAIModelValidator,
+      maxTokensPerTurn: numberValidatorOptional,
+      maxTurns: numberValidatorOptional,
+      maxCreditsPerCall: numberValidatorOptional,
+      inactivityTimeoutHours: numberValidatorOptional,
+    }, { emptyOk: false }),
+  }),
   assignInboxItem: objectValidator<AssignInboxItemAutomationAction>({
     ...sharedAutomationActionValidators,
     type: exactMatchValidator(['assignInboxItem']),
@@ -6718,24 +6793,6 @@ export const phonePlaybackValidatorOptional = orValidator<{
   optional: optionalEmptyObjectValidator, 
 }, { isOptional: true })
 
-// capabilities granted to an 'AI Agent' node — extensible like phoneTreeActionValidator (one branch per tool type)
-export const phoneTreeAgentToolValidator = orValidator<{ [K in PhoneTreeAgentToolType]: PhoneTreeAgentTools[K] }>({
-  "Submit Form": objectValidator<PhoneTreeAgentTools["Submit Form"]>({
-    type: exactMatchValidator(['Submit Form']),
-    info: objectValidator<PhoneTreeAgentTools["Submit Form"]['info']>({
-      formId: mongoIdStringRequired,
-      useWhen: stringValidator1000Optional,
-    }),
-  }),
-  "Book Appointment": objectValidator<PhoneTreeAgentTools["Book Appointment"]>({
-    type: exactMatchValidator(['Book Appointment']),
-    info: objectValidator<PhoneTreeAgentTools["Book Appointment"]['info']>({
-      appointmentBookingPageId: mongoIdStringRequired,
-      useWhen: stringValidator1000Optional,
-    }),
-  }),
-})
-
 export const phoneTreeActionValidator = orValidator<{ [K in PhoneTreeActionType]: PhoneTreeActions[K] }>({
   // "Play": objectValidator<PhoneTreeActions["Play"]>({
   //   type: exactMatchValidator(['Play']),