@actuate-media/cms-admin 0.56.0 → 0.57.0

package/src/views/settings/useAiSettings.ts

@@ -1,6 +1,12 @@
 'use client'
 
 import { useCallback, useEffect, useMemo, useState } from 'react'
+import {
+  defaultStructuredProfile,
+  parseStructuredProfile,
+  type BrandAlignmentScoreResult,
+  type BrandVoiceStructuredProfile,
+} from '@actuate-media/cms-core/brand-voice'
 import { cmsApi } from '../../lib/api.js'
 
 /**
@@ -101,8 +107,15 @@ export interface BrandVoiceForm {
   audience: string
   guidelines: string
   sampleText: string
+  document: string
+  version: number
+  status: 'draft' | 'reviewed' | 'approved'
+  generatedFrom: string[]
+  structured: BrandVoiceStructuredProfile
 }
 
+export type BrandVoiceEditMode = 'form' | 'document'
+
 const EMPTY_BRAND_VOICE: BrandVoiceForm = {
   enabled: false,
   name: '',
@@ -110,6 +123,11 @@ const EMPTY_BRAND_VOICE: BrandVoiceForm = {
   audience: '',
   guidelines: '',
   sampleText: '',
+  document: '',
+  version: 1,
+  status: 'draft',
+  generatedFrom: [],
+  structured: defaultStructuredProfile(),
 }
 
 /** The buffered (Save-bar) portion of AI settings. */
@@ -134,6 +152,10 @@ interface AiSettingsResponse {
       audience?: string
       guidelines?: string
       sampleText?: string
+      document?: string
+      version?: number
+      status?: 'draft' | 'reviewed' | 'approved'
+      generatedFrom?: string[]
     }
   }
   providers: AiProviderView[]
@@ -162,6 +184,13 @@ function formFromResponse(res: AiSettingsResponse): AiSettingsForm {
       audience: res.settings.brandVoice?.audience ?? '',
       guidelines: res.settings.brandVoice?.guidelines ?? '',
       sampleText: res.settings.brandVoice?.sampleText ?? '',
+      document: res.settings.brandVoice?.document ?? '',
+      version: res.settings.brandVoice?.version ?? 1,
+      status: res.settings.brandVoice?.status ?? 'draft',
+      generatedFrom: res.settings.brandVoice?.generatedFrom ?? [],
+      structured: res.settings.brandVoice?.document?.trim()
+        ? parseStructuredProfile(res.settings.brandVoice.document)
+        : defaultStructuredProfile(),
     },
   }
 }
@@ -182,7 +211,8 @@ function brandVoiceIsEmpty(bv: BrandVoiceForm): boolean {
     !bv.tone.trim() &&
     !bv.audience.trim() &&
     !bv.guidelines.trim() &&
-    !bv.sampleText.trim()
+    !bv.sampleText.trim() &&
+    !bv.document.trim()
   )
 }
 
@@ -213,6 +243,25 @@ export interface UseAiSettings {
   setFeatureModel: (key: string, modelId: string) => void
   /** Patch one or more brand voice fields. */
   setBrandVoice: (patch: Partial<BrandVoiceForm>) => void
+  /** Whether saves should trust the markdown document or quick-edit fields. */
+  brandVoiceEditMode: BrandVoiceEditMode
+  setBrandVoiceEditMode: (mode: BrandVoiceEditMode) => void
+  /** Scan published content and draft brand voice fields (does not save). */
+  analyzeBrandVoice: (input: {
+    collections: string[]
+    urls?: string[]
+    uploads?: Array<{ name: string; text: string }>
+  }) => Promise<{
+    ok: boolean
+    draft?: Partial<BrandVoiceForm>
+    sampleCount?: number
+    error?: string
+  }>
+  scoreBrandVoice: (input: { content: string; channel?: string }) => Promise<{
+    ok: boolean
+    result?: BrandAlignmentScoreResult
+    error?: string
+  }>
   dirty: boolean
   budgetError: string | null
   saveState: SaveState
@@ -248,6 +297,7 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
   const [saveState, setSaveState] = useState<SaveState>('idle')
   const [saveError, setSaveError] = useState<string | null>(null)
   const [busyProviderId, setBusyProviderId] = useState<string | null>(null)
+  const [brandVoiceEditMode, setBrandVoiceEditMode] = useState<BrandVoiceEditMode>('form')
   const [reloadKey, setReloadKey] = useState(0)
 
   const loadModels = useCallback(async () => {
@@ -329,6 +379,56 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
     setSaveState('idle')
   }, [])
 
+  const analyzeBrandVoice = useCallback(
+    async (input: {
+      collections: string[]
+      urls?: string[]
+      uploads?: Array<{ name: string; text: string }>
+    }) => {
+      if (!canEdit) return { ok: false, error: 'You do not have permission to do this.' }
+      try {
+        const res = await cmsApi<{
+          draft: Partial<BrandVoiceForm> & { document?: string }
+          sampleCount: number
+        }>('/ai/brand-voice/analyze', {
+          method: 'POST',
+          body: JSON.stringify(input),
+        })
+        if (res.error) return { ok: false, error: res.error }
+        if (!res.data?.draft) return { ok: false, error: 'No draft profile was returned.' }
+        const structured = res.data.draft.document?.trim()
+          ? parseStructuredProfile(res.data.draft.document)
+          : defaultStructuredProfile()
+        return {
+          ok: true,
+          draft: { ...res.data.draft, structured },
+          sampleCount: res.data.sampleCount,
+        }
+      } catch {
+        return { ok: false, error: 'Brand voice analysis failed.' }
+      }
+    },
+    [canEdit],
+  )
+
+  const scoreBrandVoice = useCallback(
+    async (input: { content: string; channel?: string }) => {
+      if (!canEdit) return { ok: false, error: 'You do not have permission to do this.' }
+      try {
+        const res = await cmsApi<BrandAlignmentScoreResult>('/ai/brand-voice/score', {
+          method: 'POST',
+          body: JSON.stringify(input),
+        })
+        if (res.error) return { ok: false, error: res.error }
+        if (!res.data) return { ok: false, error: 'No score was returned.' }
+        return { ok: true, result: res.data }
+      } catch {
+        return { ok: false, error: 'Brand voice scoring failed.' }
+      }
+    },
+    [canEdit],
+  )
+
   const budgetError = useMemo(() => {
     if (form.monthlyTokenLimit === '') return null
     const n = Number(form.monthlyTokenLimit)
@@ -348,8 +448,30 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
       'audience',
       'guidelines',
       'sampleText',
+      'document',
+      'version',
+      'status',
+      'generatedFrom',
+      'structured',
     ]
-    if (bvKeys.some((k) => form.brandVoice[k] !== baseline.brandVoice[k])) return true
+    if (
+      bvKeys.some((k) => {
+        if (k === 'generatedFrom') {
+          return (
+            JSON.stringify(form.brandVoice.generatedFrom) !==
+            JSON.stringify(baseline.brandVoice.generatedFrom)
+          )
+        }
+        if (k === 'structured') {
+          return (
+            JSON.stringify(form.brandVoice.structured) !==
+            JSON.stringify(baseline.brandVoice.structured)
+          )
+        }
+        return 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 ?? '')
@@ -384,6 +506,11 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
                 audience: form.brandVoice.audience,
                 guidelines: form.brandVoice.guidelines,
                 sampleText: form.brandVoice.sampleText,
+                document: form.brandVoice.document,
+                version: form.brandVoice.version,
+                status: form.brandVoice.status,
+                generatedFrom: form.brandVoice.generatedFrom,
+                preferDocument: brandVoiceEditMode === 'document',
               },
         }),
       })
@@ -397,7 +524,7 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
       setSaveState('error')
       setSaveError(err instanceof Error ? err.message : 'Failed to save AI settings.')
     }
-  }, [canEdit, budgetError, form])
+  }, [canEdit, budgetError, form, brandVoiceEditMode])
 
   const reset = useCallback(() => {
     setForm(baseline)
@@ -535,6 +662,10 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
     toggleFeature,
     setFeatureModel,
     setBrandVoice,
+    analyzeBrandVoice,
+    scoreBrandVoice,
+    brandVoiceEditMode,
+    setBrandVoiceEditMode,
     dirty,
     budgetError,
     saveState,