arkaos 3.14.0 → 3.16.0

package/VERSION

@@ -1 +1 @@
-3.14.0
+3.16.0

package/core/favorites.py

@@ -0,0 +1,91 @@
+"""Favorites store for agents and personas (PR86a v3.15.0).
+
+Single JSON file at ``~/.arkaos/favorites.json`` shaped as
+``{"agents": ["<id>", ...], "personas": ["<id>", ...]}``.
+
+Survives across sessions, mutated by the dashboard. No tier-0 protection
+needed — favouriting is read-only intent.
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Literal
+
+FavoriteKind = Literal["agents", "personas"]
+_VALID_KINDS: tuple[str, ...] = ("agents", "personas")
+
+
+def _store_path() -> Path:
+    return Path.home() / ".arkaos" / "favorites.json"
+
+
+def _load() -> dict[str, list[str]]:
+    path = _store_path()
+    if not path.exists():
+        return {"agents": [], "personas": []}
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return {"agents": [], "personas": []}
+    if not isinstance(data, dict):
+        return {"agents": [], "personas": []}
+    return {
+        "agents": [str(x) for x in (data.get("agents") or []) if isinstance(x, str)],
+        "personas": [str(x) for x in (data.get("personas") or []) if isinstance(x, str)],
+    }
+
+
+def _save(state: dict[str, list[str]]) -> None:
+    path = _store_path()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    tmp = path.with_suffix(".json.tmp")
+    tmp.write_text(json.dumps(state, indent=2), encoding="utf-8")
+    tmp.replace(path)
+
+
+def list_favorites() -> dict[str, list[str]]:
+    """Return the current favourites payload."""
+    return _load()
+
+
+def is_favorite(kind: str, item_id: str) -> bool:
+    if kind not in _VALID_KINDS:
+        return False
+    state = _load()
+    return item_id in state.get(kind, [])
+
+
+def toggle(kind: str, item_id: str) -> dict:
+    """Flip the favourite state. Returns ``{kind, id, favorited}``."""
+    if kind not in _VALID_KINDS:
+        return {"error": f"unknown kind: {kind!r}"}
+    if not item_id:
+        return {"error": "id is required"}
+    state = _load()
+    bucket = state.setdefault(kind, [])
+    if item_id in bucket:
+        bucket.remove(item_id)
+        favorited = False
+    else:
+        bucket.append(item_id)
+        favorited = True
+    state[kind] = bucket
+    _save(state)
+    return {"kind": kind, "id": item_id, "favorited": favorited}
+
+
+def set_favorite(kind: str, item_id: str, favorited: bool) -> dict:
+    """Force a specific state. Useful for tests / bulk operations."""
+    if kind not in _VALID_KINDS:
+        return {"error": f"unknown kind: {kind!r}"}
+    state = _load()
+    bucket = state.setdefault(kind, [])
+    if favorited and item_id not in bucket:
+        bucket.append(item_id)
+    elif not favorited and item_id in bucket:
+        bucket.remove(item_id)
+    state[kind] = bucket
+    _save(state)
+    return {"kind": kind, "id": item_id, "favorited": favorited}

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/composables/useFavorites.ts

@@ -0,0 +1,73 @@
+// PR86a v3.15.0 — shared favourites state + toggle helper.
+//
+// Single source of truth for the dashboard so the star button in
+// agents/personas detail pages stays in sync with the filter chip
+// on the index tables.
+
+import { createSharedComposable } from '@vueuse/core'
+
+interface FavoritesPayload {
+  agents: string[]
+  personas: string[]
+}
+
+const _useFavorites = () => {
+  const { apiBase } = useApi()
+  const toast = useToast()
+  const state = useState<FavoritesPayload>('favorites', () => ({
+    agents: [],
+    personas: [],
+  }))
+  const loaded = useState<boolean>('favoritesLoaded', () => false)
+
+  async function load(force = false) {
+    if (loaded.value && !force) return
+    try {
+      const res = await $fetch<FavoritesPayload>(`${apiBase}/api/favorites`)
+      state.value = {
+        agents: res.agents ?? [],
+        personas: res.personas ?? [],
+      }
+      loaded.value = true
+    } catch {
+      // Best-effort — leave defaults
+      loaded.value = true
+    }
+  }
+
+  function isAgentFavorite(id: string): boolean {
+    return state.value.agents.includes(id)
+  }
+
+  function isPersonaFavorite(id: string): boolean {
+    return state.value.personas.includes(id)
+  }
+
+  async function toggle(kind: 'agents' | 'personas', id: string) {
+    try {
+      const res = await $fetch<{ favorited?: boolean, error?: string }>(
+        `${apiBase}/api/favorites/${kind}/${id}`,
+        { method: 'POST' },
+      )
+      if (res.error) throw new Error(res.error)
+      const bucket = state.value[kind]
+      if (res.favorited && !bucket.includes(id)) {
+        state.value = { ...state.value, [kind]: [...bucket, id] }
+      } else if (!res.favorited) {
+        state.value = { ...state.value, [kind]: bucket.filter((x) => x !== id) }
+      }
+      return res.favorited
+    } catch (err) {
+      toast.add({
+        title: 'Favorite toggle failed',
+        description: err instanceof Error ? err.message : 'unknown error',
+        color: 'error',
+      })
+      return null
+    }
+  }
+
+  return { state, load, isAgentFavorite, isPersonaFavorite, toggle, loaded }
+}
+
+export const useFavorites = createSharedComposable(_useFavorites)

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

@@ -27,9 +27,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
@@ -59,6 +60,10 @@ function formatRelative(iso: string | null): string {
   return `${months}mo ago`
 }
 
+// PR86a v3.15.0 — favorites.
+const favs = useFavorites()
+await favs.load()
+
 // PR76 — edit drawer state
 const editOpen = ref(false)
 
@@ -268,12 +273,22 @@ function formatTokens(n: number): string {
                   </h1>
                   <p class="text-base md:text-lg text-muted mt-0.5">{{ agent.role }}</p>
                 </div>
-                <UButton
-                  label="Edit"
-                  icon="i-lucide-pencil"
-                  size="sm"
-                  @click="openEditor"
-                />
+                <div class="flex items-center gap-2">
+                  <UButton
+                    icon="i-lucide-star"
+                    :color="favs.isAgentFavorite(agent.id) ? 'warning' : 'neutral'"
+                    :variant="favs.isAgentFavorite(agent.id) ? 'soft' : 'ghost'"
+                    size="sm"
+                    :aria-label="favs.isAgentFavorite(agent.id) ? 'Unfavorite' : 'Favorite'"
+                    @click="favs.toggle('agents', agent.id)"
+                  />
+                  <UButton
+                    label="Edit"
+                    icon="i-lucide-pencil"
+                    size="sm"
+                    @click="openEditor"
+                  />
+                </div>
               </div>
               <div class="flex flex-wrap items-center gap-2 pt-1">
                 <UBadge :label="agent.department" variant="subtle" />
@@ -332,7 +347,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/dashboard/app/pages/agents/index.vue

@@ -111,6 +111,10 @@ const filteredAgents = computed(() => {
     result = result.filter(agent => String(agent.tier) === tierFilter.value)
   }
 
+  if (favoritesOnly.value) {
+    result = result.filter(agent => favs.isAgentFavorite(agent.id))
+  }
+
   return result
 })
 
@@ -139,6 +143,7 @@ const tierColor = (tier: number) => {
 
 const columns: TableColumn<Agent>[] = [
   { id: 'select',              header: '' },
+  { id: 'favorite',            header: '' },
   { accessorKey: 'name',       header: 'Name' },
   { accessorKey: 'role',       header: 'Role' },
   { accessorKey: 'department', header: 'Department' },
@@ -157,6 +162,11 @@ function goToAgent(id: string) {
   navigateTo(`/agents/${id}`)
 }
 
+// PR86a v3.15.0 — favorites.
+const favs = useFavorites()
+await favs.load()
+const favoritesOnly = ref(false)
+
 // PR83b v3.4.0 — bulk selection + delete.
 // PR84b v3.8.0 — bulk move department.
 const confirmDialog = useConfirmDialog()
@@ -371,6 +381,15 @@ async function undoTrashIds(ids: string[]) {
             aria-label="Filter by tier"
           />
 
+          <UButton
+            :label="favoritesOnly ? 'All' : 'Favorites'"
+            :icon="favoritesOnly ? 'i-lucide-star' : 'i-lucide-star'"
+            :color="favoritesOnly ? 'warning' : 'neutral'"
+            :variant="favoritesOnly ? 'soft' : 'outline'"
+            size="sm"
+            @click="favoritesOnly = !favoritesOnly"
+          />
+
           <span class="ml-auto text-xs text-muted">
             {{ totalFiltered }} agent{{ totalFiltered !== 1 ? 's' : '' }}
           </span>
@@ -404,6 +423,16 @@ async function undoTrashIds(ids: string[]) {
               @click.stop
             />
           </template>
+          <template #favorite-cell="{ row }">
+            <UButton
+              :icon="favs.isAgentFavorite(row.original.id) ? 'i-lucide-star' : 'i-lucide-star'"
+              :color="favs.isAgentFavorite(row.original.id) ? 'warning' : 'neutral'"
+              :variant="favs.isAgentFavorite(row.original.id) ? 'soft' : 'ghost'"
+              size="xs"
+              :aria-label="favs.isAgentFavorite(row.original.id) ? 'Unfavorite' : 'Favorite'"
+              @click.stop="favs.toggle('agents', row.original.id)"
+            />
+          </template>
           <template #name-cell="{ row }">
             <button class="text-left font-medium text-primary hover:underline" @click="goToAgent(row.original.id)">
               {{ row.original.name }}

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

@@ -226,6 +226,10 @@ function csvToList(value: string): string[] {
 type SuggestField = 'mental_models' | 'frameworks' | 'expertise_domains' | 'communication_avoid' | 'key_quotes'
 const suggestingField = ref<SuggestField | null>(null)
 
+// PR86a v3.15.0 — favorites.
+const favs = useFavorites()
+await favs.load()
+
 // PR85a v3.11.0 — Clone to Agent dialog.
 const cloneOpen = ref(false)
 function onCloned(agentId: string) {
@@ -473,6 +477,14 @@ const vocabOptions = [
                     </p>
                   </div>
                   <div class="flex items-center gap-2">
+                    <UButton
+                      icon="i-lucide-star"
+                      :color="favs.isPersonaFavorite(detail.id) ? 'warning' : 'neutral'"
+                      :variant="favs.isPersonaFavorite(detail.id) ? 'soft' : 'ghost'"
+                      size="sm"
+                      :aria-label="favs.isPersonaFavorite(detail.id) ? 'Unfavorite' : 'Favorite'"
+                      @click="favs.toggle('personas', detail.id)"
+                    />
                     <UButton
                       label="Clone to Agent"
                       icon="i-lucide-copy-plus"

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

@@ -77,6 +77,9 @@ const filteredPersonas = computed<Persona[]>(() => {
       return src === sourceFilter.value
     })
   }
+  if (favoritesOnly.value) {
+    result = result.filter((p) => favs.isPersonaFavorite(p.id))
+  }
   return result
 })
 
@@ -119,6 +122,7 @@ function agentCount(personaId: string): number {
 
 const columns: TableColumn<Persona>[] = [
   { id: 'select',              header: '' },
+  { id: 'favorite',            header: '' },
   { accessorKey: 'name',       header: 'Name' },
   { accessorKey: 'title',      header: 'Title' },
   { accessorKey: 'source',     header: 'Source' },
@@ -133,6 +137,11 @@ function goToPersona(id: string) {
   navigateTo(`/personas/${id}`)
 }
 
+// PR86a v3.15.0 — favorites.
+const favs = useFavorites()
+await favs.load()
+const favoritesOnly = ref(false)
+
 // PR83b v3.4.0 — bulk selection + delete.
 const toast = useToast()
 const confirmDialog = useConfirmDialog()
@@ -299,6 +308,15 @@ async function undoTrashIds(ids: string[]) {
             aria-label="Filter by source store"
           />
 
+          <UButton
+            :label="favoritesOnly ? 'All' : 'Favorites'"
+            icon="i-lucide-star"
+            :color="favoritesOnly ? 'warning' : 'neutral'"
+            :variant="favoritesOnly ? 'soft' : 'outline'"
+            size="sm"
+            @click="favoritesOnly = !favoritesOnly"
+          />
+
           <span class="ml-auto text-xs text-muted">
             {{ totalFiltered }} persona{{ totalFiltered !== 1 ? 's' : '' }}
           </span>
@@ -333,6 +351,16 @@ async function undoTrashIds(ids: string[]) {
               @click.stop
             />
           </template>
+          <template #favorite-cell="{ row }">
+            <UButton
+              icon="i-lucide-star"
+              :color="favs.isPersonaFavorite(row.original.id) ? 'warning' : 'neutral'"
+              :variant="favs.isPersonaFavorite(row.original.id) ? 'soft' : 'ghost'"
+              size="xs"
+              :aria-label="favs.isPersonaFavorite(row.original.id) ? 'Unfavorite' : 'Favorite'"
+              @click.stop="favs.toggle('personas', row.original.id)"
+            />
+          </template>
           <template #name-cell="{ row }">
             <span class="font-medium">{{ row.original.name }}</span>
           </template>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.14.0",
+  "version": "3.16.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.14.0"
+version = "3.16.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,20 @@ def persona_delete(persona_id: str):
     return {"error": "Persona not found"}
 
 
+# --- Favorites (PR86a v3.15.0) ---
+
+@app.get("/api/favorites")
+def favorites_list():
+    from core import favorites as _fav
+    return _fav.list_favorites()
+
+
+@app.post("/api/favorites/{kind}/{item_id}")
+def favorites_toggle(kind: str, item_id: str):
+    from core import favorites as _fav
+    return _fav.toggle(kind, item_id)
+
+
 # --- Global search (PR85d v3.14.0) ---
 
 @app.get("/api/search")