arkaos 3.15.0 → 3.17.0

package/VERSION

@@ -1 +1 @@
-3.15.0
+3.17.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/runtime/llm_provider.py

@@ -367,7 +367,8 @@ def _current_category() -> str:
 
     PR60 v2.77.0 — orchestration layers can set
     ``ARKA_CALL_CATEGORY=skill:<slug>`` /
-    ``subagent:<dept>`` / ``plugin:<id>`` / ``mcp:<server>`` before
+    ``subagent:<dept>`` or ``subagent:<dept>:<agent_id>`` /
+    ``plugin:<id>`` / ``mcp:<server>`` before
     invoking the provider so `/arka costs --by-category` (PR47) can
     attribute spend. Returns "" when unset, which lands in the base
     bucket (backward-compatible).

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.
@@ -27,9 +28,10 @@ const deptActivity = computed<ActivityRow | null>(() =>
   (activityData.value?.by_department?.[agent.value?.department ?? ''] ?? null),
 )
 
-// PR83d v3.6.0 — activity strip (30d, dept-level + last_used + rank)
+// PR83d v3.6.0 + PR86b v3.16.0 — activity strip (30d, agent or dept scope)
 interface ActivityStrip {
   period: string
+  scope: 'agent' | 'department'
   department: string
   calls: number
   cost_usd: number | null
@@ -63,6 +65,34 @@ function formatRelative(iso: string | null): string {
 const favs = useFavorites()
 await favs.load()
 
+// 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)
 
@@ -281,6 +311,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"
@@ -346,7 +384,7 @@ function formatTokens(n: number): string {
             <div class="flex items-center gap-2">
               <UIcon name="i-lucide-activity" class="size-4 text-primary" />
               <span class="font-semibold uppercase tracking-wide text-muted text-xs">
-                30d activity (dept)
+                30d activity ({{ activityStrip.scope === 'agent' ? 'agent' : 'dept' }})
               </span>
             </div>
             <div class="flex items-center gap-2">

package/package.json

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

package/scripts/dashboard-api.py

@@ -220,11 +220,17 @@ def agents_activity(period: str = "week"):
 
 @app.get("/api/agents/{agent_id}/activity-strip")
 def agent_activity_strip(agent_id: str, period: str = "month"):
-    """PR83d v3.6.0 — compact activity payload for the agent hero strip.
+    """PR83d v3.6.0 + PR86b v3.16.0 — compact activity payload.
+
+    When telemetry is tagged ``subagent:<dept>:<agent_id>``, the response
+    prefers per-agent stats and includes a ``scope: "agent"`` flag.
+    Otherwise it falls back to department-level stats with
+    ``scope: "department"`` (the original PR83d behaviour).
 
     Returns:
       {
         "period": "month",
+        "scope": "agent" | "department",
         "department": "<dept>",
         "calls": <int>,
         "cost_usd": <float|null>,
@@ -233,9 +239,6 @@ def agent_activity_strip(agent_id: str, period: str = "month"):
         "dept_rank": <1-based int>|null,
         "dept_count": <int>
       }
-
-    All values reflect the agent's DEPARTMENT (per-agent attribution
-    isn't tracked yet — see PR47 telemetry).
     """
     agents = _load_agents()
     base = None
@@ -259,34 +262,51 @@ def agent_activity_strip(agent_id: str, period: str = "month"):
         period = "month"
 
     summary = summarise(period=period)
-    dept_costs: list[tuple[str, float]] = []
-    target_row: dict | None = None
+    dept_costs_map: dict[str, float] = {}
+    dept_row: dict | None = None
+    agent_row: dict | None = None
     for category, row in (summary.by_category or {}).items():
         if not isinstance(category, str) or not category.startswith("subagent:"):
             continue
-        cat_dept = category.split(":", 1)[1] or "unknown"
+        # subagent:<dept> OR subagent:<dept>:<agent_id>
+        parts = category.split(":", 2)
+        cat_dept = parts[1] if len(parts) >= 2 and parts[1] else "unknown"
+        cat_agent = parts[2] if len(parts) == 3 else None
         cost = row.get("total_cost_usd")
-        dept_costs.append((cat_dept, float(cost) if isinstance(cost, (int, float)) else 0.0))
-        if cat_dept == dept:
-            target_row = row
-
-    dept_costs.sort(key=lambda t: t[1], reverse=True)
+        cost_f = float(cost) if isinstance(cost, (int, float)) else 0.0
+        dept_costs_map[cat_dept] = dept_costs_map.get(cat_dept, 0.0) + cost_f
+        if cat_dept == dept and cat_agent is None:
+            dept_row = row
+        if cat_dept == dept and cat_agent == agent_id:
+            agent_row = row
+
+    dept_costs = sorted(dept_costs_map.items(), key=lambda t: t[1], reverse=True)
     dept_rank: Optional[int] = None
     for idx, (d, _) in enumerate(dept_costs, start=1):
         if d == dept:
             dept_rank = idx
             break
 
+    use_agent_scope = agent_row is not None
+    scope = "agent" if use_agent_scope else "department"
+    target_row = agent_row if use_agent_scope else dept_row
+
     entries, _ = _load_slice(None, _period_cutoff(period, now=None))
     last_used: Optional[str] = None
+    expect_cats = (
+        {f"subagent:{dept}:{agent_id}"}
+        if use_agent_scope
+        else {f"subagent:{dept}"}
+    )
     for entry in reversed(entries):
         cat = entry.get("category") or ""
-        if isinstance(cat, str) and cat == f"subagent:{dept}":
+        if isinstance(cat, str) and cat in expect_cats:
             last_used = entry.get("ts")
             break
 
     return {
         "period": period,
+        "scope": scope,
         "department": dept,
         "calls": int(target_row.get("call_count", 0)) if target_row else 0,
         "cost_usd": (
@@ -302,6 +322,16 @@ def agent_activity_strip(agent_id: str, period: str = "month"):
     }
 
 
+@app.get("/api/agents/{agent_id}/activity")
+def agent_activity_detail(agent_id: str, period: str = "month"):
+    """PR86b v3.16.0 — alias for /activity-strip. Same payload shape.
+
+    Exposed so callers can use a more natural name when they want the
+    full activity row rather than the compact hero strip.
+    """
+    return agent_activity_strip(agent_id, period)
+
+
 @app.get("/api/agents/{agent_id}")
 def agent_detail(agent_id: str):
     """Get full agent detail including YAML data."""
@@ -1331,6 +1361,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")