arkaos 3.26.0 → 3.28.0

package/VERSION

@@ -1 +1 @@
-3.26.0
+3.28.0

package/core/runtime/llm_provider.py

@@ -368,6 +368,7 @@ def _current_category() -> str:
     PR60 v2.77.0 — orchestration layers can set
     ``ARKA_CALL_CATEGORY=skill:<slug>`` /
     ``subagent:<dept>`` or ``subagent:<dept>:<agent_id>`` /
+    ``workflow:<workflow_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

package/dashboard/app/layouts/default.vue

@@ -20,6 +20,13 @@ const links = [[{
   onSelect: () => {
     open.value = false
   }
+}, {
+  label: 'Departments',
+  icon: 'i-lucide-folder-tree',
+  to: '/departments',
+  onSelect: () => {
+    open.value = false
+  }
 }, {
   label: 'Personas',
   icon: 'i-lucide-user-plus',

package/dashboard/app/pages/departments/[dept].vue

@@ -0,0 +1,158 @@
+<script setup lang="ts">
+// PR89a v3.27.0 — Department detail page.
+//
+// Shows agents in the department + its workflows + 30d cost.
+
+const route = useRoute()
+const deptId = computed(() => String(route.params.dept ?? ''))
+const { fetchApi } = useApi()
+
+interface AgentLite {
+  id: string
+  name?: string
+  role?: string
+  tier?: number
+  mbti?: string
+  disc?: { primary?: string, secondary?: string }
+}
+
+interface WorkflowLite {
+  id: string
+  name: string
+  tier: string
+  command: string
+  phases_count: number
+}
+
+interface DeptDetail {
+  department: string
+  agents: AgentLite[]
+  workflows: WorkflowLite[]
+  calls_30d: number
+  cost_usd_30d: number | null
+  error?: string
+}
+
+const { data, status, error, refresh } = await fetchApi<DeptDetail>(
+  `/api/departments/${deptId.value}`,
+)
+
+const errorMsg = computed(() => data.value?.error || error.value?.message || null)
+const detail = computed<DeptDetail | null>(() => {
+  if (!data.value || data.value.error) return null
+  return data.value
+})
+
+function formatCost(cost: number | null): string {
+  if (cost === null || cost === undefined) return '—'
+  if (cost < 0.01) return '<$0.01'
+  if (cost < 1) return `$${cost.toFixed(3)}`
+  return `$${cost.toFixed(2)}`
+}
+
+const tierColor = (tier: number | undefined) => {
+  const colors: Record<number, 'error' | 'warning' | 'primary' | 'neutral'> = {
+    0: 'error', 1: 'warning', 2: 'primary', 3: 'neutral',
+  }
+  return colors[tier ?? 99] ?? 'neutral'
+}
+</script>
+
+<template>
+  <UDashboardPanel :id="`dept-${deptId}`">
+    <template #header>
+      <UDashboardNavbar :title="`Department · ${deptId}`">
+        <template #leading>
+          <UButton icon="i-lucide-arrow-left" variant="ghost" size="sm" to="/departments" aria-label="Back" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <DashboardState
+        :status="status"
+        :error="errorMsg ? new Error(errorMsg) : null"
+        :empty="!detail"
+        empty-title="Department not found"
+        empty-icon="i-lucide-folder-x"
+        loading-label="Loading department"
+        :on-retry="() => refresh()"
+      >
+        <div v-if="detail" class="space-y-5 max-w-5xl">
+          <!-- Stats row -->
+          <section class="grid grid-cols-2 md:grid-cols-4 gap-3">
+            <div class="rounded-xl border border-default p-4 bg-elevated/20">
+              <p class="text-sm font-semibold text-muted uppercase tracking-wide mb-1">Agents</p>
+              <p class="text-2xl font-bold">{{ detail.agents.length }}</p>
+            </div>
+            <div class="rounded-xl border border-default p-4 bg-elevated/20">
+              <p class="text-sm font-semibold text-muted uppercase tracking-wide mb-1">Workflows</p>
+              <p class="text-2xl font-bold">{{ detail.workflows.length }}</p>
+            </div>
+            <div class="rounded-xl border border-default p-4 bg-elevated/20">
+              <p class="text-sm font-semibold text-muted uppercase tracking-wide mb-1">Calls (30d)</p>
+              <p class="text-2xl font-bold">{{ detail.calls_30d }}</p>
+            </div>
+            <div class="rounded-xl border border-default p-4 bg-elevated/20">
+              <p class="text-sm font-semibold text-muted uppercase tracking-wide mb-1">Cost (30d)</p>
+              <p class="text-2xl font-bold">{{ formatCost(detail.cost_usd_30d) }}</p>
+            </div>
+          </section>
+
+          <!-- Agents -->
+          <section>
+            <h2 class="text-sm font-semibold uppercase tracking-wide text-muted mb-3">Agents</h2>
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-2">
+              <NuxtLink
+                v-for="a in detail.agents"
+                :key="a.id"
+                :to="`/agents/${a.id}`"
+                class="block rounded-lg border border-default p-3 hover:border-primary/40 transition-colors"
+              >
+                <div class="flex items-center justify-between gap-3">
+                  <div class="min-w-0">
+                    <p class="font-semibold truncate">{{ a.name }}</p>
+                    <p class="text-xs text-muted truncate">{{ a.role || '—' }}</p>
+                  </div>
+                  <div class="flex items-center gap-2 shrink-0">
+                    <UBadge
+                      :label="`T${a.tier}`"
+                      :color="tierColor(a.tier)"
+                      variant="subtle"
+                      size="xs"
+                    />
+                    <UBadge v-if="a.mbti" :label="a.mbti" variant="soft" size="xs" />
+                  </div>
+                </div>
+              </NuxtLink>
+            </div>
+          </section>
+
+          <!-- Workflows -->
+          <section v-if="detail.workflows.length > 0">
+            <h2 class="text-sm font-semibold uppercase tracking-wide text-muted mb-3">Workflows</h2>
+            <div class="space-y-2">
+              <NuxtLink
+                v-for="w in detail.workflows"
+                :key="w.id"
+                to="/workflows"
+                class="block rounded-lg border border-default p-3 hover:border-primary/40 transition-colors"
+              >
+                <div class="flex items-center justify-between gap-3">
+                  <div class="min-w-0">
+                    <p class="font-semibold truncate">{{ w.name }}</p>
+                    <p class="text-xs text-muted font-mono truncate">{{ w.command || w.id }}</p>
+                  </div>
+                  <div class="flex items-center gap-2 shrink-0 text-xs">
+                    <UBadge v-if="w.tier" :label="w.tier" variant="subtle" size="xs" />
+                    <span class="text-muted">{{ w.phases_count }} phase{{ w.phases_count === 1 ? '' : 's' }}</span>
+                  </div>
+                </div>
+              </NuxtLink>
+            </div>
+          </section>
+        </div>
+      </DashboardState>
+    </template>
+  </UDashboardPanel>
+</template>

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

@@ -0,0 +1,127 @@
+<script setup lang="ts">
+// PR89a v3.27.0 — Departments index.
+//
+// Lists every department with agent count, tier distribution, and 30d
+// cost. Click a row to drill into /departments/{dept}.
+
+import type { TableColumn } from '@nuxt/ui'
+
+interface DeptRow {
+  department: string
+  agent_count: number
+  tier_counts: Record<'0' | '1' | '2' | '3', number>
+  calls_30d: number
+  cost_usd_30d: number | null
+}
+
+const { fetchApi } = useApi()
+const { data, status, error, refresh } = await fetchApi<{
+  departments: DeptRow[]
+  total: number
+}>('/api/departments')
+
+const rows = computed<DeptRow[]>(() => data.value?.departments ?? [])
+const search = ref('')
+const filtered = computed(() => {
+  const q = search.value.toLowerCase().trim()
+  if (!q) return rows.value
+  return rows.value.filter((r) => r.department.toLowerCase().includes(q))
+})
+
+const columns: TableColumn<DeptRow>[] = [
+  { accessorKey: 'department', header: 'Department' },
+  { accessorKey: 'agent_count', header: 'Agents' },
+  { id: 'tiers', header: 'Tiers (0/1/2/3)' },
+  { accessorKey: 'calls_30d', header: 'Calls (30d)' },
+  { accessorKey: 'cost_usd_30d', header: 'Cost (30d)' },
+  { id: 'actions', header: '' },
+]
+
+function formatCost(cost: number | null): string {
+  if (cost === null || cost === undefined) return '—'
+  if (cost < 0.01) return '<$0.01'
+  if (cost < 1) return `$${cost.toFixed(3)}`
+  return `$${cost.toFixed(2)}`
+}
+</script>
+
+<template>
+  <UDashboardPanel id="departments">
+    <template #header>
+      <UDashboardNavbar title="Departments">
+        <template #leading>
+          <UDashboardSidebarCollapse />
+        </template>
+        <template #trailing>
+          <UBadge v-if="data?.total" :label="String(data.total)" variant="subtle" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <DashboardState
+        :status="status"
+        :error="error"
+        :empty="!rows.length"
+        empty-title="No departments yet"
+        empty-icon="i-lucide-folder-tree"
+        loading-label="Loading departments"
+        :on-retry="() => refresh()"
+      >
+        <div class="flex items-center gap-3 mb-4">
+          <UInput
+            v-model="search"
+            class="max-w-sm"
+            icon="i-lucide-search"
+            placeholder="Filter departments…"
+          />
+          <span class="ml-auto text-xs text-muted">
+            {{ filtered.length }} dept{{ filtered.length === 1 ? '' : 's' }}
+          </span>
+        </div>
+
+        <UTable
+          :data="filtered"
+          :columns="columns"
+          :loading="status === 'pending'"
+          :ui="{
+            tbody: '[&>tr]:cursor-pointer [&>tr]:hover:bg-elevated/50 [&>tr]:transition-colors',
+            th: 'py-2 first:rounded-l-lg last:rounded-r-lg border-y border-default first:border-l last:border-r',
+            td: 'border-b border-default',
+          }"
+          @select="(row: { original: DeptRow }) => navigateTo(`/departments/${row.original.department}`)"
+        >
+          <template #department-cell="{ row }">
+            <span class="font-semibold capitalize">{{ row.original.department }}</span>
+          </template>
+          <template #agent_count-cell="{ row }">
+            <span class="font-mono font-semibold">{{ row.original.agent_count }}</span>
+          </template>
+          <template #tiers-cell="{ row }">
+            <div class="flex items-center gap-1 text-xs font-mono">
+              <UBadge v-if="row.original.tier_counts['0'] > 0" :label="`0:${row.original.tier_counts['0']}`" color="error" variant="subtle" size="xs" />
+              <UBadge v-if="row.original.tier_counts['1'] > 0" :label="`1:${row.original.tier_counts['1']}`" color="warning" variant="subtle" size="xs" />
+              <UBadge v-if="row.original.tier_counts['2'] > 0" :label="`2:${row.original.tier_counts['2']}`" color="primary" variant="subtle" size="xs" />
+              <UBadge v-if="row.original.tier_counts['3'] > 0" :label="`3:${row.original.tier_counts['3']}`" color="neutral" variant="subtle" size="xs" />
+            </div>
+          </template>
+          <template #calls_30d-cell="{ row }">
+            <span class="font-mono text-sm">{{ row.original.calls_30d }}</span>
+          </template>
+          <template #cost_usd_30d-cell="{ row }">
+            <span class="font-mono text-sm font-semibold">{{ formatCost(row.original.cost_usd_30d) }}</span>
+          </template>
+          <template #actions-cell="{ row }">
+            <UButton
+              icon="i-lucide-arrow-right"
+              variant="ghost"
+              size="xs"
+              aria-label="Open department"
+              @click.stop="navigateTo(`/departments/${row.original.department}`)"
+            />
+          </template>
+        </UTable>
+      </DashboardState>
+    </template>
+  </UDashboardPanel>
+</template>

package/dashboard/app/pages/workflows.vue

@@ -19,9 +19,38 @@ interface Workflow {
   content: string
 }
 
-const { fetchApi } = useApi()
+const { fetchApi, apiBase } = useApi()
 const { data, status, error, refresh } = await fetchApi<{ workflows: Workflow[] }>('/api/workflows')
 
+// PR89b v3.28.0 — recent runs for the selected workflow.
+interface WorkflowRun {
+  session_id: string
+  started_at: string
+  ended_at: string
+  duration_s: number | null
+  calls: number
+  cost_usd: number | null
+  tokens_in: number
+  tokens_out: number
+}
+const runs = ref<WorkflowRun[]>([])
+const runsLoading = ref(false)
+const sidePanelTab = ref<'yaml' | 'runs'>('yaml')
+
+async function loadRuns(id: string) {
+  runsLoading.value = true
+  try {
+    const res = await $fetch<{ runs: WorkflowRun[] }>(
+      `${apiBase}/api/workflows/${id}/runs?limit=10`,
+    )
+    runs.value = res.runs ?? []
+  } catch {
+    runs.value = []
+  } finally {
+    runsLoading.value = false
+  }
+}
+
 const workflows = computed(() => data.value?.workflows ?? [])
 const search = ref('')
 const deptFilter = ref<'all' | string>('all')
@@ -123,7 +152,7 @@ const columns: TableColumn<Workflow>[] = [
               th: 'py-2 first:rounded-l-lg last:rounded-r-lg border-y border-default first:border-l last:border-r',
               td: 'border-b border-default',
             }"
-            @select="(row: { original: Workflow }) => selected = row.original"
+            @select="(row: { original: Workflow }) => { selected = row.original; sidePanelTab = 'yaml'; runs = []; loadRuns(row.original.id) }"
           >
             <template #name-cell="{ row }">
               <div class="min-w-0">
@@ -160,7 +189,7 @@ const columns: TableColumn<Workflow>[] = [
             <div class="px-4 py-3 border-b border-default bg-elevated/30">
               <div class="flex items-start justify-between gap-3">
                 <div class="min-w-0">
-                  <p class="text-xs text-muted uppercase tracking-wide">YAML preview</p>
+                  <p class="text-xs text-muted uppercase tracking-wide">Workflow</p>
                   <p class="font-semibold truncate">{{ selected.name }}</p>
                   <p class="text-xs text-muted font-mono truncate">{{ selected.file }}</p>
                 </div>
@@ -175,8 +204,67 @@ const columns: TableColumn<Workflow>[] = [
               <p v-if="selected.description" class="text-xs text-muted mt-2">
                 {{ selected.description }}
               </p>
+              <div class="flex items-center gap-1 mt-3 text-xs">
+                <button
+                  type="button"
+                  class="px-2 py-1 rounded-md transition-colors"
+                  :class="sidePanelTab === 'yaml' ? 'bg-elevated/60 text-default font-semibold' : 'text-muted hover:text-default'"
+                  @click="sidePanelTab = 'yaml'"
+                >
+                  YAML
+                </button>
+                <button
+                  type="button"
+                  class="px-2 py-1 rounded-md transition-colors"
+                  :class="sidePanelTab === 'runs' ? 'bg-elevated/60 text-default font-semibold' : 'text-muted hover:text-default'"
+                  @click="sidePanelTab = 'runs'"
+                >
+                  Runs
+                </button>
+              </div>
+            </div>
+            <div v-if="sidePanelTab === 'yaml'" class="overflow-x-auto">
+              <pre class="p-4 text-xs font-mono whitespace-pre">{{ selected.content }}</pre>
+            </div>
+            <div v-else class="p-4">
+              <div v-if="runsLoading" class="py-6 text-center text-sm text-muted">
+                <UIcon name="i-lucide-loader-2" class="size-4 animate-spin inline" /> Loading…
+              </div>
+              <div v-else-if="!runs.length" class="py-6 text-center text-sm text-muted">
+                <UIcon name="i-lucide-history" class="size-6 mx-auto mb-2" />
+                No recorded runs yet. Set
+                <code class="font-mono text-xs">ARKA_CALL_CATEGORY=workflow:{{ selected.id }}</code>
+                in the orchestrator to populate this.
+              </div>
+              <ul v-else class="space-y-2">
+                <li
+                  v-for="r in runs"
+                  :key="r.session_id"
+                  class="rounded-lg border border-default p-3"
+                >
+                  <div class="flex items-center justify-between gap-3 text-xs">
+                    <span class="font-mono text-muted truncate">{{ r.session_id }}</span>
+                    <span class="text-muted shrink-0">{{ r.started_at }}</span>
+                  </div>
+                  <div class="flex items-center gap-3 text-xs mt-2">
+                    <span>
+                      <span class="text-muted">Calls</span>
+                      <span class="font-mono font-semibold ml-1">{{ r.calls }}</span>
+                    </span>
+                    <span>
+                      <span class="text-muted">Cost</span>
+                      <span class="font-mono font-semibold ml-1">
+                        {{ r.cost_usd === null ? '—' : `$${r.cost_usd.toFixed(3)}` }}
+                      </span>
+                    </span>
+                    <span v-if="r.duration_s !== null">
+                      <span class="text-muted">Duration</span>
+                      <span class="font-mono font-semibold ml-1">{{ r.duration_s }}s</span>
+                    </span>
+                  </div>
+                </li>
+              </ul>
             </div>
-            <pre class="p-4 text-xs font-mono overflow-x-auto whitespace-pre">{{ selected.content }}</pre>
           </div>
           <div
             v-else

package/package.json

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

package/scripts/dashboard-api.py

@@ -1494,8 +1494,198 @@ def agent_export_to_vault(agent_id: str):
     return {"exported": True, "path": str(res.path), "vault_path": str(res.vault_path)}
 
 
+# --- Departments (PR89a v3.27.0) ---
+
+@app.get("/api/departments")
+def departments_list():
+    """List every department with agent count + 30d cost summary."""
+    agents = _load_agents()
+    by_dept: dict[str, dict] = {}
+    for a in agents:
+        dept = a.get("department") or ""
+        if not dept:
+            continue
+        row = by_dept.setdefault(dept, {
+            "department": dept,
+            "agent_count": 0,
+            "tier_counts": {"0": 0, "1": 0, "2": 0, "3": 0},
+        })
+        row["agent_count"] += 1
+        tier_key = str(a.get("tier") or "")
+        if tier_key in row["tier_counts"]:
+            row["tier_counts"][tier_key] += 1
+    cost_map: dict[str, dict] = {}
+    try:
+        from core.runtime.llm_cost_telemetry import summarise
+        s = summarise(period="month")
+        for category, row in (s.by_category or {}).items():
+            if not isinstance(category, str) or not category.startswith("subagent:"):
+                continue
+            parts = category.split(":", 2)
+            dept = parts[1] if len(parts) >= 2 else "unknown"
+            bucket = cost_map.setdefault(dept, {
+                "calls_30d": 0,
+                "cost_usd_30d": 0.0,
+                "any_cost_known": False,
+            })
+            bucket["calls_30d"] += int(row.get("call_count", 0))
+            cost = row.get("total_cost_usd")
+            if isinstance(cost, (int, float)):
+                bucket["cost_usd_30d"] += float(cost)
+                bucket["any_cost_known"] = True
+    except Exception:  # noqa: BLE001
+        pass
+    out: list[dict] = []
+    for dept in sorted(by_dept.keys()):
+        row = by_dept[dept]
+        cost = cost_map.get(dept, {})
+        row["calls_30d"] = cost.get("calls_30d", 0)
+        row["cost_usd_30d"] = (
+            round(cost.get("cost_usd_30d", 0.0), 6)
+            if cost.get("any_cost_known") else None
+        )
+        out.append(row)
+    return {"departments": out, "total": len(out)}
+
+
+@app.get("/api/departments/{dept_id}")
+def department_detail(dept_id: str):
+    """Full department detail: agents, workflows, 30d cost."""
+    dept_id = dept_id.strip().lower()
+    agents = [a for a in _load_agents() if a.get("department") == dept_id]
+    if not agents:
+        return {"error": "Department not found or has no agents"}
+    workflows: list[dict] = []
+    try:
+        import yaml as _yaml
+        wf_dir = ARKAOS_ROOT / "departments" / dept_id / "workflows"
+        if wf_dir.exists():
+            for path in sorted(wf_dir.glob("*.yaml")):
+                try:
+                    raw = _yaml.safe_load(path.read_text(encoding="utf-8")) or {}
+                except Exception:  # noqa: BLE001
+                    raw = {}
+                if not isinstance(raw, dict):
+                    continue
+                workflows.append({
+                    "id": str(raw.get("id") or path.stem),
+                    "name": str(raw.get("name") or path.stem),
+                    "tier": str(raw.get("tier") or ""),
+                    "command": str(raw.get("command") or ""),
+                    "phases_count": len(raw.get("phases") or []),
+                })
+    except ImportError:
+        pass
+    calls_30d = 0
+    cost_usd_30d: Optional[float] = None
+    try:
+        from core.runtime.llm_cost_telemetry import summarise
+        s = summarise(period="month")
+        total_cost = 0.0
+        any_known = False
+        for category, row in (s.by_category or {}).items():
+            if not isinstance(category, str) or not category.startswith("subagent:"):
+                continue
+            parts = category.split(":", 2)
+            if len(parts) >= 2 and parts[1] == dept_id:
+                calls_30d += int(row.get("call_count", 0))
+                cost = row.get("total_cost_usd")
+                if isinstance(cost, (int, float)):
+                    total_cost += float(cost)
+                    any_known = True
+        cost_usd_30d = round(total_cost, 6) if any_known else None
+    except Exception:  # noqa: BLE001
+        pass
+    return {
+        "department": dept_id,
+        "agents": [
+            {
+                "id": a.get("id"),
+                "name": a.get("name"),
+                "role": a.get("role"),
+                "tier": a.get("tier"),
+                "mbti": a.get("mbti"),
+                "disc": a.get("disc"),
+            }
+            for a in agents
+        ],
+        "workflows": workflows,
+        "calls_30d": calls_30d,
+        "cost_usd_30d": cost_usd_30d,
+    }
+
+
 # --- Workflows (PR88b v3.24.0) ---
 
+@app.get("/api/workflows/{workflow_id}/runs")
+def workflow_runs(workflow_id: str, limit: int = 20):
+    """PR89b v3.28.0 — list recent runs of a workflow.
+
+    Parses the PR47 cost telemetry JSONL for rows tagged
+    ``workflow:<workflow_id>`` and groups them by ``session_id``.
+    Returns ``{runs: [{session_id, started_at, ended_at, duration_s,
+    calls, cost_usd, tokens_in, tokens_out}]}`` sorted desc by start.
+
+    Workflows must set ``ARKA_CALL_CATEGORY=workflow:<id>`` before
+    each call for this to populate. Returns an empty list when no
+    matching entries exist (the common case until orchestrators opt in).
+    """
+    target_category = f"workflow:{workflow_id}"
+    try:
+        from core.runtime.llm_cost_telemetry import _load_slice
+    except Exception:
+        return {"runs": []}
+    entries, _ = _load_slice(None, None)
+    sessions: dict[str, dict] = {}
+    for entry in entries:
+        if entry.get("category") != target_category:
+            continue
+        sid = str(entry.get("session_id") or "")
+        if not sid:
+            continue
+        ts = entry.get("ts") or ""
+        bucket = sessions.setdefault(sid, {
+            "session_id": sid,
+            "started_at": ts,
+            "ended_at": ts,
+            "calls": 0,
+            "cost_usd": 0.0,
+            "any_cost_known": False,
+            "tokens_in": 0,
+            "tokens_out": 0,
+        })
+        bucket["calls"] += 1
+        if ts and ts < bucket["started_at"]:
+            bucket["started_at"] = ts
+        if ts and ts > bucket["ended_at"]:
+            bucket["ended_at"] = ts
+        bucket["tokens_in"] += int(entry.get("tokens_in") or 0)
+        bucket["tokens_out"] += int(entry.get("tokens_out") or 0)
+        cost = entry.get("estimated_cost_usd")
+        if isinstance(cost, (int, float)):
+            bucket["cost_usd"] += float(cost)
+            bucket["any_cost_known"] = True
+
+    runs = list(sessions.values())
+    for r in runs:
+        r["cost_usd"] = round(r["cost_usd"], 6) if r.pop("any_cost_known") else None
+        r["duration_s"] = _iso_duration_s(r["started_at"], r["ended_at"])
+    runs.sort(key=lambda r: str(r.get("started_at") or ""), reverse=True)
+    return {"runs": runs[: max(0, int(limit))]}
+
+
+def _iso_duration_s(start_iso: str, end_iso: str) -> Optional[int]:
+    if not start_iso or not end_iso:
+        return None
+    try:
+        from datetime import datetime
+        start = datetime.fromisoformat(start_iso.replace("Z", "+00:00"))
+        end = datetime.fromisoformat(end_iso.replace("Z", "+00:00"))
+        return max(0, int((end - start).total_seconds()))
+    except (ValueError, TypeError):
+        return None
+
+
 @app.get("/api/workflows")
 def workflows_list():
     """Scan departments/*/workflows/*.yaml and return metadata + content."""