arkaos 3.16.0 → 3.18.0

package/VERSION

@@ -1 +1 @@
-3.16.0
+3.18.0

package/core/agents/obsidian_export.py

@@ -0,0 +1,171 @@
+"""Export agent profiles to the Obsidian vault (PR86c v3.17.0).
+
+Writes a Markdown file with YAML frontmatter + readable sections to
+``<vault>/Agents/<id>.md``. Sibling to ``core/personas/obsidian_store``
+but write-only — agents are still source-of-truth in their YAML files.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+
+from core.profile import ProfileManager
+
+
+_AGENTS_SUBDIR = "Agents"
+
+
+class AgentExportError(RuntimeError):
+    """Raised when the vault is missing or the write fails."""
+
+
+@dataclass(frozen=True)
+class AgentExportResult:
+    path: Path
+    vault_path: Path
+
+
+def export_agent_to_vault(agent: dict) -> AgentExportResult:
+    """Render `agent` as Markdown and write it to the configured vault.
+
+    `agent` is the YAML-loaded dict for the agent (the same shape
+    returned by ``/api/agents/{id}``).
+    """
+    if not isinstance(agent, dict) or not agent.get("id"):
+        raise AgentExportError("agent payload must include 'id'")
+    vault = _resolve_vault_path()
+    if vault is None:
+        raise AgentExportError(
+            "Obsidian vault is not configured (set vaultPath in profile)"
+        )
+    target_dir = vault / _AGENTS_SUBDIR
+    target_dir.mkdir(parents=True, exist_ok=True)
+    target = target_dir / f"{agent['id']}.md"
+    md = _render(agent)
+    tmp = target.with_suffix(target.suffix + ".tmp")
+    try:
+        tmp.write_text(md, encoding="utf-8")
+        tmp.replace(target)
+    except OSError as exc:
+        raise AgentExportError(f"write failed: {exc}") from exc
+    return AgentExportResult(path=target, vault_path=vault)
+
+
+def _resolve_vault_path() -> Path | None:
+    try:
+        profile = ProfileManager().read()
+    except Exception:  # noqa: BLE001
+        return None
+    if not profile.vaultPath:
+        return None
+    path = Path(profile.vaultPath).expanduser()
+    return path if path.exists() else None
+
+
+def _render(agent: dict) -> str:
+    """Compose the Markdown body — YAML frontmatter + readable sections."""
+    fm_lines = [
+        "---",
+        "type: agent",
+        f"id: {agent.get('id', '')}",
+        f"name: {_yaml_str(agent.get('name', ''))}",
+        f"role: {_yaml_str(agent.get('role', ''))}",
+        f"department: {agent.get('department', '')}",
+        f"tier: {agent.get('tier', '')}",
+        f"model: {agent.get('model', '')}",
+        "---",
+        "",
+    ]
+    sections: list[str] = []
+    sections.append(f"# {agent.get('name') or agent.get('id', '(unnamed)')}")
+    if agent.get("role"):
+        sections.append(f"*{agent['role']}* · `{agent.get('department', '')}`")
+    sections.append("")
+
+    dna = agent.get("behavioral_dna") or {}
+    if dna:
+        sections.append("## Behavioural DNA")
+        disc = dna.get("disc") or {}
+        enn = dna.get("enneagram") or {}
+        bf = dna.get("big_five") or {}
+        mbti = dna.get("mbti")
+        mbti_type = mbti.get("type") if isinstance(mbti, dict) else mbti
+        sections.append(f"- **DISC:** {disc.get('primary', '?')}/{disc.get('secondary', '?')}")
+        sections.append(f"- **Enneagram:** {enn.get('type', '?')}w{enn.get('wing', '?')}")
+        sections.append(f"- **MBTI:** {mbti_type or '—'}")
+        if bf:
+            ocean = " · ".join(
+                f"{k[:1].upper()}{int(v)}"
+                for k, v in bf.items()
+                if isinstance(v, (int, float))
+            )
+            if ocean:
+                sections.append(f"- **OCEAN:** {ocean}")
+        sections.append("")
+
+    exp = agent.get("expertise") or {}
+    if exp:
+        sections.append("## Expertise")
+        domains = exp.get("domains") or []
+        frameworks = exp.get("frameworks") or []
+        if domains:
+            sections.append("**Domains**")
+            sections.extend(f"- {d}" for d in domains)
+            sections.append("")
+        if frameworks:
+            sections.append("**Frameworks**")
+            sections.extend(f"- {f}" for f in frameworks)
+            sections.append("")
+        sections.append(f"*Depth: {exp.get('depth', '—')} · {exp.get('years_equivalent', '—')}y equivalent*")
+        sections.append("")
+
+    mm = agent.get("mental_models") or {}
+    if mm:
+        primary = mm.get("primary") or []
+        secondary = mm.get("secondary") or []
+        if primary or secondary:
+            sections.append("## Mental Models")
+            if primary:
+                sections.append("**Primary**")
+                sections.extend(f"- {m}" for m in primary)
+                sections.append("")
+            if secondary:
+                sections.append("**Secondary**")
+                sections.extend(f"- {m}" for m in secondary)
+                sections.append("")
+
+    comm = agent.get("communication") or {}
+    if comm and any(comm.values()):
+        sections.append("## Communication")
+        if comm.get("tone"):
+            sections.append(f"- **Tone:** {comm['tone']}")
+        if comm.get("vocabulary_level"):
+            sections.append(f"- **Vocabulary:** {comm['vocabulary_level']}")
+        if comm.get("preferred_format"):
+            sections.append(f"- **Preferred format:** {comm['preferred_format']}")
+        if comm.get("language"):
+            sections.append(f"- **Language:** {comm['language']}")
+        avoid = comm.get("avoid") or []
+        if avoid:
+            sections.append(f"- **Avoid:** {', '.join(avoid)}")
+        sections.append("")
+
+    linked = agent.get("linked_personas") or []
+    if linked:
+        sections.append("## Linked Personas")
+        sections.extend(f"- [[{p}]]" for p in linked)
+        sections.append("")
+
+    sections.append("")
+    sections.append("*Generated by ArkaOS — source of truth lives in the YAML file.*")
+    return "\n".join(fm_lines + sections)
+
+
+def _yaml_str(value: object) -> str:
+    """Quote a YAML scalar if it contains special characters."""
+    s = "" if value is None else str(value)
+    if any(c in s for c in ":#'\"\n"):
+        escaped = s.replace('"', '\\"')
+        return f'"{escaped}"'
+    return s

package/core/personas/schema.py

@@ -61,6 +61,10 @@ class Persona(BaseModel):
     # Communication
     communication: PersonaCommunication = Field(default_factory=PersonaCommunication)
 
+    # PR86d v3.18.0 — long-form Markdown bio. Free-text field, never
+    # parsed; rendered in the dashboard with `marked` for preview.
+    bio_md: str = ""
+
     # Metadata
     created_at: str = ""
     updated_at: str = ""

package/dashboard/app/components/AgentEditDrawer.vue

@@ -58,6 +58,7 @@ interface AgentDraft {
     avoid: string[]
   }
   linked_personas: string[]
+  bio_md: string
 }
 
 const draft = ref<AgentDraft | null>(null)
@@ -88,6 +89,7 @@ watch(
           avoid: agent.communication?.avoid ?? [],
         },
         linked_personas: agent.linked_personas ?? [],
+        bio_md: agent.bio_md ?? '',
       }
       dirty.value = false
     } else if (!open) {
@@ -323,6 +325,7 @@ async function save() {
       },
       communication: draft.value.communication,
       linked_personas: draft.value.linked_personas,
+      bio_md: draft.value.bio_md,
     }
     const res = await $fetch<{
       id: string
@@ -653,6 +656,18 @@ const vocabOptions = [
             </UFormField>
           </section>
 
+          <section class="space-y-3">
+            <h3 class="text-xs font-semibold uppercase tracking-wider text-muted">
+              Bio (Markdown)
+            </h3>
+            <MarkdownEditor
+              :model-value="draft.bio_md"
+              :rows="10"
+              placeholder="A free-text Markdown bio for this agent — context, voice samples, internal notes."
+              @update:model-value="(v: string) => { if (draft) { draft.bio_md = v; markDirty() } }"
+            />
+          </section>
+
           <section class="space-y-3">
             <h3 class="text-xs font-semibold uppercase tracking-wider text-muted">
               Linked personas

package/dashboard/app/components/MarkdownEditor.vue

@@ -0,0 +1,74 @@
+<script setup lang="ts">
+// PR86d v3.18.0 — Markdown editor with Edit / Preview tabs.
+//
+// Standalone component used in agent + persona edit forms. The model
+// value is the raw Markdown string. Preview is rendered via marked
+// (already a deps after this PR).
+
+import { marked } from 'marked'
+
+const props = defineProps<{
+  modelValue: string
+  placeholder?: string
+  rows?: number
+}>()
+const emit = defineEmits<{
+  (e: 'update:modelValue', value: string): void
+}>()
+
+const tab = ref<'edit' | 'preview'>('edit')
+
+const value = computed({
+  get: () => props.modelValue ?? '',
+  set: (v: string) => emit('update:modelValue', v),
+})
+
+const html = computed(() => {
+  if (!value.value.trim()) {
+    return '<p class="text-muted italic">Nothing to preview yet.</p>'
+  }
+  try {
+    return marked.parse(value.value, { breaks: true, gfm: true })
+  } catch {
+    return '<p class="text-error">Markdown parse failed.</p>'
+  }
+})
+</script>
+
+<template>
+  <div class="space-y-2">
+    <div class="flex items-center gap-1 text-xs">
+      <button
+        type="button"
+        class="px-2 py-1 rounded-md transition-colors"
+        :class="tab === 'edit' ? 'bg-elevated/60 text-default font-semibold' : 'text-muted hover:text-default'"
+        @click="tab = 'edit'"
+      >
+        Edit
+      </button>
+      <button
+        type="button"
+        class="px-2 py-1 rounded-md transition-colors"
+        :class="tab === 'preview' ? 'bg-elevated/60 text-default font-semibold' : 'text-muted hover:text-default'"
+        @click="tab = 'preview'"
+      >
+        Preview
+      </button>
+      <span class="ml-auto text-xs text-muted">
+        Markdown · GFM · {{ value.length }} char{{ value.length === 1 ? '' : 's' }}
+      </span>
+    </div>
+    <UTextarea
+      v-if="tab === 'edit'"
+      v-model="value"
+      :rows="rows ?? 8"
+      :placeholder="placeholder ?? 'Write a Markdown bio…\n\n# Heading\n- bullets\n**bold**'"
+      class="w-full font-mono text-sm"
+    />
+    <div
+      v-else
+      class="rounded-lg border border-default bg-elevated/10 p-4 min-h-[12rem] prose prose-sm dark:prose-invert max-w-none"
+      v-html="html"
+    />
+  </div>
+</template>

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

@@ -9,7 +9,8 @@
 const route = useRoute()
 const agentId = route.params.id as string
 
-const { fetchApi } = useApi()
+const { fetchApi, apiBase } = useApi()
+const toast = useToast()
 const { data: agent, status, error, refresh } = fetchApi<any>(`/api/agents/${agentId}`)
 
 // Per-department activity (PR69 endpoint) for the stats row.
@@ -64,6 +65,45 @@ function formatRelative(iso: string | null): string {
 const favs = useFavorites()
 await favs.load()
 
+// PR86d v3.18.0 — render Markdown bio.
+import { marked } from 'marked'
+function markedHtml(src: string): string {
+  if (!src?.trim()) return ''
+  try {
+    return marked.parse(src, { breaks: true, gfm: true }) as string
+  } catch {
+    return ''
+  }
+}
+
+// PR86c v3.17.0 — export to Obsidian.
+const exporting = ref(false)
+async function exportToVault() {
+  if (!agent.value) return
+  exporting.value = true
+  try {
+    const res = await $fetch<{ exported?: boolean, path?: string, error?: string }>(
+      `${apiBase}/api/agents/${agentId}/export`,
+      { method: 'POST' },
+    )
+    if (res.error) throw new Error(res.error)
+    toast.add({
+      title: 'Exported to Obsidian',
+      description: res.path ? res.path.split('/').slice(-3).join('/') : undefined,
+      color: 'success',
+      icon: 'i-lucide-file-text',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Export failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    exporting.value = false
+  }
+}
+
 // PR76 — edit drawer state
 const editOpen = ref(false)
 
@@ -282,6 +322,14 @@ function formatTokens(n: number): string {
                     :aria-label="favs.isAgentFavorite(agent.id) ? 'Unfavorite' : 'Favorite'"
                     @click="favs.toggle('agents', agent.id)"
                   />
+                  <UButton
+                    label="Export"
+                    icon="i-lucide-file-text"
+                    variant="soft"
+                    size="sm"
+                    :loading="exporting"
+                    @click="exportToVault"
+                  />
                   <UButton
                     label="Edit"
                     icon="i-lucide-pencil"
@@ -381,6 +429,20 @@ function formatTokens(n: number): string {
           </div>
         </section>
 
+        <!-- ===== BIO (PR86d) ===== -->
+        <section
+          v-if="(agent as any).bio_md"
+          class="rounded-xl border border-default bg-elevated/10 p-5"
+        >
+          <h3 class="text-sm font-semibold uppercase tracking-wide text-muted mb-3">
+            Bio
+          </h3>
+          <div
+            class="prose prose-sm dark:prose-invert max-w-none"
+            v-html="markedHtml((agent as any).bio_md)"
+          />
+        </section>
+
         <AgentEditDrawer
           v-model="editOpen"
           :agent="agent"

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

@@ -230,6 +230,17 @@ const suggestingField = ref<SuggestField | null>(null)
 const favs = useFavorites()
 await favs.load()
 
+// PR86d v3.18.0 — render Markdown bio.
+import { marked } from 'marked'
+function markedHtml(src: string): string {
+  if (!src?.trim()) return ''
+  try {
+    return marked.parse(src, { breaks: true, gfm: true }) as string
+  } catch {
+    return ''
+  }
+}
+
 // PR85a v3.11.0 — Clone to Agent dialog.
 const cloneOpen = ref(false)
 function onCloned(agentId: string) {
@@ -560,6 +571,20 @@ const vocabOptions = [
             </div>
           </section>
 
+          <!-- BIO (PR86d) -->
+          <section
+            v-if="(detail as any).bio_md"
+            class="rounded-xl border border-default bg-elevated/10 p-5"
+          >
+            <h3 class="text-sm font-semibold uppercase tracking-wide text-muted mb-3">
+              Bio
+            </h3>
+            <div
+              class="prose prose-sm dark:prose-invert max-w-none"
+              v-html="markedHtml((detail as any).bio_md)"
+            />
+          </section>
+
           <!-- TABS -->
           <UTabs :items="tabs" default-value="dna" class="w-full">
             <template #content="{ item }">
@@ -937,6 +962,18 @@ const vocabOptions = [
                     </UFormField>
                   </section>
 
+                  <section class="space-y-3">
+                    <h3 class="text-xs font-semibold uppercase tracking-wider text-muted">
+                      Bio (Markdown)
+                    </h3>
+                    <MarkdownEditor
+                      :model-value="(draft as any).bio_md ?? ''"
+                      :rows="10"
+                      placeholder="A free-text Markdown bio for this persona — voice samples, context, references."
+                      @update:model-value="(v: string) => { if (draft) { (draft as any).bio_md = v; markDirty() } }"
+                    />
+                  </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>

package/dashboard/package.json

@@ -21,6 +21,7 @@
     "@vueuse/core": "^14.2.1",
     "@vueuse/nuxt": "^14.2.1",
     "date-fns": "^4.1.0",
+    "marked": "^15.0.0",
     "nuxt": "^4.4.2",
     "scule": "^1.3.0",
     "tailwindcss": "^4.2.2",

package/package.json

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

package/scripts/dashboard-api.py

@@ -451,6 +451,9 @@ def agent_update(agent_id: str, body: dict):
         raw["communication"] = comm
     if "linked_personas" in body:
         raw["linked_personas"] = _agent_str_list(body["linked_personas"])
+    # PR86d v3.18.0 — Markdown bio (long-form free text).
+    if "bio_md" in body and isinstance(body["bio_md"], str):
+        raw["bio_md"] = body["bio_md"]
 
     try:
         tmp = yaml_file.with_suffix(yaml_file.suffix + ".tmp")
@@ -1101,6 +1104,7 @@ def persona_update(persona_id: str, body: dict):
         communication=PersonaCommunication(
             **(merged.get("communication", {}) or {}),
         ),
+        bio_md=merged.get("bio_md", "") or "",
         created_at=merged.get("created_at", ""),
     )
 
@@ -1361,6 +1365,28 @@ def persona_delete(persona_id: str):
     return {"error": "Persona not found"}
 
 
+# --- Agent → Obsidian export (PR86c v3.17.0) ---
+
+@app.post("/api/agents/{agent_id}/export")
+def agent_export_to_vault(agent_id: str):
+    """Write the agent profile as Markdown under <vault>/Agents/<id>.md."""
+    detail = agent_detail(agent_id)
+    if "error" in detail:
+        return detail
+    try:
+        from core.agents.obsidian_export import (
+            AgentExportError,
+            export_agent_to_vault,
+        )
+    except Exception as exc:  # noqa: BLE001
+        return {"error": f"export module unavailable: {exc}"}
+    try:
+        res = export_agent_to_vault(detail)
+    except AgentExportError as exc:
+        return {"error": str(exc)}
+    return {"exported": True, "path": str(res.path), "vault_path": str(res.vault_path)}
+
+
 # --- Favorites (PR86a v3.15.0) ---
 
 @app.get("/api/favorites")