arkaos 3.36.0 → 3.38.0

package/VERSION

@@ -1 +1 @@
-3.36.0
+3.38.0

package/dashboard/app/pages/budget.vue

@@ -53,7 +53,8 @@ interface TrendResponse {
 
 type Period = 'today' | 'week' | 'month' | 'all'
 
-const { fetchApi } = useApi()
+const { fetchApi, apiBase } = useApi()
+const toast = useToast()
 const period = ref<Period>('today')
 
 const periodOptions: { label: string; value: Period }[] = [
@@ -73,6 +74,36 @@ const {
   { query: computed(() => ({ period: period.value })) },
 )
 
+// PR91d v3.38.0 — CSV export of the telemetry rows for the current period.
+async function exportCsv() {
+  try {
+    const blob = await $fetch<Blob>(
+      `${apiBase}/api/llm-costs/export.csv`,
+      { query: { period: period.value }, responseType: 'blob' },
+    )
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = `arkaos-costs-${period.value}.csv`
+    document.body.appendChild(a)
+    a.click()
+    a.remove()
+    URL.revokeObjectURL(url)
+    toast.add({
+      title: 'CSV downloaded',
+      description: `arkaos-costs-${period.value}.csv`,
+      color: 'success',
+      icon: 'i-lucide-download',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Export failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  }
+}
+
 // PR90c v3.33.0 — let the operator pick 7d / 14d / 30d.
 const trendDays = ref<7 | 14 | 30>(7)
 const trendDaysOptions = [
@@ -204,6 +235,14 @@ async function refreshAll() {
             size="sm"
             class="w-32"
           />
+          <UButton
+            label="Export CSV"
+            icon="i-lucide-download"
+            variant="soft"
+            size="sm"
+            class="ml-2"
+            @click="exportCsv"
+          />
           <UButton
             label="Refresh"
             variant="ghost"

package/dashboard/app/pages/workflows.vue

@@ -7,6 +7,14 @@
 
 import type { TableColumn } from '@nuxt/ui'
 
+interface WorkflowPhase {
+  id: string
+  name: string
+  description: string
+  gate_type: string
+  agent_count: number
+}
+
 interface Workflow {
   id: string
   name: string
@@ -15,6 +23,7 @@ interface Workflow {
   tier: string
   command: string
   phases_count: number
+  phases: WorkflowPhase[]
   file: string
   content: string
 }
@@ -35,7 +44,16 @@ interface WorkflowRun {
 }
 const runs = ref<WorkflowRun[]>([])
 const runsLoading = ref(false)
-const sidePanelTab = ref<'yaml' | 'runs'>('yaml')
+const sidePanelTab = ref<'flow' | 'yaml' | 'runs'>('flow')
+
+function gateColor(gateType: string): 'primary' | 'warning' | 'error' | 'neutral' {
+  const m: Record<string, 'primary' | 'warning' | 'error' | 'neutral'> = {
+    user_approval: 'warning',
+    quality_gate: 'error',
+    automatic: 'primary',
+  }
+  return m[gateType] ?? 'neutral'
+}
 
 async function loadRuns(id: string) {
   runsLoading.value = true
@@ -152,7 +170,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; sidePanelTab = 'yaml'; runs = []; loadRuns(row.original.id) }"
+            @select="(row: { original: Workflow }) => { selected = row.original; sidePanelTab = 'flow'; runs = []; loadRuns(row.original.id) }"
           >
             <template #name-cell="{ row }">
               <div class="min-w-0">
@@ -205,6 +223,14 @@ const columns: TableColumn<Workflow>[] = [
                 {{ 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 === 'flow' ? 'bg-elevated/60 text-default font-semibold' : 'text-muted hover:text-default'"
+                  @click="sidePanelTab = 'flow'"
+                >
+                  Flow
+                </button>
                 <button
                   type="button"
                   class="px-2 py-1 rounded-md transition-colors"
@@ -223,7 +249,43 @@ const columns: TableColumn<Workflow>[] = [
                 </button>
               </div>
             </div>
-            <div v-if="sidePanelTab === 'yaml'" class="overflow-x-auto">
+            <div v-if="sidePanelTab === 'flow'" class="p-4">
+              <ol v-if="selected.phases.length > 0" class="relative border-l border-default ml-2 space-y-3">
+                <li
+                  v-for="(ph, idx) in selected.phases"
+                  :key="ph.id || idx"
+                  class="ml-4"
+                >
+                  <span class="absolute -left-1.5 size-3 rounded-full bg-primary border border-primary/60" />
+                  <div class="rounded-lg border border-default p-3 bg-elevated/20">
+                    <div class="flex items-center gap-2 flex-wrap">
+                      <span class="font-mono text-xs text-muted">{{ idx + 1 }}.</span>
+                      <span class="font-semibold">{{ ph.name || ph.id }}</span>
+                      <UBadge
+                        v-if="ph.gate_type"
+                        :label="ph.gate_type"
+                        :color="gateColor(ph.gate_type)"
+                        variant="subtle"
+                        size="xs"
+                      />
+                      <UBadge
+                        v-if="ph.agent_count > 0"
+                        :label="`${ph.agent_count} agent${ph.agent_count === 1 ? '' : 's'}`"
+                        variant="outline"
+                        size="xs"
+                      />
+                    </div>
+                    <p v-if="ph.description" class="text-xs text-muted mt-1">
+                      {{ ph.description }}
+                    </p>
+                  </div>
+                </li>
+              </ol>
+              <div v-else class="py-6 text-center text-sm text-muted">
+                No phases defined.
+              </div>
+            </div>
+            <div v-else-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">

package/package.json

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

package/scripts/dashboard-api.py

@@ -1848,12 +1848,33 @@ def workflows_list():
             "tier": str(raw.get("tier") or ""),
             "command": str(raw.get("command") or ""),
             "phases_count": len(phases),
+            "phases": _summarise_phases(phases),  # PR91c v3.37.0
             "file": rel,
             "content": content,
         })
     return {"workflows": out}
 
 
+def _summarise_phases(phases: list) -> list[dict]:
+    """PR91c v3.37.0 — distil each phase down to what the flow stepper needs."""
+    out: list[dict] = []
+    for p in phases:
+        if not isinstance(p, dict):
+            continue
+        gate = p.get("gate") if isinstance(p.get("gate"), dict) else {}
+        agents = p.get("agents") if isinstance(p.get("agents"), list) else []
+        out.append({
+            "id": str(p.get("id") or ""),
+            "name": str(p.get("name") or ""),
+            "description": str(p.get("description") or ""),
+            "gate_type": str(gate.get("type") or ""),
+            "agent_count": sum(
+                1 for a in agents if isinstance(a, dict) and a.get("agent_id")
+            ),
+        })
+    return out
+
+
 # --- Sidebar stats widget (PR87d v3.22.0) ---
 
 @app.get("/api/sidebar-stats")
@@ -2489,6 +2510,56 @@ def llm_costs(period: str = "today"):
     }
 
 
+@app.get("/api/llm-costs/export.csv")
+def llm_costs_export(period: str = "month"):
+    """PR91d v3.38.0 — stream the telemetry rows for the period as CSV.
+
+    Returns ``text/csv`` with a header row + every row in the selected
+    period. Period values match `summarise()`: today / week / month / all.
+    """
+    try:
+        from core.runtime.llm_cost_telemetry import (
+            VALID_PERIODS,
+            _load_slice,
+            _period_cutoff,
+        )
+    except Exception:
+        return {"error": "telemetry unavailable"}
+    if period not in VALID_PERIODS:
+        period = "month"
+
+    entries, _ = _load_slice(None, _period_cutoff(period, now=None))
+    import csv
+    import io
+    buffer = io.StringIO()
+    writer = csv.writer(buffer)
+    writer.writerow([
+        "ts", "session_id", "provider", "model", "category",
+        "tokens_in", "tokens_out", "cached_tokens", "estimated_cost_usd",
+    ])
+    for entry in entries:
+        writer.writerow([
+            entry.get("ts", ""),
+            entry.get("session_id", ""),
+            entry.get("provider", ""),
+            entry.get("model", ""),
+            entry.get("category", ""),
+            entry.get("tokens_in", ""),
+            entry.get("tokens_out", ""),
+            entry.get("cached_tokens", ""),
+            entry.get("estimated_cost_usd", ""),
+        ])
+    filename = f"arkaos-costs-{period}.csv"
+    from fastapi import Response
+    return Response(
+        content=buffer.getvalue(),
+        media_type="text/csv",
+        headers={
+            "Content-Disposition": f'attachment; filename="{filename}"',
+        },
+    )
+
+
 @app.get("/api/llm-costs/trend")
 def llm_costs_trend(days: int = 7):
     """Day-by-day rolling totals from the cost telemetry.