arkaos 3.2.0 → 3.4.0

package/VERSION

@@ -1 +1 @@
-3.2.0
+3.4.0

package/core/personas/description_drafter.py

@@ -0,0 +1,111 @@
+"""AI-powered persona draft from a free-text description (PR83a v3.3.0).
+
+Sibling to `core/personas/builder.PersonaBuilder` but does NOT require
+indexed content. Useful when:
+
+- The operator wants to model a persona quickly without ingesting sources
+- A YouTuber / author isn't yet in the knowledge base
+- The persona is a synthetic archetype rather than a real person
+
+Reuses the same JSON schema and parsing as the vector-driven builder so
+the resulting Persona is interchangeable.
+"""
+
+from __future__ import annotations
+
+import uuid
+from dataclasses import dataclass
+from datetime import datetime, timezone
+
+from core.personas.builder import (
+    _PERSONA_SYSTEM_PROMPT,
+    _extract_json_object,
+)
+from core.personas.schema import (
+    Persona,
+    PersonaBigFive,
+    PersonaCommunication,
+    PersonaDISC,
+    PersonaEnneagram,
+)
+from core.runtime.llm_provider import LLMProvider, LLMUnavailable, get_llm_provider
+
+
+_DESCRIPTION_MIN_CHARS = 20
+
+
+class PersonaDraftError(RuntimeError):
+    """LLM produced unusable output or could not be reached."""
+
+
+@dataclass(frozen=True)
+class PersonaDraftResult:
+    persona: Persona
+    provider_name: str
+    raw_response: str
+
+
+def draft_persona_from_description(
+    description: str,
+    *,
+    name: str,
+    source_label: str = "",
+    provider: LLMProvider | None = None,
+) -> PersonaDraftResult:
+    """Generate a Persona draft from a free-text description."""
+    description = (description or "").strip()
+    if not name or not name.strip():
+        raise PersonaDraftError("name must not be empty")
+    if len(description) < _DESCRIPTION_MIN_CHARS:
+        raise PersonaDraftError(
+            f"description must be at least {_DESCRIPTION_MIN_CHARS} characters"
+        )
+    llm = provider or get_llm_provider()
+    prompt = _build_prompt(name.strip(), description)
+    try:
+        resp = llm.complete(prompt, max_tokens=3000, system=_PERSONA_SYSTEM_PROMPT)
+    except LLMUnavailable as exc:
+        raise PersonaDraftError(str(exc)) from exc
+    persona = _parse(name.strip(), source_label.strip() or name.strip(), resp.text)
+    return PersonaDraftResult(
+        persona=persona, provider_name=llm.name(), raw_response=resp.text,
+    )
+
+
+def _build_prompt(name: str, description: str) -> str:
+    return (
+        f"Person: {name}\n\n"
+        f"Description provided by the operator:\n{description}\n\n"
+        "Build the persona purely from the description above. If a field is "
+        "not implied, choose the closest neutral default rather than "
+        "fabricating. NEVER invent quotes — leave key_quotes empty if no "
+        "quotes are present in the description."
+    )
+
+
+def _parse(name: str, source_label: str, raw: str) -> Persona:
+    data = _extract_json_object(raw)
+    if data is None:
+        raise PersonaDraftError(
+            f"LLM did not return a JSON object; raw response: {raw[:200]!r}"
+        )
+    try:
+        return Persona(
+            id=str(uuid.uuid4()),
+            name=name,
+            title=str(data.get("title") or ""),
+            tagline=str(data.get("tagline") or ""),
+            source=source_label,
+            disc=PersonaDISC(**(data.get("disc") or {})),
+            enneagram=PersonaEnneagram(**(data.get("enneagram") or {})),
+            big_five=PersonaBigFive(**(data.get("big_five") or {})),
+            mbti=str(data.get("mbti") or "").upper() or "INTJ",
+            mental_models=[str(x) for x in (data.get("mental_models") or [])],
+            expertise_domains=[str(x) for x in (data.get("expertise_domains") or [])],
+            frameworks=[str(x) for x in (data.get("frameworks") or [])],
+            key_quotes=[str(x) for x in (data.get("key_quotes") or [])],
+            communication=PersonaCommunication(**(data.get("communication") or {})),
+            created_at=datetime.now(timezone.utc).isoformat(),
+        )
+    except (TypeError, ValueError) as exc:
+        raise PersonaDraftError(f"persona schema mismatch: {exc}") from exc

package/dashboard/app/components/PersonaWizard.vue

@@ -37,6 +37,12 @@ const sourceLineCount = computed(() =>
     .length,
 )
 
+// PR83a v3.3.0 — Mode 3: build from a free-text description (no chunks).
+type Mode = 'sources' | 'existing' | 'description'
+const mode = ref<Mode>('sources')
+const description = ref('')
+const descriptionLength = computed(() => description.value.trim().length)
+
 // ─── Step 2 state ────────────────────────────────────────────────────────
 const ingestJobs = ref<Array<{
   source: string
@@ -81,7 +87,14 @@ const tierOptions = [
 
 
 async function startIngest() {
-  if (skipIngest.value) {
+  if (mode.value === 'description') {
+    // PR83a — no ingest, no chunks. Build directly from description.
+    if (descriptionLength.value < 20 || !name.value.trim()) return
+    step.value = 3
+    await runDescriptionBuild()
+    return
+  }
+  if (mode.value === 'existing' || skipIngest.value) {
     // Jump straight to step 3 — operator says content is already indexed.
     step.value = 3
     await runBuild()
@@ -166,6 +179,36 @@ onBeforeUnmount(() => {
 // ─── Step 3: build the persona draft ────────────────────────────────────
 
 
+async function runDescriptionBuild() {
+  building.value = true
+  buildError.value = null
+  draft.value = null
+  try {
+    const res = await $fetch<{ persona: Persona, provider_name: string, error?: string }>(
+      `${apiBase}/api/personas/draft`,
+      {
+        method: 'POST',
+        body: {
+          name: name.value.trim(),
+          description: description.value.trim(),
+          source_label: sourceLabel.value.trim() || name.value.trim(),
+        },
+      },
+    )
+    if ('error' in res && typeof (res as any).error === 'string') {
+      throw new Error((res as any).error)
+    }
+    draft.value = res.persona
+    chunksUsed.value = 0
+    step.value = 4
+  } catch (err) {
+    buildError.value = err instanceof Error ? err.message : 'unknown error'
+  } finally {
+    building.value = false
+  }
+}
+
+
 async function runBuild() {
   building.value = true
   buildError.value = null
@@ -308,7 +351,28 @@ function backToStep1() {
         />
       </UFormField>
 
+      <UFormField label="How should we generate this persona?">
+        <div class="grid grid-cols-1 md:grid-cols-3 gap-2">
+          <button
+            v-for="m in ([
+              { key: 'sources',     title: 'Ingest sources',  desc: 'YouTube, articles, PDFs — best fidelity' },
+              { key: 'existing',    title: 'Existing chunks', desc: 'Use what is already indexed' },
+              { key: 'description', title: 'From description', desc: 'No sources — pure description' },
+            ] as const)"
+            :key="m.key"
+            type="button"
+            class="text-left rounded-lg border p-3 transition-colors"
+            :class="mode === m.key ? 'border-primary bg-primary/5' : 'border-default hover:border-primary/40'"
+            @click="mode = m.key"
+          >
+            <p class="text-sm font-semibold">{{ m.title }}</p>
+            <p class="text-xs text-muted mt-1">{{ m.desc }}</p>
+          </button>
+        </div>
+      </UFormField>
+
       <UFormField
+        v-if="mode === 'sources'"
         label="Sources (one URL per line)"
         help="YouTube videos, articles, PDFs, blog posts about this person. The builder will search the indexed chunks and synthesise their behavioural DNA. Up to 50 sources per batch."
       >
@@ -317,28 +381,56 @@ function backToStep1() {
           :rows="6"
           placeholder="https://www.youtube.com/watch?v=...&#10;https://example.com/article&#10;https://example.com/paper.pdf"
           class="w-full font-mono text-sm"
-          :disabled="skipIngest"
         />
       </UFormField>
 
-      <div class="flex items-center justify-between text-xs text-muted">
-        <span>{{ sourceLineCount }} source{{ sourceLineCount === 1 ? '' : 's' }} detected</span>
-        <UCheckbox
-          v-model="skipIngest"
-          label="Skip ingest — content for this person is already in the knowledge base"
+      <UFormField
+        v-else-if="mode === 'description'"
+        label="Description"
+        help="Plain-text description of the person — their style, beliefs, what they do, how they talk. The LLM uses this verbatim. Minimum 20 characters."
+      >
+        <UTextarea
+          v-model="description"
+          :rows="6"
+          placeholder="A direct-response copywriter who treats offers as the only true growth lever. Punchy, allergic to fluff. Loves Hormozi-style hooks."
+          class="w-full"
         />
+      </UFormField>
+
+      <div
+        v-if="mode === 'sources'"
+        class="flex items-center justify-between text-xs text-muted"
+      >
+        <span>{{ sourceLineCount }} source{{ sourceLineCount === 1 ? '' : 's' }} detected</span>
+      </div>
+
+      <div v-else-if="mode === 'existing'" class="text-xs text-muted">
+        We will search the vector DB for chunks tagged with this name and synthesise from what we find. Make sure you've ingested content for this person first.
+      </div>
+
+      <div v-else-if="mode === 'description'" class="text-xs text-muted">
+        {{ descriptionLength }} character{{ descriptionLength === 1 ? '' : 's' }} ·
+        {{ descriptionLength >= 20 ? 'ready' : `${20 - descriptionLength} more needed` }}
       </div>
 
       <div class="flex justify-end gap-2 pt-4">
         <UButton
-          :label="skipIngest ? 'Generate from existing knowledge' : `Index ${sourceLineCount} source${sourceLineCount === 1 ? '' : 's'} & build`"
+          :label="(
+            mode === 'sources' ? `Index ${sourceLineCount} source${sourceLineCount === 1 ? '' : 's'} & build`
+            : mode === 'existing' ? 'Generate from existing knowledge'
+            : 'Generate from description'
+          )"
           icon="i-lucide-arrow-right"
-          :disabled="!name.trim() || (!skipIngest && sourceLineCount === 0) || sourceLineCount > 50"
+          :disabled="(
+            !name.trim()
+            || (mode === 'sources' && (sourceLineCount === 0 || sourceLineCount > 50))
+            || (mode === 'description' && descriptionLength < 20)
+          )"
           size="md"
           @click="startIngest"
         />
       </div>
-      <p v-if="sourceLineCount > 50" class="text-xs text-red-400">
+      <p v-if="mode === 'sources' && sourceLineCount > 50" class="text-xs text-red-400">
         Over the 50-source cap. Trim the list before continuing.
       </p>
     </div>

package/dashboard/app/pages/agents/index.vue

@@ -138,6 +138,7 @@ const tierColor = (tier: number) => {
 }
 
 const columns: TableColumn<Agent>[] = [
+  { id: 'select',              header: '' },
   { accessorKey: 'name',       header: 'Name' },
   { accessorKey: 'role',       header: 'Role' },
   { accessorKey: 'department', header: 'Department' },
@@ -155,6 +156,78 @@ const columns: TableColumn<Agent>[] = [
 function goToAgent(id: string) {
   navigateTo(`/agents/${id}`)
 }
+
+// PR83b v3.4.0 — bulk selection + delete.
+const confirmDialog = useConfirmDialog()
+const selected = ref<Set<string>>(new Set())
+const bulkDeleting = ref(false)
+
+function toggleSelected(id: string) {
+  if (selected.value.has(id)) selected.value.delete(id)
+  else selected.value.add(id)
+  selected.value = new Set(selected.value)
+}
+
+function toggleAllVisible() {
+  const visibleIds = paginatedAgents.value.map((a) => a.id)
+  const allSelected = visibleIds.every((id) => selected.value.has(id))
+  const next = new Set(selected.value)
+  for (const id of visibleIds) {
+    if (allSelected) next.delete(id)
+    else next.add(id)
+  }
+  selected.value = next
+}
+
+const allVisibleSelected = computed(() => {
+  const visibleIds = paginatedAgents.value.map((a) => a.id)
+  return visibleIds.length > 0 && visibleIds.every((id) => selected.value.has(id))
+})
+
+function clearSelection() {
+  selected.value = new Set()
+}
+
+async function bulkDelete() {
+  if (selected.value.size === 0) return
+  const ids = Array.from(selected.value)
+  const ok = await confirmDialog({
+    title: `Delete ${ids.length} agent${ids.length === 1 ? '' : 's'}?`,
+    description: 'YAML files will be removed from disk. This cannot be undone. Tier 0 agents are protected and will be skipped.',
+    confirmLabel: `Delete ${ids.length}`,
+    cancelLabel: 'Cancel',
+    variant: 'danger',
+  })
+  if (!ok) return
+  bulkDeleting.value = true
+  const results = await Promise.allSettled(
+    ids.map((id) =>
+      $fetch<{ deleted?: boolean, error?: string }>(`${apiBase}/api/agents/${id}`, {
+        method: 'DELETE',
+      }),
+    ),
+  )
+  const successes = results.filter(
+    (r) => r.status === 'fulfilled' && r.value.deleted,
+  ).length
+  const failures = ids.length - successes
+  if (successes > 0) {
+    toast.add({
+      title: `Deleted ${successes} agent${successes === 1 ? '' : 's'}`,
+      description: failures > 0 ? `${failures} skipped (Tier 0 or missing)` : undefined,
+      color: failures > 0 ? 'warning' : 'success',
+    })
+  } else {
+    toast.add({
+      title: 'Nothing deleted',
+      description: 'All targets were protected or missing.',
+      color: 'error',
+    })
+  }
+  clearSelection()
+  bulkDeleting.value = false
+  await refreshAll()
+}
 </script>
 
 <template>
@@ -233,6 +306,21 @@ function goToAgent(id: string) {
             td: 'border-b border-default'
           }"
         >
+          <template #select-header>
+            <UCheckbox
+              :model-value="allVisibleSelected"
+              aria-label="Select all visible"
+              @update:model-value="toggleAllVisible"
+            />
+          </template>
+          <template #select-cell="{ row }">
+            <UCheckbox
+              :model-value="selected.has(row.original.id)"
+              :aria-label="`Select ${row.original.name}`"
+              @update:model-value="() => toggleSelected(row.original.id)"
+              @click.stop
+            />
+          </template>
           <template #name-cell="{ row }">
             <button class="text-left font-medium text-primary hover:underline" @click="goToAgent(row.original.id)">
               {{ row.original.name }}
@@ -277,6 +365,39 @@ function goToAgent(id: string) {
           </template>
         </UTable>
 
+        <Transition
+          enter-active-class="transition ease-out duration-150"
+          enter-from-class="translate-y-4 opacity-0"
+          enter-to-class="translate-y-0 opacity-100"
+          leave-active-class="transition ease-in duration-100"
+          leave-from-class="translate-y-0 opacity-100"
+          leave-to-class="translate-y-4 opacity-0"
+        >
+          <div
+            v-if="selected.size > 0"
+            class="fixed bottom-6 left-1/2 -translate-x-1/2 z-50 flex items-center gap-3 rounded-xl border border-default bg-elevated shadow-lg px-4 py-2"
+          >
+            <span class="text-sm font-semibold">
+              {{ selected.size }} selected
+            </span>
+            <UButton
+              label="Clear"
+              variant="ghost"
+              size="xs"
+              @click="clearSelection"
+            />
+            <div class="h-5 w-px bg-default" />
+            <UButton
+              label="Delete"
+              icon="i-lucide-trash-2"
+              color="error"
+              size="sm"
+              :loading="bulkDeleting"
+              @click="bulkDelete"
+            />
+          </div>
+        </Transition>
+
         <div v-if="totalPages > 1" class="flex items-center justify-center mt-6">
           <UPagination
             :page="page"

package/dashboard/app/pages/personas/index.vue

@@ -8,7 +8,7 @@
 import type { TableColumn } from '@nuxt/ui'
 import type { Persona } from '~/types'
 
-const { fetchApi } = useApi()
+const { fetchApi, apiBase } = useApi()
 
 const { data, status, error, refresh } = await fetchApi<{
   personas: Persona[]
@@ -118,6 +118,7 @@ function agentCount(personaId: string): number {
 }
 
 const columns: TableColumn<Persona>[] = [
+  { id: 'select',              header: '' },
   { accessorKey: 'name',       header: 'Name' },
   { accessorKey: 'title',      header: 'Title' },
   { accessorKey: 'source',     header: 'Source' },
@@ -131,6 +132,78 @@ const columns: TableColumn<Persona>[] = [
 function goToPersona(id: string) {
   navigateTo(`/personas/${id}`)
 }
+
+// PR83b v3.4.0 — bulk selection + delete.
+const toast = useToast()
+const confirmDialog = useConfirmDialog()
+const selected = ref<Set<string>>(new Set())
+const bulkDeleting = ref(false)
+
+function toggleSelected(id: string) {
+  if (selected.value.has(id)) selected.value.delete(id)
+  else selected.value.add(id)
+  selected.value = new Set(selected.value)
+}
+
+function toggleAllVisible() {
+  const visibleIds = paginatedPersonas.value.map((p) => p.id)
+  const allSelected = visibleIds.every((id) => selected.value.has(id))
+  const next = new Set(selected.value)
+  for (const id of visibleIds) {
+    if (allSelected) next.delete(id)
+    else next.add(id)
+  }
+  selected.value = next
+}
+
+const allVisibleSelected = computed(() => {
+  const visibleIds = paginatedPersonas.value.map((p) => p.id)
+  return visibleIds.length > 0 && visibleIds.every((id) => selected.value.has(id))
+})
+
+function clearSelection() {
+  selected.value = new Set()
+}
+
+async function bulkDelete() {
+  if (selected.value.size === 0) return
+  const ids = Array.from(selected.value)
+  const ok = await confirmDialog({
+    title: `Delete ${ids.length} persona${ids.length === 1 ? '' : 's'}?`,
+    description: 'Personas will be removed from the JSON store and the Obsidian vault. This cannot be undone.',
+    confirmLabel: `Delete ${ids.length}`,
+    cancelLabel: 'Cancel',
+    variant: 'danger',
+  })
+  if (!ok) return
+  bulkDeleting.value = true
+  const results = await Promise.allSettled(
+    ids.map((id) =>
+      $fetch<{ deleted?: boolean, error?: string }>(`${apiBase}/api/personas/${id}`, {
+        method: 'DELETE',
+      }),
+    ),
+  )
+  const successes = results.filter(
+    (r) => r.status === 'fulfilled' && r.value.deleted,
+  ).length
+  const failures = ids.length - successes
+  if (successes > 0) {
+    toast.add({
+      title: `Deleted ${successes} persona${successes === 1 ? '' : 's'}`,
+      description: failures > 0 ? `${failures} failed` : undefined,
+      color: failures > 0 ? 'warning' : 'success',
+    })
+  } else {
+    toast.add({
+      title: 'Nothing deleted',
+      color: 'error',
+    })
+  }
+  clearSelection()
+  bulkDeleting.value = false
+  await refreshAll()
+}
 </script>
 
 <template>
@@ -218,6 +291,21 @@ function goToPersona(id: string) {
           }"
           @select="(row: Persona) => goToPersona(row.id)"
         >
+          <template #select-header>
+            <UCheckbox
+              :model-value="allVisibleSelected"
+              aria-label="Select all visible"
+              @update:model-value="toggleAllVisible"
+            />
+          </template>
+          <template #select-cell="{ row }">
+            <UCheckbox
+              :model-value="selected.has(row.original.id)"
+              :aria-label="`Select ${row.original.name}`"
+              @update:model-value="() => toggleSelected(row.original.id)"
+              @click.stop
+            />
+          </template>
           <template #name-cell="{ row }">
             <span class="font-medium">{{ row.original.name }}</span>
           </template>
@@ -282,6 +370,39 @@ function goToPersona(id: string) {
           </template>
         </UTable>
 
+        <Transition
+          enter-active-class="transition ease-out duration-150"
+          enter-from-class="translate-y-4 opacity-0"
+          enter-to-class="translate-y-0 opacity-100"
+          leave-active-class="transition ease-in duration-100"
+          leave-from-class="translate-y-0 opacity-100"
+          leave-to-class="translate-y-4 opacity-0"
+        >
+          <div
+            v-if="selected.size > 0"
+            class="fixed bottom-6 left-1/2 -translate-x-1/2 z-50 flex items-center gap-3 rounded-xl border border-default bg-elevated shadow-lg px-4 py-2"
+          >
+            <span class="text-sm font-semibold">
+              {{ selected.size }} selected
+            </span>
+            <UButton
+              label="Clear"
+              variant="ghost"
+              size="xs"
+              @click="clearSelection"
+            />
+            <div class="h-5 w-px bg-default" />
+            <UButton
+              label="Delete"
+              icon="i-lucide-trash-2"
+              color="error"
+              size="sm"
+              :loading="bulkDeleting"
+              @click="bulkDelete"
+            />
+          </div>
+        </Transition>
+
         <div v-if="totalPages > 1" class="flex items-center justify-center mt-6">
           <UPagination
             :page="page"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "3.2.0"
+version = "3.4.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/dashboard-api.py

@@ -1094,6 +1094,55 @@ def persona_clone(persona_id: str, body: dict = {}):
     return {"agent_id": agent_id, "department": department, "file": f"departments/{department}/agents/{agent_id}.yaml"}
 
 
+@app.delete("/api/agents/{agent_id}")
+def agent_delete(agent_id: str):
+    """PR83b v3.4.0 — delete an agent's YAML file.
+
+    Refuses to delete Tier 0 (C-Suite) agents — those are governance
+    fixtures and need direct YAML removal to make the intent explicit.
+
+    Resolves the YAML location two ways:
+      1. From the cached registry (covers seeded agents)
+      2. By scanning departments/*/agents/<id>.yaml (covers
+         freshly-created agents that aren't in the registry yet)
+    """
+    yaml_file = _resolve_agent_yaml(agent_id)
+    if yaml_file is None:
+        return {"error": "Agent not found"}
+    tier = _agent_tier_from_yaml(yaml_file)
+    if tier == 0:
+        return {"error": "Cannot delete Tier 0 (C-Suite) agents from the dashboard"}
+    try:
+        yaml_file.unlink()
+    except OSError as exc:
+        return {"error": f"delete failed: {exc}"}
+    return {"deleted": True, "id": agent_id, "yaml_path": str(yaml_file)}
+
+
+def _resolve_agent_yaml(agent_id: str) -> Optional[Path]:
+    # 1. Check the cached registry first.
+    for a in _load_agents():
+        if a.get("id") == agent_id:
+            candidate = ARKAOS_ROOT / a.get("file", "")
+            if candidate.exists():
+                return candidate
+    # 2. Filesystem scan — covers freshly-created files.
+    dept_root = ARKAOS_ROOT / "departments"
+    if dept_root.exists():
+        for path in dept_root.glob(f"*/agents/{agent_id}.yaml"):
+            return path
+    return None
+
+
+def _agent_tier_from_yaml(yaml_file: Path) -> int:
+    try:
+        import yaml as _yaml
+        raw = _yaml.safe_load(yaml_file.read_text(encoding="utf-8")) or {}
+    except Exception:
+        return 99
+    return int(raw.get("tier") or 99)
+
+
 @app.delete("/api/personas/{persona_id}")
 def persona_delete(persona_id: str):
     mgr = _get_persona_manager()
@@ -1827,6 +1876,43 @@ def _build_agent_yaml(
     return payload
 
 
+# --- AI persona draft from description (PR83a v3.3.0) ---
+
+@app.post("/api/personas/draft")
+def personas_draft(body: dict):
+    """Generate a Persona draft from a free-text description (no vector DB).
+
+    Body: {
+        "description": "...",    # min 20 chars
+        "name": "Alex Carter",   # required
+        "source_label": "..."    # optional
+    }
+    Returns: {"persona": {...}, "provider_name": "..."}
+
+    Sibling to /api/personas/build (which requires indexed chunks). Useful
+    when the operator wants a quick draft without ingesting sources first.
+    The result is NOT saved — operator reviews + POSTs to /api/personas.
+    """
+    from core.personas.description_drafter import (
+        PersonaDraftError,
+        draft_persona_from_description,
+    )
+
+    description = (body.get("description") or "").strip()
+    name = (body.get("name") or "").strip()
+    source_label = (body.get("source_label") or "").strip()
+    try:
+        res = draft_persona_from_description(
+            description, name=name, source_label=source_label,
+        )
+    except PersonaDraftError as exc:
+        return {"error": str(exc)}
+    return {
+        "persona": res.persona.model_dump(),
+        "provider_name": res.provider_name,
+    }
+
+
 # --- AI agent draft from description (PR82b v3.1.0) ---
 
 @app.post("/api/agents/draft")