arkaos 3.54.0 → 3.56.0

package/VERSION

@@ -1 +1 @@
-3.54.0
+3.56.0

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

@@ -137,6 +137,42 @@ function goToPersona(id: string) {
   navigateTo(`/personas/${id}`)
 }
 
+// PR96a v3.55.0 — keyboard nav, mirror of PR95d on /agents.
+const cursorIndex = ref(-1)
+
+function cursorDown() {
+  const total = paginatedPersonas.value.length
+  if (total === 0) return
+  cursorIndex.value = Math.min(total - 1, Math.max(0, cursorIndex.value + 1))
+  scrollCursorIntoView()
+}
+function cursorUp() {
+  const total = paginatedPersonas.value.length
+  if (total === 0) return
+  cursorIndex.value = Math.max(0, cursorIndex.value === -1 ? 0 : cursorIndex.value - 1)
+  scrollCursorIntoView()
+}
+function cursorOpen() {
+  if (cursorIndex.value < 0) return
+  const row = paginatedPersonas.value[cursorIndex.value]
+  if (row?.id) goToPersona(row.id)
+}
+function scrollCursorIntoView() {
+  if (typeof document === 'undefined') return
+  setTimeout(() => {
+    const el = document.querySelector('[data-cursor="true"]')
+    el?.scrollIntoView({ block: 'nearest', behavior: 'smooth' })
+  }, 0)
+}
+
+defineShortcuts({
+  j: () => cursorDown(),
+  k: () => cursorUp(),
+  arrowdown: () => cursorDown(),
+  arrowup: () => cursorUp(),
+  enter: () => cursorOpen(),
+})
+
 // PR86a v3.15.0 — favorites.
 const favs = useFavorites()
 await favs.load()
@@ -593,7 +629,14 @@ async function undoTrashIds(ids: string[]) {
             />
           </template>
           <template #name-cell="{ row }">
-            <span class="font-medium">{{ row.original.name }}</span>
+            <div :data-cursor="row.index === cursorIndex ? 'true' : undefined" class="flex items-center gap-1.5">
+              <UIcon
+                v-if="row.index === cursorIndex"
+                name="i-lucide-chevron-right"
+                class="size-3.5 text-primary shrink-0"
+              />
+              <span class="font-medium">{{ row.original.name }}</span>
+            </div>
           </template>
           <template #title-cell="{ row }">
             <span class="text-sm text-muted truncate">{{ row.original.title || '—' }}</span>

package/dashboard/app/pages/terminal.vue

@@ -9,10 +9,18 @@
 // instead ships a controlled command runner with allowlist + capped
 // output. xterm.js-style PTY can be a later upgrade if needed.
 
+interface CommandArg {
+  name: string
+  label: string
+  choices: string[]
+  default: string
+}
+
 interface CommandEntry {
   id: string
   label: string
   description: string
+  args?: CommandArg[]
 }
 
 interface ExecResult {
@@ -41,12 +49,33 @@ const commands = computed<CommandEntry[]>(() => cmdData.value?.commands ?? [])
 const running = ref<string | null>(null)
 const history = ref<HistoryEntry[]>([])
 
+// PR96b v3.56.0 — per-command arg state. Keyed by command id, holds
+// the operator's current selection for each arg.
+const argState = reactive<Record<string, Record<string, string>>>({})
+
+function ensureArgState(cmd: CommandEntry) {
+  if (!cmd.args || cmd.args.length === 0) return
+  if (!argState[cmd.id]) argState[cmd.id] = {}
+  for (const arg of cmd.args) {
+    if (argState[cmd.id][arg.name] === undefined) {
+      argState[cmd.id][arg.name] = arg.default
+    }
+  }
+}
+
 async function run(cmd: CommandEntry) {
   running.value = cmd.id
+  ensureArgState(cmd)
   try {
     const res = await $fetch<ExecResult & { error?: string }>(
       `${apiBase}/api/terminal/exec`,
-      { method: 'POST', body: { command_id: cmd.id } },
+      {
+        method: 'POST',
+        body: {
+          command_id: cmd.id,
+          args: cmd.args ? argState[cmd.id] : undefined,
+        },
+      },
     )
     if (res.error) throw new Error(res.error)
     history.value = [
@@ -139,22 +168,47 @@ function relative(iso: string): string {
                 </p>
               </div>
             </template>
-            <div class="grid grid-cols-1 md:grid-cols-2 gap-2">
-              <UButton
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-3">
+              <div
                 v-for="cmd in commands"
                 :key="cmd.id"
-                :label="cmd.label"
-                :description="cmd.description"
-                icon="i-lucide-terminal"
-                variant="soft"
-                color="primary"
-                size="sm"
-                block
-                class="justify-start"
-                :loading="running === cmd.id"
-                :disabled="running !== null && running !== cmd.id"
-                @click="run(cmd)"
-              />
+                class="rounded-lg border border-default p-3 space-y-2"
+              >
+                <div>
+                  <p class="text-sm font-semibold">{{ cmd.label }}</p>
+                  <p class="text-xs text-muted">{{ cmd.description }}</p>
+                </div>
+                <!-- PR96b v3.56.0 — arg pickers for parameterised commands -->
+                <div v-if="cmd.args && cmd.args.length > 0" class="grid grid-cols-2 gap-2">
+                  <UFormField
+                    v-for="arg in cmd.args"
+                    :key="arg.name"
+                    :label="arg.label"
+                    size="xs"
+                  >
+                    <USelect
+                      :model-value="(argState[cmd.id] || {})[arg.name] || arg.default"
+                      :items="arg.choices.map((c) => ({ label: c, value: c }))"
+                      size="xs"
+                      class="w-full"
+                      @update:model-value="(v) => {
+                        ensureArgState(cmd)
+                        argState[cmd.id][arg.name] = String(v)
+                      }"
+                    />
+                  </UFormField>
+                </div>
+                <UButton
+                  label="Run"
+                  icon="i-lucide-play"
+                  color="primary"
+                  size="sm"
+                  block
+                  :loading="running === cmd.id"
+                  :disabled="running !== null && running !== cmd.id"
+                  @click="run(cmd)"
+                />
+              </div>
             </div>
           </UCard>
 

package/package.json

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

package/scripts/dashboard-api.py

@@ -2024,9 +2024,17 @@ TERMINAL_ALLOWLIST: list[dict] = [
     },
     {
         "id": "git-log",
-        "label": "git log (10)",
-        "cmd": ["git", "log", "-10", "--oneline"],
-        "description": "Most recent 10 commits.",
+        "label": "git log",
+        "cmd_template": ["git", "log", "-{count}", "--oneline"],
+        "args": [
+            {
+                "name": "count",
+                "label": "Commits to show",
+                "choices": ["5", "10", "20", "50"],
+                "default": "10",
+            },
+        ],
+        "description": "Most recent N commits (operator picks N).",
     },
     {
         "id": "npm-version",
@@ -2046,6 +2054,20 @@ TERMINAL_ALLOWLIST: list[dict] = [
         "cmd": ["ls", "-la"],
         "description": "List files in the project root.",
     },
+    {
+        "id": "arka-costs",
+        "label": "ArkaOS costs",
+        "cmd_template": ["python3", "-m", "core.runtime.llm_cost_telemetry_cli", "{period}"],
+        "args": [
+            {
+                "name": "period",
+                "label": "Period",
+                "choices": ["today", "week", "month", "all"],
+                "default": "today",
+            },
+        ],
+        "description": "LLM cost summary for the selected period.",
+    },
 ]
 
 _TERMINAL_TIMEOUT_S = 15
@@ -2054,14 +2076,41 @@ _TERMINAL_MAX_OUTPUT = 20_000  # chars — both stdout and stderr capped
 
 @app.get("/api/terminal/commands")
 def terminal_commands():
-    """List allowlisted commands the dashboard terminal may run."""
-    return {
-        "commands": [
-            {"id": c["id"], "label": c["label"], "description": c["description"]}
-            for c in TERMINAL_ALLOWLIST
-        ],
-        "total": len(TERMINAL_ALLOWLIST),
-    }
+    """List allowlisted commands the dashboard terminal may run.
+
+    PR96b v3.56.0 — includes the `args` schema (label / choices /
+    default) when an entry has parameters. The raw cmd / cmd_template
+    is NEVER returned — defence in depth.
+    """
+    out: list[dict] = []
+    for c in TERMINAL_ALLOWLIST:
+        out.append({
+            "id": c["id"],
+            "label": c["label"],
+            "description": c["description"],
+            "args": _safe_args_schema(c.get("args")),
+        })
+    return {"commands": out, "total": len(out)}
+
+
+def _safe_args_schema(args) -> list[dict]:
+    """Sanitised arg schema for the public API — never leaks cmd/template."""
+    if not isinstance(args, list):
+        return []
+    out: list[dict] = []
+    for a in args:
+        if not isinstance(a, dict):
+            continue
+        choices = a.get("choices")
+        if not isinstance(choices, list) or not choices:
+            continue
+        out.append({
+            "name": str(a.get("name") or ""),
+            "label": str(a.get("label") or a.get("name") or ""),
+            "choices": [str(x) for x in choices],
+            "default": str(a.get("default") or choices[0]),
+        })
+    return out
 
 
 @app.post("/api/terminal/exec")
@@ -2080,11 +2129,20 @@ def terminal_exec(body: dict):
     entry = next((c for c in TERMINAL_ALLOWLIST if c["id"] == cid), None)
     if entry is None:
         return {"error": f"command '{cid}' is not on the allowlist"}
+
+    # PR96b v3.56.0 — resolve template + args, or fall back to fixed cmd.
+    if "cmd_template" in entry:
+        argv, err = _resolve_cmd_template(entry, body.get("args") or {})
+        if err:
+            return {"error": err}
+    else:
+        argv = entry["cmd"]
+
     import time
     started = time.monotonic()
     try:
         result = subprocess.run(
-            entry["cmd"],
+            argv,
             cwd=str(ARKAOS_ROOT),
             capture_output=True,
             text=True,
@@ -2097,7 +2155,7 @@ def terminal_exec(body: dict):
             "stderr": f"command timed out after {_TERMINAL_TIMEOUT_S}s",
             "exit_code": -1,
             "duration_ms": int(_TERMINAL_TIMEOUT_S * 1000),
-            "command": " ".join(entry["cmd"]),
+            "command": " ".join(argv),
         }
     except OSError as exc:
         return {
@@ -2105,7 +2163,7 @@ def terminal_exec(body: dict):
             "stderr": f"command failed to launch: {exc}",
             "exit_code": -1,
             "duration_ms": int((time.monotonic() - started) * 1000),
-            "command": " ".join(entry["cmd"]),
+            "command": " ".join(argv),
         }
     duration_ms = int((time.monotonic() - started) * 1000)
     return {
@@ -2113,10 +2171,49 @@ def terminal_exec(body: dict):
         "stderr": (result.stderr or "")[:_TERMINAL_MAX_OUTPUT],
         "exit_code": result.returncode,
         "duration_ms": duration_ms,
-        "command": " ".join(entry["cmd"]),
+        "command": " ".join(argv),
     }
 
 
+def _resolve_cmd_template(entry: dict, supplied: dict) -> tuple[list[str], "str | None"]:
+    """Substitute `{name}` placeholders in cmd_template with validated args.
+
+    Returns (argv, None) on success, ([], error_msg) on validation failure.
+    Anything supplied that isn't in the schema's choices is rejected.
+    Unknown arg names are also rejected — no silent passthrough.
+    """
+    schema = entry.get("args") or []
+    if not isinstance(schema, list):
+        return [], "command has invalid args schema"
+    by_name: dict[str, dict] = {a["name"]: a for a in schema if isinstance(a, dict)}
+    chosen: dict[str, str] = {}
+    for arg_def in schema:
+        name = arg_def["name"]
+        s = supplied.get(name)
+        if s is None:
+            chosen[name] = str(arg_def.get("default") or arg_def["choices"][0])
+            continue
+        s_str = str(s)
+        if s_str not in arg_def["choices"]:
+            return [], (
+                f"arg '{name}'='{s_str}' is not in the allowed choices "
+                f"({', '.join(arg_def['choices'])})"
+            )
+        chosen[name] = s_str
+    for k in supplied:
+        if k not in by_name:
+            return [], f"unknown arg '{k}'"
+    argv: list[str] = []
+    for tok in entry["cmd_template"]:
+        if not isinstance(tok, str):
+            continue
+        out_tok = tok
+        for name, val in chosen.items():
+            out_tok = out_tok.replace(f"{{{name}}}", val)
+        argv.append(out_tok)
+    return argv, None
+
+
 @app.put("/api/workflows/{workflow_id}/yaml")
 def workflow_update_yaml(workflow_id: str, body: dict):
     """PR94d v3.50.0 — overwrite a workflow's YAML file in place.