arkaos 3.27.0 → 3.29.0

package/VERSION

@@ -1 +1 @@
-3.27.0
+3.29.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/settings.vue

@@ -50,6 +50,45 @@ watch(profile, (p) => {
 
 const savingProfile = ref(false)
 
+// PR89c v3.29.0 — vault connection test.
+interface VaultStatus {
+  configured: boolean
+  vault_path: string
+  exists: boolean
+  personas: { dir: string, count: number }
+  agents: { dir: string, count: number }
+}
+const vaultStatus = ref<VaultStatus | null>(null)
+const testingVault = ref(false)
+
+async function testVault() {
+  testingVault.value = true
+  try {
+    // Save first so the backend reads the current value
+    if (profileDraft.value.vaultPath !== profile.value?.vaultPath) {
+      await $fetch(`${apiBase}/api/profile`, {
+        method: 'POST',
+        body: { vaultPath: profileDraft.value.vaultPath },
+      })
+    }
+    vaultStatus.value = await $fetch<VaultStatus>(`${apiBase}/api/settings/vault`)
+    toast.add({
+      title: vaultStatus.value.exists ? 'Vault reachable' : 'Vault not found',
+      description: vaultStatus.value.vault_path || 'Set a path first',
+      color: vaultStatus.value.exists ? 'success' : 'warning',
+      icon: vaultStatus.value.exists ? 'i-lucide-check-circle' : 'i-lucide-alert-circle',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Test failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    testingVault.value = false
+  }
+}
+
 async function saveProfile() {
   savingProfile.value = true
   try {
@@ -326,8 +365,18 @@ const activeSection = ref<SectionId>('profile')
 
                   <UFormField
                     label="Vault path"
-                    help="Where your Obsidian vault lives. Used by the KB-first hook."
+                    help="Where your Obsidian vault lives. Used by the KB-first hook + Persona/Agent exporters."
                   >
+                    <template #hint>
+                      <UButton
+                        label="Test connection"
+                        icon="i-lucide-plug-zap"
+                        size="xs"
+                        variant="soft"
+                        :loading="testingVault"
+                        @click="testVault"
+                      />
+                    </template>
                     <UInput
                       v-model="profileDraft.vaultPath"
                       placeholder="/Users/you/Documents/Vault"
@@ -335,6 +384,50 @@ const activeSection = ref<SectionId>('profile')
                     />
                   </UFormField>
 
+                  <!-- PR89c v3.29.0 — vault connection test result -->
+                  <div
+                    v-if="vaultStatus"
+                    class="rounded-lg border p-3 text-xs space-y-1"
+                    :class="
+                      vaultStatus.exists
+                        ? 'border-emerald-500/40 bg-emerald-500/5'
+                        : 'border-yellow-500/40 bg-yellow-500/5'
+                    "
+                  >
+                    <div class="flex items-center gap-2 font-semibold">
+                      <UIcon
+                        :name="vaultStatus.exists ? 'i-lucide-check-circle' : 'i-lucide-alert-circle'"
+                        :class="vaultStatus.exists ? 'text-emerald-500 size-4' : 'text-yellow-500 size-4'"
+                      />
+                      <span v-if="!vaultStatus.configured">Vault not configured</span>
+                      <span v-else-if="!vaultStatus.exists">Path does not exist</span>
+                      <span v-else>Vault reachable</span>
+                    </div>
+                    <p v-if="vaultStatus.exists" class="text-muted font-mono">
+                      {{ vaultStatus.vault_path }}
+                    </p>
+                    <ul v-if="vaultStatus.exists" class="space-y-0.5 pt-1">
+                      <li class="flex items-center gap-2">
+                        <UIcon name="i-lucide-folder" class="size-3 text-muted" />
+                        <span class="font-mono">Personas/</span>
+                        <UBadge
+                          :label="`${vaultStatus.personas.count} files`"
+                          variant="subtle"
+                          size="xs"
+                        />
+                      </li>
+                      <li class="flex items-center gap-2">
+                        <UIcon name="i-lucide-folder" class="size-3 text-muted" />
+                        <span class="font-mono">Agents/</span>
+                        <UBadge
+                          :label="`${vaultStatus.agents.count} files`"
+                          variant="subtle"
+                          size="xs"
+                        />
+                      </li>
+                    </ul>
+                  </div>
+
                   <div class="flex justify-end pt-2">
                     <UButton
                       label="Save profile"

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.29.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.29.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."""
@@ -2431,6 +2500,44 @@ def settings_plugins():
 
 # --- Profile (PR63 v2.81.0) ---
 
+@app.get("/api/settings/vault")
+def settings_vault():
+    """PR89c v3.29.0 — vault path connection test.
+
+    Reads ``profile.vaultPath`` and reports back whether the path
+    exists, whether ``Personas/`` and ``Agents/`` subdirs are present,
+    and how many ``*.md`` files each contains.
+
+    Returns ``{configured, vault_path, exists, personas: {dir, count},
+    agents: {dir, count}}``.
+    """
+    from core.profile import ProfileManager
+    profile = ProfileManager().read()
+    configured = bool(profile.vaultPath)
+    vault = Path(profile.vaultPath).expanduser() if configured else None
+    exists = bool(vault and vault.exists() and vault.is_dir())
+
+    def _subdir_info(name: str) -> dict:
+        if not exists:
+            return {"dir": "", "count": 0}
+        sub = vault / name
+        if not sub.exists():
+            return {"dir": str(sub), "count": 0}
+        try:
+            count = sum(1 for _ in sub.glob("*.md"))
+        except OSError:
+            count = 0
+        return {"dir": str(sub), "count": count}
+
+    return {
+        "configured": configured,
+        "vault_path": str(vault) if vault else "",
+        "exists": exists,
+        "personas": _subdir_info("Personas"),
+        "agents": _subdir_info("Agents"),
+    }
+
+
 @app.get("/api/profile")
 def profile_get():
     """Return the operator profile from ~/.arkaos/profile.json.