@actuate-media/cms-admin 0.35.0 → 0.36.0

package/src/views/settings/useAiSettings.ts

@@ -93,12 +93,32 @@ export interface AiUsageView {
   runCount: number
 }
 
+/** Editable brand voice fields (the buffered Save-bar portion). */
+export interface BrandVoiceForm {
+  enabled: boolean
+  name: string
+  tone: string
+  audience: string
+  guidelines: string
+  sampleText: string
+}
+
+const EMPTY_BRAND_VOICE: BrandVoiceForm = {
+  enabled: false,
+  name: '',
+  tone: '',
+  audience: '',
+  guidelines: '',
+  sampleText: '',
+}
+
 /** The buffered (Save-bar) portion of AI settings. */
 export interface AiSettingsForm {
   defaultProviderId: string
   defaultModelId: string
   features: AiFeatureView[]
   monthlyTokenLimit: string
+  brandVoice: BrandVoiceForm
 }
 
 interface AiSettingsResponse {
@@ -107,6 +127,14 @@ interface AiSettingsResponse {
     defaultModelId?: string
     features: AiFeatureView[]
     budget: { monthlyTokenLimit?: number }
+    brandVoice?: {
+      enabled?: boolean
+      name?: string
+      tone?: string
+      audience?: string
+      guidelines?: string
+      sampleText?: string
+    }
   }
   providers: AiProviderView[]
   defaultModel: AiModelView | null
@@ -127,6 +155,14 @@ function formFromResponse(res: AiSettingsResponse): AiSettingsForm {
       typeof res.settings.budget.monthlyTokenLimit === 'number'
         ? String(res.settings.budget.monthlyTokenLimit)
         : '',
+    brandVoice: {
+      enabled: res.settings.brandVoice?.enabled ?? false,
+      name: res.settings.brandVoice?.name ?? '',
+      tone: res.settings.brandVoice?.tone ?? '',
+      audience: res.settings.brandVoice?.audience ?? '',
+      guidelines: res.settings.brandVoice?.guidelines ?? '',
+      sampleText: res.settings.brandVoice?.sampleText ?? '',
+    },
   }
 }
 
@@ -135,6 +171,19 @@ const EMPTY_FORM: AiSettingsForm = {
   defaultModelId: '',
   features: [],
   monthlyTokenLimit: '',
+  brandVoice: { ...EMPTY_BRAND_VOICE },
+}
+
+/** A brand voice with no content and disabled clears the stored profile (send null). */
+function brandVoiceIsEmpty(bv: BrandVoiceForm): boolean {
+  return (
+    !bv.enabled &&
+    !bv.name.trim() &&
+    !bv.tone.trim() &&
+    !bv.audience.trim() &&
+    !bv.guidelines.trim() &&
+    !bv.sampleText.trim()
+  )
 }
 
 export interface ProviderInput {
@@ -162,6 +211,8 @@ export interface UseAiSettings {
   toggleFeature: (key: string, enabled: boolean) => void
   /** Set a per-feature model override. Empty string reverts to the default model. */
   setFeatureModel: (key: string, modelId: string) => void
+  /** Patch one or more brand voice fields. */
+  setBrandVoice: (patch: Partial<BrandVoiceForm>) => void
   dirty: boolean
   budgetError: string | null
   saveState: SaveState
@@ -273,6 +324,11 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
     setSaveState('idle')
   }, [])
 
+  const setBrandVoice = useCallback((patch: Partial<BrandVoiceForm>) => {
+    setForm((prev) => ({ ...prev, brandVoice: { ...prev.brandVoice, ...patch } }))
+    setSaveState('idle')
+  }, [])
+
   const budgetError = useMemo(() => {
     if (form.monthlyTokenLimit === '') return null
     const n = Number(form.monthlyTokenLimit)
@@ -285,6 +341,15 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
     if (form.defaultModelId !== baseline.defaultModelId) return true
     if (form.monthlyTokenLimit !== baseline.monthlyTokenLimit) return true
     if (form.features.length !== baseline.features.length) return true
+    const bvKeys: (keyof BrandVoiceForm)[] = [
+      'enabled',
+      'name',
+      'tone',
+      'audience',
+      'guidelines',
+      'sampleText',
+    ]
+    if (bvKeys.some((k) => form.brandVoice[k] !== baseline.brandVoice[k])) return true
     return form.features.some((f, i) => {
       const base = baseline.features[i]
       return f.enabled !== base?.enabled || (f.modelId ?? '') !== (base?.modelId ?? '')
@@ -310,6 +375,16 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
             monthlyTokenLimit:
               form.monthlyTokenLimit === '' ? null : Number(form.monthlyTokenLimit),
           },
+          brandVoice: brandVoiceIsEmpty(form.brandVoice)
+            ? null
+            : {
+                enabled: form.brandVoice.enabled,
+                name: form.brandVoice.name,
+                tone: form.brandVoice.tone,
+                audience: form.brandVoice.audience,
+                guidelines: form.brandVoice.guidelines,
+                sampleText: form.brandVoice.sampleText,
+              },
         }),
       })
       if (res.error) throw new Error(res.error)
@@ -459,6 +534,7 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
     setMonthlyTokenLimit,
     toggleFeature,
     setFeatureModel,
+    setBrandVoice,
     dirty,
     budgetError,
     saveState,