arkaos 3.57.0 → 3.59.0

package/VERSION

@@ -1 +1 @@
-3.57.0
+3.59.0

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

@@ -28,6 +28,26 @@ const deptActivity = computed<ActivityRow | null>(() =>
   (activityData.value?.by_department?.[agent.value?.department ?? ''] ?? null),
 )
 
+// PR96d v3.58.0 — 30d activity sparkline (calls per day).
+interface SparklineDay {
+  date: string
+  calls: number
+  cost_usd: number | null
+}
+const { data: sparklineData } = fetchApi<{
+  days: SparklineDay[]
+  period_days: number
+  department: string
+}>(`/api/agents/${agentId}/activity-sparkline?days=30`)
+const sparkline = computed<SparklineDay[]>(() => sparklineData.value?.days ?? [])
+const sparklineMaxCalls = computed(() => {
+  const max = sparkline.value.reduce((acc, d) => Math.max(acc, d.calls), 0)
+  return Math.max(max, 1)
+})
+const sparklineTotalCalls = computed(() =>
+  sparkline.value.reduce((acc, d) => acc + d.calls, 0),
+)
+
 // PR88d v3.26.0 — agent history (git log + trash entries)
 interface HistoryEvent {
   kind: string
@@ -558,6 +578,36 @@ function formatTokens(n: number): string {
               />
             </div>
           </div>
+          <!-- PR96d v3.58.0 — sparkline of daily calls -->
+          <div
+            v-if="sparkline.length > 0 && sparklineTotalCalls > 0"
+            class="mt-3 pt-3 border-t border-default/60"
+          >
+            <div class="flex items-center justify-between text-xs mb-1.5">
+              <span class="text-muted uppercase tracking-wide">Daily calls</span>
+              <span class="font-mono text-muted">
+                {{ sparklineTotalCalls }} total · max {{ sparklineMaxCalls }}/day
+              </span>
+            </div>
+            <svg
+              :viewBox="`0 0 ${sparkline.length * 6} 32`"
+              class="w-full h-8"
+              preserveAspectRatio="none"
+            >
+              <rect
+                v-for="(day, idx) in sparkline"
+                :key="day.date"
+                :x="idx * 6 + 1"
+                :y="32 - (day.calls / sparklineMaxCalls) * 30"
+                width="4"
+                :height="(day.calls / sparklineMaxCalls) * 30"
+                class="fill-primary"
+                :class="day.calls === 0 ? 'opacity-20' : 'opacity-90'"
+              >
+                <title>{{ day.date }} · {{ day.calls }} calls</title>
+              </rect>
+            </svg>
+          </div>
         </section>
 
         <!-- ===== BIO (PR86d) ===== -->

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

@@ -37,6 +37,25 @@ const { data, status, error, refresh } = await fetchApi<DeptDetail>(
   `/api/departments/${deptId.value}`,
 )
 
+// PR97a v3.59.0 — 30d activity sparkline for this department.
+interface SparklineDay {
+  date: string
+  calls: number
+  cost_usd: number | null
+}
+const { data: sparklineData } = fetchApi<{
+  days: SparklineDay[]
+  period_days: number
+  department: string
+}>(() => deptId.value ? `/api/departments/${deptId.value}/activity-sparkline?days=30` : '')
+const sparkline = computed<SparklineDay[]>(() => sparklineData.value?.days ?? [])
+const sparklineMaxCalls = computed(() =>
+  Math.max(1, sparkline.value.reduce((acc, d) => Math.max(acc, d.calls), 0)),
+)
+const sparklineTotalCalls = computed(() =>
+  sparkline.value.reduce((acc, d) => acc + d.calls, 0),
+)
+
 // PR90b v3.32.0 — Compare with another department.
 const { data: deptListData } = fetchApi<{ departments: Array<{ department: string }> }>(
   '/api/departments',
@@ -177,6 +196,39 @@ const tierColor = (tier: number | undefined) => {
         :on-retry="() => refresh()"
       >
         <div v-if="detail" class="space-y-5 max-w-5xl">
+          <!-- PR97a v3.59.0 — 30d sparkline -->
+          <section
+            v-if="sparklineTotalCalls > 0"
+            class="rounded-xl border border-default bg-elevated/10 p-5"
+          >
+            <div class="flex items-center justify-between text-xs mb-2">
+              <span class="font-semibold text-muted uppercase tracking-wide">
+                Daily calls (30d)
+              </span>
+              <span class="font-mono text-muted">
+                {{ sparklineTotalCalls }} total · max {{ sparklineMaxCalls }}/day
+              </span>
+            </div>
+            <svg
+              :viewBox="`0 0 ${sparkline.length * 8} 48`"
+              class="w-full h-12"
+              preserveAspectRatio="none"
+            >
+              <rect
+                v-for="(day, idx) in sparkline"
+                :key="day.date"
+                :x="idx * 8 + 1"
+                :y="48 - (day.calls / sparklineMaxCalls) * 46"
+                width="6"
+                :height="(day.calls / sparklineMaxCalls) * 46"
+                class="fill-primary"
+                :class="day.calls === 0 ? 'opacity-20' : 'opacity-90'"
+              >
+                <title>{{ day.date }} · {{ day.calls }} calls</title>
+              </rect>
+            </svg>
+          </section>
+
           <!-- 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">

package/package.json

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

package/scripts/dashboard-api.py

@@ -218,6 +218,82 @@ def agents_activity(period: str = "week"):
     return {"by_department": out, "period": period}
 
 
+@app.get("/api/agents/{agent_id}/activity-sparkline")
+def agent_activity_sparkline(agent_id: str, days: int = 30):
+    """PR96d v3.58.0 — daily call / cost series for the agent's department.
+
+    Returns ``{days: [{date, calls, cost_usd}]}`` seeded with zeros so
+    the frontend can render a clean N-day bar chart without gaps.
+    Capped at 90 days. Per-agent series falls back to dept series
+    (same convention as activity-strip / PR86b).
+    """
+    try:
+        days_int = int(days) if days is not None else 30
+    except (TypeError, ValueError):
+        days_int = 30
+    capped_days = max(1, min(days_int, 90))
+
+    agents = _load_agents()
+    base = next((a for a in agents if a.get("id") == agent_id), None)
+    if not base:
+        return {"error": "Agent not found"}
+    dept = base.get("department") or ""
+
+    try:
+        from core.runtime.llm_cost_telemetry import read_entries
+    except Exception:
+        return {"days": []}
+
+    from datetime import datetime, timedelta, timezone
+    today = datetime.now(timezone.utc).date()
+    buckets: dict[str, dict] = {}
+    for offset in range(capped_days):
+        d = today - timedelta(days=capped_days - 1 - offset)
+        buckets[d.isoformat()] = {
+            "date": d.isoformat(),
+            "calls": 0,
+            "cost_usd": 0.0,
+            "cost_known": False,
+        }
+    cutoff = today - timedelta(days=capped_days - 1)
+    agent_cat = f"subagent:{dept}:{agent_id}"
+    dept_cat = f"subagent:{dept}"
+    for entry in read_entries():
+        raw_ts = entry.get("ts") or ""
+        if not isinstance(raw_ts, str):
+            continue
+        try:
+            ts = datetime.fromisoformat(raw_ts.replace("Z", "+00:00"))
+        except ValueError:
+            continue
+        if ts.date() < cutoff:
+            continue
+        cat = str(entry.get("category") or "")
+        if cat != agent_cat and cat != dept_cat:
+            continue
+        key = ts.date().isoformat()
+        if key not in buckets:
+            continue
+        buckets[key]["calls"] += 1
+        cost = entry.get("estimated_cost_usd")
+        if isinstance(cost, (int, float)):
+            buckets[key]["cost_usd"] += float(cost)
+            buckets[key]["cost_known"] = True
+
+    out: list[dict] = []
+    for k in sorted(buckets.keys()):
+        bucket = buckets[k]
+        out.append({
+            "date": bucket["date"],
+            "calls": bucket["calls"],
+            "cost_usd": (
+                round(bucket["cost_usd"], 6)
+                if bucket["cost_known"] else None
+            ),
+        })
+    return {"days": out, "period_days": capped_days, "department": dept}
+
+
 @app.get("/api/agents/{agent_id}/activity-strip")
 def agent_activity_strip(agent_id: str, period: str = "month"):
     """PR83d v3.6.0 + PR86b v3.16.0 — compact activity payload.
@@ -1865,6 +1941,80 @@ def department_merge(src: str, dst: str):
     }
 
 
+@app.get("/api/departments/{dept_id}/activity-sparkline")
+def department_activity_sparkline(dept_id: str, days: int = 30):
+    """PR97a v3.59.0 — daily calls/cost series for a department.
+
+    Returns ``{days: [{date, calls, cost_usd}], period_days, department}``
+    pre-seeded with zeros so the SVG renders without gaps. Counts every
+    telemetry row with ``subagent:<dept>`` or ``subagent:<dept>:<agent>``
+    category. Capped at 90 days.
+    """
+    dept_id = dept_id.strip().lower()
+    try:
+        days_int = int(days) if days is not None else 30
+    except (TypeError, ValueError):
+        days_int = 30
+    capped_days = max(1, min(days_int, 90))
+
+    # Bail early if department has no agents — keep parity with detail endpoint.
+    if not any(a.get("department") == dept_id for a in _load_agents()):
+        return {"error": "Department not found or has no agents"}
+
+    try:
+        from core.runtime.llm_cost_telemetry import read_entries
+    except Exception:
+        return {"days": []}
+
+    from datetime import datetime, timedelta, timezone
+    today = datetime.now(timezone.utc).date()
+    buckets: dict[str, dict] = {}
+    for offset in range(capped_days):
+        d = today - timedelta(days=capped_days - 1 - offset)
+        buckets[d.isoformat()] = {
+            "date": d.isoformat(),
+            "calls": 0,
+            "cost_usd": 0.0,
+            "cost_known": False,
+        }
+    cutoff = today - timedelta(days=capped_days - 1)
+    prefix_dept = f"subagent:{dept_id}"
+    for entry in read_entries():
+        raw_ts = entry.get("ts") or ""
+        if not isinstance(raw_ts, str):
+            continue
+        try:
+            ts = datetime.fromisoformat(raw_ts.replace("Z", "+00:00"))
+        except ValueError:
+            continue
+        if ts.date() < cutoff:
+            continue
+        cat = str(entry.get("category") or "")
+        # subagent:<dept> OR subagent:<dept>:<agent>
+        if cat != prefix_dept and not cat.startswith(prefix_dept + ":"):
+            continue
+        key = ts.date().isoformat()
+        if key not in buckets:
+            continue
+        buckets[key]["calls"] += 1
+        cost = entry.get("estimated_cost_usd")
+        if isinstance(cost, (int, float)):
+            buckets[key]["cost_usd"] += float(cost)
+            buckets[key]["cost_known"] = True
+
+    out: list[dict] = []
+    for k in sorted(buckets.keys()):
+        bucket = buckets[k]
+        out.append({
+            "date": bucket["date"],
+            "calls": bucket["calls"],
+            "cost_usd": (
+                round(bucket["cost_usd"], 6) if bucket["cost_known"] else None
+            ),
+        })
+    return {"days": out, "period_days": capped_days, "department": dept_id}
+
+
 @app.get("/api/departments/{dept_id}")
 def department_detail(dept_id: str):
     """Full department detail: agents, workflows, 30d cost."""