arkaos 3.29.0 → 3.31.0

package/VERSION

@@ -1 +1 @@
-3.29.0
+3.31.0

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

@@ -105,6 +105,41 @@ function markedHtml(src: string): string {
   }
 }
 
+// PR89d v3.30.0 — download YAML.
+const downloadingYaml = ref(false)
+async function downloadYaml() {
+  if (!agent.value) return
+  downloadingYaml.value = true
+  try {
+    const blob = await $fetch<Blob>(
+      `${apiBase}/api/agents/${agentId}/yaml`,
+      { responseType: 'blob' },
+    )
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = `${agentId}.yaml`
+    document.body.appendChild(a)
+    a.click()
+    a.remove()
+    URL.revokeObjectURL(url)
+    toast.add({
+      title: 'YAML downloaded',
+      description: `${agentId}.yaml`,
+      color: 'success',
+      icon: 'i-lucide-download',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Download failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    downloadingYaml.value = false
+  }
+}
+
 // PR86c v3.17.0 — export to Obsidian.
 const exporting = ref(false)
 async function exportToVault() {
@@ -359,6 +394,14 @@ function formatTokens(n: number): string {
                     :loading="exporting"
                     @click="exportToVault"
                   />
+                  <UButton
+                    label="YAML"
+                    icon="i-lucide-download"
+                    variant="ghost"
+                    size="sm"
+                    :loading="downloadingYaml"
+                    @click="downloadYaml"
+                  />
                   <UButton
                     label="Edit"
                     icon="i-lucide-pencil"

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

@@ -241,6 +241,41 @@ function markedHtml(src: string): string {
   }
 }
 
+// PR90a v3.31.0 — download persona as Markdown.
+const downloadingMd = ref(false)
+async function downloadMarkdown() {
+  if (!detail.value) return
+  downloadingMd.value = true
+  try {
+    const blob = await $fetch<Blob>(
+      `${apiBase}/api/personas/${personaId}/markdown`,
+      { responseType: 'blob' },
+    )
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = `${detail.value.name || personaId}.md`
+    document.body.appendChild(a)
+    a.click()
+    a.remove()
+    URL.revokeObjectURL(url)
+    toast.add({
+      title: 'Markdown downloaded',
+      description: `${detail.value.name || personaId}.md`,
+      color: 'success',
+      icon: 'i-lucide-download',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Download failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    downloadingMd.value = false
+  }
+}
+
 // PR85a v3.11.0 — Clone to Agent dialog.
 const cloneOpen = ref(false)
 function onCloned(agentId: string) {
@@ -526,6 +561,14 @@ const vocabOptions = [
                       size="sm"
                       @click="cloneOpen = true"
                     />
+                    <UButton
+                      label="MD"
+                      icon="i-lucide-download"
+                      variant="ghost"
+                      size="sm"
+                      :loading="downloadingMd"
+                      @click="downloadMarkdown"
+                    />
                     <UButton label="Edit" icon="i-lucide-pencil" size="sm" @click="startEdit" />
                     <UButton
                       icon="i-lucide-trash-2"

package/package.json

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

package/scripts/dashboard-api.py

@@ -322,6 +322,79 @@ def agent_activity_strip(agent_id: str, period: str = "month"):
     }
 
 
+@app.get("/api/personas/{persona_id}/markdown")
+def persona_download_markdown(persona_id: str):
+    """PR90a v3.31.0 — return the persona as a Markdown file.
+
+    Renders via ObsidianPersonaStore._render so the output matches
+    exactly what gets written when the operator clicks Save with a
+    configured vault. Responds with ``text/markdown`` and an
+    attachment Content-Disposition.
+    """
+    detail = persona_detail(persona_id)
+    if "error" in detail:
+        return detail
+    from core.personas.obsidian_store import ObsidianPersonaStore
+    from core.personas.schema import (
+        Persona, PersonaDISC, PersonaEnneagram, PersonaBigFive, PersonaCommunication,
+    )
+    try:
+        persona = Persona(
+            id=detail.get("id", ""),
+            name=detail.get("name", ""),
+            title=detail.get("title", ""),
+            tagline=detail.get("tagline", ""),
+            source=detail.get("source", ""),
+            disc=PersonaDISC(**(detail.get("disc") or {})),
+            enneagram=PersonaEnneagram(**(detail.get("enneagram") or {})),
+            big_five=PersonaBigFive(**(detail.get("big_five") or {})),
+            mbti=detail.get("mbti", "INTJ"),
+            mental_models=detail.get("mental_models") or [],
+            expertise_domains=detail.get("expertise_domains") or [],
+            frameworks=detail.get("frameworks") or [],
+            key_quotes=detail.get("key_quotes") or [],
+            communication=PersonaCommunication(**(detail.get("communication") or {})),
+            bio_md=detail.get("bio_md", "") or "",
+            created_at=detail.get("created_at", ""),
+        )
+    except (TypeError, ValueError) as exc:
+        return {"error": f"persona schema mismatch: {exc}"}
+    content = ObsidianPersonaStore._render(persona)
+    filename = f"{persona.name or persona.id}.md".replace("/", "-")
+    from fastapi import Response
+    return Response(
+        content=content,
+        media_type="text/markdown",
+        headers={
+            "Content-Disposition": f'attachment; filename="{filename}"',
+        },
+    )
+
+
+@app.get("/api/agents/{agent_id}/yaml")
+def agent_download_yaml(agent_id: str):
+    """PR89d v3.30.0 — return the raw YAML for the agent.
+
+    Responds with ``application/x-yaml`` and an attachment Content-
+    Disposition so browsers prompt a Save As. Refuses unknown agents.
+    """
+    yaml_file = _resolve_agent_yaml(agent_id)
+    if yaml_file is None:
+        return {"error": "Agent not found"}
+    try:
+        content = yaml_file.read_text(encoding="utf-8")
+    except OSError as exc:
+        return {"error": f"read failed: {exc}"}
+    from fastapi import Response
+    return Response(
+        content=content,
+        media_type="application/x-yaml",
+        headers={
+            "Content-Disposition": f'attachment; filename="{yaml_file.name}"',
+        },
+    )
+
+
 @app.get("/api/agents/{agent_id}/history")
 def agent_history(agent_id: str, limit: int = 20):
     """PR88d v3.26.0 — combined history for an agent.