arkaos 3.68.0 → 3.69.0

package/VERSION

@@ -1 +1 @@
-3.68.0
+3.69.0

package/dashboard/app/components/Terminal.vue

@@ -1,9 +1,8 @@
 <script setup lang="ts">
 // PR99b v3.68.0 — xterm.js terminal mount.
-//
-// Glues @xterm/xterm to a single PTY session from useTerminalSession.
-// One terminal per component instance; the multi-tab page in PR99c
-// will spawn N of these.
+// PR99c v3.69.0 — accepts an external session via prop so the tab
+// manager in /terminal can mount N instances, each bound to its own
+// PTY session.
 
 import { Terminal as XTerm } from '@xterm/xterm'
 import { FitAddon } from '@xterm/addon-fit'
@@ -11,8 +10,14 @@ import { WebLinksAddon } from '@xterm/addon-web-links'
 import { SearchAddon } from '@xterm/addon-search'
 import '@xterm/xterm/css/xterm.css'
 
+interface Props {
+  session?: ReturnType<typeof useTerminalSession>
+  onInputLine?: (line: string) => void
+}
+const props = defineProps<Props>()
+
 const container = ref<HTMLDivElement | null>(null)
-const session = useTerminalSession()
+const session = props.session ?? useTerminalSession()
 const term = shallowRef<XTerm | null>(null)
 const fit = shallowRef<FitAddon | null>(null)
 const search = shallowRef<SearchAddon | null>(null)
@@ -77,7 +82,22 @@ onMounted(async () => {
     t.write(text)
   })
 
+  // PR99c v3.69.0 — line-buffer for command history without server-
+  // side audit. Captures only printable chars up to Enter; ignores
+  // arrow keys, ctrl combos, escape sequences.
+  let lineBuf = ''
   t.onData((data) => {
+    for (const ch of data) {
+      if (ch === '\r' || ch === '\n') {
+        const cmd = lineBuf.trim()
+        if (cmd) props.onInputLine?.(cmd)
+        lineBuf = ''
+      } else if (ch === '\x7f' || ch === '\b') {
+        lineBuf = lineBuf.slice(0, -1)
+      } else if (ch >= ' ' && ch < '\x7f') {
+        lineBuf += ch
+      }
+    }
     session.sendInput(data)
   })
 
@@ -103,7 +123,11 @@ onMounted(async () => {
 onBeforeUnmount(async () => {
   unsubscribeOutput?.()
   resizeObserver?.disconnect()
-  await session.close()
+  // PR99c: only close the session if we created it. When the parent
+  // owns the session (props.session), parent is responsible for close.
+  if (!props.session) {
+    await session.close()
+  }
   term.value?.dispose()
 })
 

package/dashboard/app/composables/useTerminalSession.ts

@@ -26,8 +26,13 @@ export interface TerminalSessionHandle {
   onOutput: (cb: (chunk: Uint8Array) => void) => () => void
 }
 
-export function useTerminalSession(): TerminalSessionHandle {
-  const { apiBase } = useApi()
+export function useTerminalSession(
+  apiBaseOverride?: string,
+): TerminalSessionHandle {
+  // PR99c v3.69.0 — apiBaseOverride lets useTerminalTabs construct
+  // sessions from user-event handlers without re-entering Nuxt's
+  // composable context.
+  const apiBase = apiBaseOverride ?? useApi().apiBase
   const meta = ref<TerminalSessionMeta | null>(null)
   const status = ref<'idle' | 'connecting' | 'open' | 'closed' | 'error'>('idle')
   const error = ref<string | null>(null)

package/dashboard/app/composables/useTerminalTabs.ts

@@ -0,0 +1,130 @@
+// PR99c v3.69.0 — multi-session tab manager for /terminal.
+//
+// Owns an array of `useTerminalSession()` handles plus the active tab
+// id. Persists tab titles (not PTYs — those are re-created fresh on
+// reload) to localStorage. Enforces an 8-tab cap (matching the backend
+// default).
+
+export interface TerminalTab {
+  id: string
+  title: string
+  session: ReturnType<typeof useTerminalSession>
+  createdAt: number
+  hasActivity: boolean
+}
+
+const STORAGE_KEY = 'arka-terminal-tab-titles'
+const MAX_TABS = 8
+
+interface PersistedTitle {
+  id: string
+  title: string
+}
+
+function loadPersistedTitles(): Record<string, string> {
+  if (typeof localStorage === 'undefined') return {}
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY)
+    if (!raw) return {}
+    const parsed = JSON.parse(raw) as PersistedTitle[]
+    return Object.fromEntries(parsed.map(p => [p.id, p.title]))
+  } catch {
+    return {}
+  }
+}
+
+function persistTitles(tabs: TerminalTab[]) {
+  if (typeof localStorage === 'undefined') return
+  try {
+    const payload: PersistedTitle[] = tabs.map(t => ({ id: t.id, title: t.title }))
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(payload))
+  } catch {
+    // quota / private mode — swallow
+  }
+}
+
+export function useTerminalTabs() {
+  const { apiBase } = useApi()
+  const tabs = ref<TerminalTab[]>([])
+  const activeId = ref<string | null>(null)
+  const capReached = computed(() => tabs.value.length >= MAX_TABS)
+
+  function makeId(): string {
+    return Math.random().toString(36).slice(2, 10)
+  }
+
+  function newTab(): TerminalTab | null {
+    if (tabs.value.length >= MAX_TABS) return null
+    const id = makeId()
+    const persistedTitles = loadPersistedTitles()
+    const titleFromStorage = persistedTitles[id]
+    const tab: TerminalTab = {
+      id,
+      title: titleFromStorage || `Session ${tabs.value.length + 1}`,
+      session: useTerminalSession(apiBase),
+      createdAt: Date.now(),
+      hasActivity: false,
+    }
+    tabs.value.push(tab)
+    activeId.value = id
+    persistTitles(tabs.value)
+    return tab
+  }
+
+  async function closeTab(id: string) {
+    const idx = tabs.value.findIndex(t => t.id === id)
+    if (idx < 0) return
+    const tab = tabs.value[idx]
+    if (!tab) return
+    await tab.session.close()
+    tabs.value.splice(idx, 1)
+    if (activeId.value === id) {
+      const next = tabs.value[Math.min(idx, tabs.value.length - 1)]
+      activeId.value = next ? next.id : null
+    }
+    persistTitles(tabs.value)
+  }
+
+  function switchTab(id: string) {
+    const t = tabs.value.find(t => t.id === id)
+    if (!t) return
+    activeId.value = id
+    t.hasActivity = false
+  }
+
+  function renameTab(id: string, title: string) {
+    const t = tabs.value.find(t => t.id === id)
+    if (!t) return
+    t.title = title.trim() || t.title
+    persistTitles(tabs.value)
+  }
+
+  function markActivity(id: string) {
+    if (activeId.value === id) return
+    const t = tabs.value.find(t => t.id === id)
+    if (t) t.hasActivity = true
+  }
+
+  async function closeAll() {
+    await Promise.all(tabs.value.map(t => t.session.close()))
+    tabs.value = []
+    activeId.value = null
+    persistTitles([])
+  }
+
+  const activeTab = computed(() => tabs.value.find(t => t.id === activeId.value) ?? null)
+
+  return {
+    tabs,
+    activeId,
+    activeTab,
+    capReached,
+    maxTabs: MAX_TABS,
+    newTab,
+    closeTab,
+    switchTab,
+    renameTab,
+    markActivity,
+    closeAll,
+  }
+}

package/dashboard/app/pages/terminal.vue

@@ -1,25 +1,135 @@
 <script setup lang="ts">
 // PR99b v3.68.0 — Real-shell terminal (single session).
+// PR99c v3.69.0 — Multi-session tabs + browser-local command history.
 //
-// Replaces the v3.51.0 allowlist UI. Each visit spawns a fresh PTY
-// session on the backend, wired to xterm.js. Multi-session tabs and
-// history land in PR99c. The old allowlist endpoints stay in parallel
-// until PR99d, but the UI is gone as of this release.
+// Each tab owns its own PTY session. PTYs are NOT persisted across
+// reloads (they're per-process); only tab titles are. The 8-tab cap
+// matches the backend default.
 
 definePageMeta({ layout: 'default' })
 
-const terminalRef = ref<InstanceType<typeof import('~/components/Terminal.vue').default> | null>(null)
-const expanded = ref(false)
+const {
+  tabs,
+  activeId,
+  activeTab,
+  capReached,
+  maxTabs,
+  newTab,
+  closeTab,
+  switchTab,
+  renameTab,
+} = useTerminalTabs()
+
+const HISTORY_KEY = 'arka-terminal-command-history'
+const HISTORY_MAX = 500
+
+interface HistoryEntry {
+  ts: number
+  cmd: string
+}
+
+function loadHistory(): HistoryEntry[] {
+  if (typeof localStorage === 'undefined') return []
+  try {
+    const raw = localStorage.getItem(HISTORY_KEY)
+    return raw ? (JSON.parse(raw) as HistoryEntry[]) : []
+  } catch {
+    return []
+  }
+}
+
+const history = ref<HistoryEntry[]>(loadHistory())
+
+function recordCommand(cmd: string) {
+  const trimmed = cmd.trim()
+  if (!trimmed || trimmed.length < 2) return
+  history.value.unshift({ ts: Date.now(), cmd: trimmed })
+  if (history.value.length > HISTORY_MAX) {
+    history.value = history.value.slice(0, HISTORY_MAX)
+  }
+  try {
+    localStorage.setItem(HISTORY_KEY, JSON.stringify(history.value))
+  } catch {
+    // quota — silently truncate further
+    history.value = history.value.slice(0, 200)
+  }
+}
+
+const editingTabId = ref<string | null>(null)
+const renameDraft = ref('')
+
+function startRename(tabId: string, currentTitle: string) {
+  editingTabId.value = tabId
+  renameDraft.value = currentTitle
+}
+
+function commitRename() {
+  if (editingTabId.value) {
+    renameTab(editingTabId.value, renameDraft.value)
+  }
+  editingTabId.value = null
+}
+
+const toast = useToast()
+
+function tryNewTab() {
+  if (capReached.value) {
+    toast.add({
+      title: 'Maximum sessions reached',
+      description: `You can have up to ${maxTabs} sessions open at once. Close one to open a new one.`,
+      color: 'warning',
+      icon: 'i-lucide-alert-triangle',
+    })
+    return
+  }
+  newTab()
+}
+
+// Keyboard shortcuts.
+defineShortcuts({
+  meta_t: { handler: tryNewTab, usingInput: false },
+  meta_w: {
+    handler: () => {
+      if (activeId.value) closeTab(activeId.value)
+    },
+    usingInput: false,
+  },
+  meta_1: { handler: () => switchByIndex(0), usingInput: false },
+  meta_2: { handler: () => switchByIndex(1), usingInput: false },
+  meta_3: { handler: () => switchByIndex(2), usingInput: false },
+  meta_4: { handler: () => switchByIndex(3), usingInput: false },
+  meta_5: { handler: () => switchByIndex(4), usingInput: false },
+  meta_6: { handler: () => switchByIndex(5), usingInput: false },
+  meta_7: { handler: () => switchByIndex(6), usingInput: false },
+  meta_8: { handler: () => switchByIndex(7), usingInput: false },
+})
+
+function switchByIndex(idx: number) {
+  const t = tabs.value[idx]
+  if (t) switchTab(t.id)
+}
+
+// First-visit: open one tab automatically.
+onMounted(() => {
+  if (tabs.value.length === 0) newTab()
+})
+
+onBeforeUnmount(async () => {
+  // Don't proactively close tabs — operator may navigate back. Backend
+  // reaper will GC after the idle timeout (30 min).
+})
+
+const showHistory = ref(false)
 </script>
 
 <template>
   <div class="flex flex-col gap-3 h-full">
-    <header class="flex items-center justify-between">
+    <header class="flex items-center justify-between gap-3 flex-wrap">
       <div>
         <h1 class="text-2xl font-semibold">Terminal</h1>
         <p class="text-sm text-muted">
-          Real shell, PTY-backed. Runs the same commands as your local zsh —
-          claude, codex, git, anything. Session ends when you leave this page.
+          Real PTY shell — run claude, codex, git, anything. ⌘T new ·
+          ⌘W close · ⌘1–8 switch.
         </p>
       </div>
       <div class="flex items-center gap-2">
@@ -30,22 +140,106 @@ const expanded = ref(false)
         <UButton
           size="xs"
           variant="ghost"
-          :icon="expanded ? 'i-lucide-minimize-2' : 'i-lucide-maximize-2'"
-          @click="expanded = !expanded"
+          :icon="showHistory ? 'i-lucide-x' : 'i-lucide-history'"
+          @click="showHistory = !showHistory"
         >
-          {{ expanded ? 'Restore' : 'Expand' }}
+          History ({{ history.length }})
         </UButton>
       </div>
     </header>
 
-    <Terminal
-      ref="terminalRef"
-      :class="expanded ? 'fixed inset-4 z-40' : 'flex-1 min-h-[520px]'"
-    />
+    <div class="flex items-center gap-1 border-b border-default pb-2 overflow-x-auto">
+      <div
+        v-for="(tab, idx) in tabs"
+        :key="tab.id"
+        :class="[
+          'group flex items-center gap-1 px-3 py-1.5 rounded-t-md cursor-pointer text-sm shrink-0 border-b-2 transition-colors',
+          activeId === tab.id
+            ? 'bg-elevated/60 border-primary text-default'
+            : 'border-transparent text-muted hover:text-default hover:bg-elevated/30',
+        ]"
+        @click="switchTab(tab.id)"
+        @dblclick="startRename(tab.id, tab.title)"
+      >
+        <span class="text-xs text-muted">{{ idx + 1 }}</span>
+        <UInput
+          v-if="editingTabId === tab.id"
+          v-model="renameDraft"
+          size="xs"
+          autofocus
+          @keydown.enter="commitRename"
+          @keydown.esc="editingTabId = null"
+          @blur="commitRename"
+        />
+        <span v-else>{{ tab.title }}</span>
+        <UIcon
+          v-if="tab.hasActivity && activeId !== tab.id"
+          name="i-lucide-circle"
+          class="size-2 text-amber-400 fill-current"
+        />
+        <button
+          class="ml-1 size-4 grid place-items-center rounded text-muted hover:bg-default/50 hover:text-default opacity-0 group-hover:opacity-100"
+          @click.stop="closeTab(tab.id)"
+        >
+          <UIcon name="i-lucide-x" class="size-3" />
+        </button>
+      </div>
+      <UButton
+        size="xs"
+        variant="ghost"
+        icon="i-lucide-plus"
+        :disabled="capReached"
+        :title="capReached ? `Max ${maxTabs} sessions` : 'New session'"
+        @click="tryNewTab"
+      >
+        New
+      </UButton>
+    </div>
+
+    <div class="flex-1 min-h-[480px] flex gap-3">
+      <div class="flex-1 relative">
+        <template v-for="tab in tabs" :key="tab.id">
+          <Terminal
+            v-show="activeId === tab.id"
+            :session="tab.session"
+            :on-input-line="recordCommand"
+            class="absolute inset-0"
+          />
+        </template>
+        <div
+          v-if="tabs.length === 0"
+          class="absolute inset-0 grid place-items-center text-muted text-sm"
+        >
+          No active sessions. Press ⌘T or click "+ New" to open one.
+        </div>
+      </div>
+      <aside
+        v-if="showHistory"
+        class="w-72 shrink-0 rounded-lg border border-default bg-elevated/10 overflow-hidden flex flex-col"
+      >
+        <div class="px-3 py-2 border-b border-default text-xs uppercase tracking-wide text-muted">
+          Command history
+        </div>
+        <div class="flex-1 overflow-auto text-xs font-mono">
+          <button
+            v-for="(entry, i) in history"
+            :key="i"
+            class="w-full text-left px-3 py-1.5 hover:bg-default/40 truncate"
+            :title="entry.cmd"
+            @click="activeTab?.session.sendInput(entry.cmd)"
+          >
+            {{ entry.cmd }}
+          </button>
+          <div v-if="history.length === 0" class="px-3 py-4 text-muted text-center">
+            No commands yet
+          </div>
+        </div>
+      </aside>
+    </div>
 
     <footer class="text-xs text-muted">
-      Multi-session tabs, command history search and theme picker arrive in
-      PR99c / PR99d. PR99a (backend PTY) is live.
+      Sessions live on the backend until you close them or 30 min idle.
+      History stays in this browser only.
     </footer>
   </div>
 </template>

package/package.json

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