arkaos 2.97.0 → 2.99.0

package/VERSION

@@ -1 +1 @@
-2.97.0
+2.99.0

package/core/agents/field_suggester.py

@@ -0,0 +1,133 @@
+"""AI-assisted list-field suggester for agents and personas (PR81).
+
+Generates short lists of `mental_models`, `frameworks`, or
+`expertise_domains` for an entity given its existing context.
+
+The LLM is told NOT to duplicate items already present in
+`context["current"]`, and to return a strict JSON array of strings.
+
+Used by:
+- POST /api/agents/suggest   — ✨ Suggest button in AgentEditDrawer
+- POST /api/personas/suggest — ✨ Suggest button in persona edit slideover
+
+The module is provider-agnostic: callers can inject a fake `LLMProvider`
+in tests, and production callers fall back to `get_llm_provider()`.
+"""
+
+from __future__ import annotations
+
+import json
+import re
+from dataclasses import dataclass
+
+from core.runtime.llm_provider import LLMProvider, LLMUnavailable, get_llm_provider
+
+
+_VALID_FIELDS: tuple[str, ...] = (
+    "mental_models",
+    "frameworks",
+    "expertise_domains",
+)
+_MAX_COUNT = 12
+_DEFAULT_COUNT = 5
+
+_SYSTEM = (
+    "You suggest short, concrete items for behavioural agent and persona "
+    "profiles. Return ONLY a JSON array of strings. No prose, no fences, no keys."
+)
+
+_FIELD_LABELS: dict[str, str] = {
+    "mental_models": "mental models",
+    "frameworks": "frameworks",
+    "expertise_domains": "expertise domains",
+}
+
+
+class SuggestionError(RuntimeError):
+    """LLM produced unusable output or could not be reached."""
+
+
+@dataclass(frozen=True)
+class SuggestionResult:
+    suggestions: list[str]
+    provider_name: str
+
+
+def suggest_field(
+    field: str,
+    context: dict,
+    *,
+    count: int = _DEFAULT_COUNT,
+    provider: LLMProvider | None = None,
+) -> SuggestionResult:
+    """Return up to `count` AI-suggested items for the named field."""
+    if field not in _VALID_FIELDS:
+        raise SuggestionError(f"unknown field: {field!r}")
+    count = max(1, min(_MAX_COUNT, int(count)))
+    llm = provider or get_llm_provider()
+    prompt = _build_prompt(field, context, count)
+    try:
+        resp = llm.complete(prompt, max_tokens=600, system=_SYSTEM)
+    except LLMUnavailable as exc:
+        raise SuggestionError(str(exc)) from exc
+    items = _parse(resp.text)
+    deduped = _dedupe_against_current(items, context.get("current") or [])
+    return SuggestionResult(
+        suggestions=deduped[:count],
+        provider_name=llm.name(),
+    )
+
+
+def _build_prompt(field: str, context: dict, count: int) -> str:
+    name = (context.get("name") or "").strip() or "the entity"
+    role = (context.get("role") or context.get("title") or "").strip()
+    department = (context.get("department") or "").strip()
+    current = list(context.get("current") or [])[:20]
+    lines = [f"Suggest {count} new {_FIELD_LABELS[field]} for {name}."]
+    if role:
+        lines.append(f"Role: {role}.")
+    if department:
+        lines.append(f"Department: {department}.")
+    if current:
+        lines.append(
+            "Do NOT repeat any of these items already in the profile: "
+            + ", ".join(current)
+            + "."
+        )
+    lines.append(
+        "Return a JSON array of short strings (2-5 words each). "
+        "No explanations, no numbering, no surrounding object."
+    )
+    return "\n".join(lines)
+
+
+def _parse(text: str) -> list[str]:
+    cleaned = re.sub(r"^```(?:json)?\s*|\s*```$", "", text.strip(), flags=re.MULTILINE)
+    cleaned = cleaned.strip()
+    try:
+        data = json.loads(cleaned)
+    except (json.JSONDecodeError, ValueError):
+        return _fallback_lines(cleaned)
+    if not isinstance(data, list):
+        return _fallback_lines(cleaned)
+    return [str(x).strip() for x in data if str(x).strip()]
+
+
+def _fallback_lines(text: str) -> list[str]:
+    items: list[str] = []
+    for raw in re.split(r"[\n,]", text):
+        line = raw.strip(" \t-*•·0123456789.).\"'`")
+        if line and 2 <= len(line) <= 80:
+            items.append(line)
+    return items
+
+
+def _dedupe_against_current(items: list[str], current: list) -> list[str]:
+    seen = {str(c).strip().lower() for c in current}
+    out: list[str] = []
+    for item in items:
+        key = item.strip().lower()
+        if key and key not in seen:
+            out.append(item)
+            seen.add(key)
+    return out

package/dashboard/app/components/AgentEditDrawer.vue

@@ -110,6 +110,76 @@ function csvToList(value: string): string[] {
   return value.split(',').map((s) => s.trim()).filter(Boolean)
 }
 
+// PR81 v2.99.0 — AI list-field suggester.
+type SuggestField = 'mental_models_primary' | 'frameworks' | 'expertise_domains'
+const suggestingField = ref<SuggestField | null>(null)
+
+async function suggest(field: SuggestField) {
+  if (!draft.value || !props.agent) return
+  const backendField = field === 'mental_models_primary' ? 'mental_models' : field
+  const current
+    = field === 'mental_models_primary'
+      ? draft.value.mental_models.primary
+      : field === 'frameworks'
+        ? draft.value.frameworks
+        : draft.value.expertise_domains
+  suggestingField.value = field
+  try {
+    const res = await $fetch<{
+      suggestions: string[]
+      provider_name: string
+      error?: string
+    }>(`${apiBase}/api/agents/suggest`, {
+      method: 'POST',
+      body: {
+        field: backendField,
+        count: 5,
+        context: {
+          name: props.agent.name,
+          role: props.agent.role,
+          department: props.agent.department,
+          current,
+        },
+      },
+    })
+    if (res.error) throw new Error(res.error)
+    const additions = (res.suggestions ?? []).filter(
+      (s) => !current.some((c) => c.toLowerCase() === s.toLowerCase()),
+    )
+    if (additions.length === 0) {
+      toast.add({
+        title: 'No new suggestions',
+        description: 'The model returned only items you already have.',
+        color: 'info',
+      })
+      return
+    }
+    const merged = [...current, ...additions]
+    if (field === 'mental_models_primary') {
+      draft.value.mental_models.primary = merged
+    } else if (field === 'frameworks') {
+      draft.value.frameworks = merged
+    } else {
+      draft.value.expertise_domains = merged
+    }
+    markDirty()
+    toast.add({
+      title: `Added ${additions.length} suggestion${additions.length === 1 ? '' : 's'}`,
+      description: `via ${res.provider_name}`,
+      color: 'success',
+      icon: 'i-lucide-sparkles',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Suggestion failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    suggestingField.value = null
+  }
+}
+
 async function save() {
   if (!draft.value || !props.agent?.id) return
   saving.value = true
@@ -254,7 +324,19 @@ const vocabOptions = [
           </section>
 
           <section class="space-y-3">
-            <h3 class="text-xs font-semibold uppercase tracking-wider text-muted">Mental models</h3>
+            <div class="flex items-center justify-between">
+              <h3 class="text-xs font-semibold uppercase tracking-wider text-muted">Mental models</h3>
+              <UButton
+                label="Suggest with AI"
+                icon="i-lucide-sparkles"
+                size="xs"
+                color="primary"
+                variant="soft"
+                :loading="suggestingField === 'mental_models_primary'"
+                :disabled="suggestingField !== null"
+                @click="suggest('mental_models_primary')"
+              />
+            </div>
             <UFormField label="Primary" help="comma-separated">
               <UInput
                 :model-value="listToCsv(draft.mental_models.primary)"
@@ -274,6 +356,18 @@ const vocabOptions = [
           <section class="space-y-3">
             <h3 class="text-xs font-semibold uppercase tracking-wider text-muted">Expertise</h3>
             <UFormField label="Domains" help="comma-separated">
+              <template #hint>
+                <UButton
+                  label="Suggest with AI"
+                  icon="i-lucide-sparkles"
+                  size="xs"
+                  color="primary"
+                  variant="soft"
+                  :loading="suggestingField === 'expertise_domains'"
+                  :disabled="suggestingField !== null"
+                  @click="suggest('expertise_domains')"
+                />
+              </template>
               <UInput
                 :model-value="listToCsv(draft.expertise_domains)"
                 @update:model-value="(v: string) => { if (draft) { draft.expertise_domains = csvToList(v); markDirty() } }"
@@ -281,6 +375,18 @@ const vocabOptions = [
               />
             </UFormField>
             <UFormField label="Frameworks" help="comma-separated">
+              <template #hint>
+                <UButton
+                  label="Suggest with AI"
+                  icon="i-lucide-sparkles"
+                  size="xs"
+                  color="primary"
+                  variant="soft"
+                  :loading="suggestingField === 'frameworks'"
+                  :disabled="suggestingField !== null"
+                  @click="suggest('frameworks')"
+                />
+              </template>
               <UInput
                 :model-value="listToCsv(draft.frameworks)"
                 @update:model-value="(v: string) => { if (draft) { draft.frameworks = csvToList(v); markDirty() } }"

package/dashboard/app/pages/personas/[id].vue

@@ -221,6 +221,62 @@ function csvToList(value: string): string[] {
   return value.split(',').map((s) => s.trim()).filter(Boolean)
 }
 
+// PR81 v2.99.0 — AI list-field suggester for personas.
+type SuggestField = 'mental_models' | 'frameworks' | 'expertise_domains'
+const suggestingField = ref<SuggestField | null>(null)
+
+async function suggest(field: SuggestField) {
+  if (!draft.value || !detail.value) return
+  const current = (draft.value as any)[field] as string[]
+  suggestingField.value = field
+  try {
+    const res = await $fetch<{
+      suggestions: string[]
+      provider_name: string
+      error?: string
+    }>(`${apiBase}/api/personas/suggest`, {
+      method: 'POST',
+      body: {
+        field,
+        count: 5,
+        context: {
+          name: detail.value.name,
+          title: detail.value.title,
+          current,
+        },
+      },
+    })
+    if (res.error) throw new Error(res.error)
+    const additions = (res.suggestions ?? []).filter(
+      (s) => !current.some((c) => c.toLowerCase() === s.toLowerCase()),
+    )
+    if (additions.length === 0) {
+      toast.add({
+        title: 'No new suggestions',
+        description: 'The model returned only items you already have.',
+        color: 'info',
+      })
+      return
+    }
+    ;(draft.value as any)[field] = [...current, ...additions]
+    markDirty()
+    toast.add({
+      title: `Added ${additions.length} suggestion${additions.length === 1 ? '' : 's'}`,
+      description: `via ${res.provider_name}`,
+      color: 'success',
+      icon: 'i-lucide-sparkles',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Suggestion failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    suggestingField.value = null
+  }
+}
+
 const mbtiOptions = [
   'INTJ', 'INTP', 'ENTJ', 'ENTP',
   'INFJ', 'INFP', 'ENFJ', 'ENFP',
@@ -627,6 +683,18 @@ const vocabOptions = [
                   <section class="space-y-3">
                     <h3 class="text-xs font-semibold uppercase tracking-wider text-muted">Knowledge</h3>
                     <UFormField label="Mental models" help="comma-separated">
+                      <template #hint>
+                        <UButton
+                          label="Suggest with AI"
+                          icon="i-lucide-sparkles"
+                          size="xs"
+                          color="primary"
+                          variant="soft"
+                          :loading="suggestingField === 'mental_models'"
+                          :disabled="suggestingField !== null"
+                          @click="suggest('mental_models')"
+                        />
+                      </template>
                       <UInput
                         :model-value="listToCsv(draft.mental_models)"
                         @update:model-value="(v: string) => { if (draft) { draft.mental_models = csvToList(v); markDirty() } }"
@@ -634,6 +702,18 @@ const vocabOptions = [
                       />
                     </UFormField>
                     <UFormField label="Expertise domains" help="comma-separated">
+                      <template #hint>
+                        <UButton
+                          label="Suggest with AI"
+                          icon="i-lucide-sparkles"
+                          size="xs"
+                          color="primary"
+                          variant="soft"
+                          :loading="suggestingField === 'expertise_domains'"
+                          :disabled="suggestingField !== null"
+                          @click="suggest('expertise_domains')"
+                        />
+                      </template>
                       <UInput
                         :model-value="listToCsv(draft.expertise_domains)"
                         @update:model-value="(v: string) => { if (draft) { draft.expertise_domains = csvToList(v); markDirty() } }"
@@ -641,6 +721,18 @@ const vocabOptions = [
                       />
                     </UFormField>
                     <UFormField label="Frameworks" help="comma-separated">
+                      <template #hint>
+                        <UButton
+                          label="Suggest with AI"
+                          icon="i-lucide-sparkles"
+                          size="xs"
+                          color="primary"
+                          variant="soft"
+                          :loading="suggestingField === 'frameworks'"
+                          :disabled="suggestingField !== null"
+                          @click="suggest('frameworks')"
+                        />
+                      </template>
                       <UInput
                         :model-value="listToCsv(draft.frameworks)"
                         @update:model-value="(v: string) => { if (draft) { draft.frameworks = csvToList(v); markDirty() } }"

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

@@ -0,0 +1,67 @@
+<script setup lang="ts">
+// PR80 v2.98.0 — /personas/new wraps the 4-step AI PersonaWizard.
+//
+// Fills the dead link that PR78 introduced when it moved the New Persona
+// button into the table header but never built the destination route.
+//
+// Wizard contract (defined in components/PersonaWizard.vue):
+//   @completed(persona)   → wizard finished + saved; navigate to detail
+//   @cancelled            → operator backed out; return to the table
+//
+// The wizard never auto-saves; every step is operator-confirmed inside
+// the component, so this page is purely a hosting shell.
+
+import type { Persona } from '~/types'
+
+const toast = useToast()
+
+function onCompleted(persona: Persona) {
+  toast.add({
+    title: 'Persona created',
+    description: `${persona.name} is ready in the library.`,
+    color: 'success',
+    icon: 'i-lucide-check-circle',
+  })
+  navigateTo(`/personas/${persona.id}`)
+}
+
+function onCancelled() {
+  navigateTo('/personas')
+}
+</script>
+
+<template>
+  <UDashboardPanel id="personas-new">
+    <template #header>
+      <UDashboardNavbar title="New Persona">
+        <template #leading>
+          <UButton
+            icon="i-lucide-arrow-left"
+            variant="ghost"
+            size="sm"
+            aria-label="Back to personas"
+            to="/personas"
+          />
+        </template>
+        <template #trailing>
+          <UBadge
+            label="AI-assisted"
+            icon="i-lucide-sparkles"
+            color="primary"
+            variant="soft"
+            size="sm"
+          />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <div class="max-w-5xl mx-auto py-2">
+        <PersonaWizard
+          @completed="onCompleted"
+          @cancelled="onCancelled"
+        />
+      </div>
+    </template>
+  </UDashboardPanel>
+</template>

package/package.json

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

package/pyproject.toml

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

package/scripts/dashboard-api.py

@@ -1683,6 +1683,49 @@ def metrics():
     return {"entries": entries[-50:], "avg_ms": round(avg_ms, 1), "total_calls": len(entries)}
 
 
+# --- AI list-field suggester (PR81 v2.99.0) ---
+
+@app.post("/api/agents/suggest")
+def agents_suggest(body: dict):
+    """Suggest list items for the agent edit drawer via LLM.
+
+    Body: {
+        "field": "mental_models" | "frameworks" | "expertise_domains",
+        "context": {"name", "role", "department", "current": [...]},
+        "count": <optional, default 5, max 12>
+    }
+    Returns: {"suggestions": [...], "provider_name": "...", "source": "agent"}
+    """
+    return _do_field_suggest(body, source="agent")
+
+
+@app.post("/api/personas/suggest")
+def personas_suggest(body: dict):
+    """Suggest list items for the persona edit slideover via LLM.
+
+    Same shape as /api/agents/suggest. `context.title` may be passed
+    instead of `context.role` for personas.
+    """
+    return _do_field_suggest(body, source="persona")
+
+
+def _do_field_suggest(body: dict, *, source: str) -> dict:
+    from core.agents.field_suggester import SuggestionError, suggest_field
+
+    field = (body.get("field") or "").strip()
+    context = body.get("context") or {}
+    count = body.get("count") or 5
+    try:
+        res = suggest_field(field, context, count=int(count))
+    except SuggestionError as exc:
+        return {"error": str(exc)}
+    return {
+        "suggestions": res.suggestions,
+        "provider_name": res.provider_name,
+        "source": source,
+    }
+
+
 if __name__ == "__main__":
     import argparse
     parser = argparse.ArgumentParser()