arkaos 3.27.0 → 3.28.0

package/VERSION

@@ -1 +1 @@
-3.27.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/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.27.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.27.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

@@ -1617,6 +1617,75 @@ def department_detail(dept_id: str):
 
 # --- 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."""