arkaos 3.1.0 → 3.2.0

package/VERSION

@@ -1 +1 @@
-3.1.0
+3.2.0

package/core/agents/field_suggester.py

@@ -27,6 +27,8 @@ _VALID_FIELDS: tuple[str, ...] = (
     "mental_models",
     "frameworks",
     "expertise_domains",
+    "communication_avoid",
+    "key_quotes",
 )
 _MAX_COUNT = 12
 _DEFAULT_COUNT = 5
@@ -40,6 +42,23 @@ _FIELD_LABELS: dict[str, str] = {
     "mental_models": "mental models",
     "frameworks": "frameworks",
     "expertise_domains": "expertise domains",
+    "communication_avoid": "phrases this profile should AVOID using",
+    "key_quotes": "verbatim or paraphrased key quotes",
+}
+
+# Field-specific length hints — different fields want different item shapes.
+_FIELD_LENGTH_HINT: dict[str, str] = {
+    "mental_models": "Return a JSON array of short strings (2-5 words each).",
+    "frameworks": "Return a JSON array of short strings (2-5 words each).",
+    "expertise_domains": "Return a JSON array of short strings (2-5 words each).",
+    "communication_avoid": (
+        "Return a JSON array of short phrases (2-6 words each) that the "
+        "profile would never say or write."
+    ),
+    "key_quotes": (
+        "Return a JSON array of full sentences (8-25 words each), each "
+        "phrased as if the person said it. No attribution prefixes."
+    ),
 }
 
 
@@ -94,10 +113,8 @@ def _build_prompt(field: str, context: dict, count: int) -> str:
             + ", ".join(current)
             + "."
         )
-    lines.append(
-        "Return a JSON array of short strings (2-5 words each). "
-        "No explanations, no numbering, no surrounding object."
-    )
+    lines.append(_FIELD_LENGTH_HINT[field])
+    lines.append("No explanations, no numbering, no surrounding object.")
     return "\n".join(lines)
 
 

package/dashboard/app/components/AgentEditDrawer.vue

@@ -111,7 +111,8 @@ function csvToList(value: string): string[] {
 }
 
 // PR81 v2.99.0 — AI list-field suggester.
-type SuggestField = 'mental_models_primary' | 'frameworks' | 'expertise_domains'
+// PR82c v3.2.0 — extended with 'communication_avoid'.
+type SuggestField = 'mental_models_primary' | 'frameworks' | 'expertise_domains' | 'communication_avoid'
 const suggestingField = ref<SuggestField | null>(null)
 
 async function suggest(field: SuggestField) {
@@ -122,7 +123,9 @@ async function suggest(field: SuggestField) {
       ? draft.value.mental_models.primary
       : field === 'frameworks'
         ? draft.value.frameworks
-        : draft.value.expertise_domains
+        : field === 'expertise_domains'
+          ? draft.value.expertise_domains
+          : draft.value.communication.avoid
   suggestingField.value = field
   try {
     const res = await $fetch<{
@@ -159,8 +162,10 @@ async function suggest(field: SuggestField) {
       draft.value.mental_models.primary = merged
     } else if (field === 'frameworks') {
       draft.value.frameworks = merged
-    } else {
+    } else if (field === 'expertise_domains') {
       draft.value.expertise_domains = merged
+    } else {
+      draft.value.communication.avoid = merged
     }
     markDirty()
     toast.add({
@@ -437,6 +442,18 @@ const vocabOptions = [
               </UFormField>
             </div>
             <UFormField label="Avoid (phrases)" help="comma-separated">
+              <template #hint>
+                <UButton
+                  label="Suggest with AI"
+                  icon="i-lucide-sparkles"
+                  size="xs"
+                  color="primary"
+                  variant="soft"
+                  :loading="suggestingField === 'communication_avoid'"
+                  :disabled="suggestingField !== null"
+                  @click="suggest('communication_avoid')"
+                />
+              </template>
               <UInput
                 :model-value="listToCsv(draft.communication.avoid)"
                 @update:model-value="(v: string) => { if (draft) { draft.communication.avoid = csvToList(v); markDirty() } }"

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

@@ -202,7 +202,8 @@ function csvToList(value: string): string[] {
 }
 
 // PR81 suggest wiring — three list fields.
-type SuggestField = 'mental_models' | 'frameworks' | 'expertise_domains'
+// PR82c v3.2.0 — extended with 'communication_avoid'.
+type SuggestField = 'mental_models' | 'frameworks' | 'expertise_domains' | 'communication_avoid'
 const suggestingField = ref<SuggestField | null>(null)
 
 async function suggest(field: SuggestField) {
@@ -211,7 +212,9 @@ async function suggest(field: SuggestField) {
       ? draft.value.mental_models_primary
       : field === 'frameworks'
         ? draft.value.frameworks
-        : draft.value.expertise_domains
+        : field === 'expertise_domains'
+          ? draft.value.expertise_domains
+          : draft.value.comm_avoid
   if (!draft.value.name.trim() || !draft.value.role.trim()) {
     toast.add({
       title: 'Add a name and role first',
@@ -250,7 +253,8 @@ async function suggest(field: SuggestField) {
     const merged = [...current, ...additions]
     if (field === 'mental_models') draft.value.mental_models_primary = merged
     else if (field === 'frameworks') draft.value.frameworks = merged
-    else draft.value.expertise_domains = merged
+    else if (field === 'expertise_domains') draft.value.expertise_domains = merged
+    else draft.value.comm_avoid = merged
     toast.add({
       title: `Added ${additions.length} suggestion${additions.length === 1 ? '' : 's'}`,
       description: `via ${res.provider_name}`,
@@ -553,6 +557,18 @@ const bigFiveKeys = ['openness', 'conscientiousness', 'extraversion', 'agreeable
             </UFormField>
           </div>
           <UFormField label="Avoid (phrases)" help="comma-separated">
+            <template #hint>
+              <UButton
+                label="Suggest with AI"
+                icon="i-lucide-sparkles"
+                size="xs"
+                color="primary"
+                variant="soft"
+                :loading="suggestingField === 'communication_avoid'"
+                :disabled="suggestingField !== null"
+                @click="suggest('communication_avoid')"
+              />
+            </template>
             <UInput
               :model-value="listToCsv(draft.comm_avoid)"
               @update:model-value="(v: string) => { draft.comm_avoid = csvToList(v) }"

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

@@ -222,12 +222,16 @@ function csvToList(value: string): string[] {
 }
 
 // PR81 v2.99.0 — AI list-field suggester for personas.
-type SuggestField = 'mental_models' | 'frameworks' | 'expertise_domains'
+// PR82c v3.2.0 — extended with 'communication_avoid' and 'key_quotes'.
+type SuggestField = 'mental_models' | 'frameworks' | 'expertise_domains' | 'communication_avoid' | 'key_quotes'
 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[]
+  const current
+    = field === 'communication_avoid'
+      ? (draft.value.communication.avoid ?? [])
+      : ((draft.value as any)[field] as string[] ?? [])
   suggestingField.value = field
   try {
     const res = await $fetch<{
@@ -258,7 +262,12 @@ async function suggest(field: SuggestField) {
       })
       return
     }
-    ;(draft.value as any)[field] = [...current, ...additions]
+    const merged = [...current, ...additions]
+    if (field === 'communication_avoid') {
+      draft.value.communication.avoid = merged
+    } else {
+      ;(draft.value as any)[field] = merged
+    }
     markDirty()
     toast.add({
       title: `Added ${additions.length} suggestion${additions.length === 1 ? '' : 's'}`,
@@ -751,6 +760,52 @@ const vocabOptions = [
                         <USelect v-model="draft.communication.vocabulary_level" :items="vocabOptions" class="w-full" @update:model-value="markDirty" />
                       </UFormField>
                     </div>
+                    <UFormField label="Avoid (phrases)" help="comma-separated">
+                      <template #hint>
+                        <UButton
+                          label="Suggest with AI"
+                          icon="i-lucide-sparkles"
+                          size="xs"
+                          color="primary"
+                          variant="soft"
+                          :loading="suggestingField === 'communication_avoid'"
+                          :disabled="suggestingField !== null"
+                          @click="suggest('communication_avoid')"
+                        />
+                      </template>
+                      <UInput
+                        :model-value="listToCsv(draft.communication.avoid)"
+                        @update:model-value="(v: string) => { if (draft) { draft.communication.avoid = csvToList(v); markDirty() } }"
+                        class="w-full"
+                      />
+                    </UFormField>
+                  </section>
+
+                  <section class="space-y-3">
+                    <div class="flex items-center justify-between">
+                      <h3 class="text-xs font-semibold uppercase tracking-wider text-muted">Key quotes</h3>
+                      <UButton
+                        label="Suggest with AI"
+                        icon="i-lucide-sparkles"
+                        size="xs"
+                        color="primary"
+                        variant="soft"
+                        :loading="suggestingField === 'key_quotes'"
+                        :disabled="suggestingField !== null"
+                        @click="suggest('key_quotes')"
+                      />
+                    </div>
+                    <UTextarea
+                      :model-value="(draft.key_quotes ?? []).join('\n')"
+                      :rows="4"
+                      placeholder="One quote per line. Verbatim or paraphrased."
+                      @update:model-value="(v: string) => { if (draft) { draft.key_quotes = v.split('\n').map((q) => q.trim()).filter(Boolean); markDirty() } }"
+                      class="w-full"
+                    />
+                    <p class="text-xs text-muted">
+                      {{ (draft.key_quotes ?? []).length }} quote{{ (draft.key_quotes ?? []).length === 1 ? '' : 's' }}.
+                      One per line.
+                    </p>
                   </section>
                 </div>
 

package/dashboard/app/types/index.d.ts

@@ -209,9 +209,11 @@ export interface Persona {
   mental_models: string[]
   expertise_domains: string[]
   frameworks: string[]
+  key_quotes?: string[]
   communication: {
     tone: string
     vocabulary_level: string
+    avoid?: string[]
   }
   cloned_to_agents: string[]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.1.0",
+  "version": "3.2.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.1.0"
+version = "3.2.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}