martty 0.2.21 → 0.2.24

package/lib/agents-view.js

@@ -0,0 +1,121 @@
+/** Built-in Client Plugin: Agent navigation above the composer's metadata row. */
+
+export const name = 'agents-view'
+export const inject = ['tuiAgents', 'tuiSlots', 'tuiCommands']
+
+export function apply(ctx) {
+  let current = ctx.tuiAgents.current()
+  let panel
+
+  const stopSlot = ctx.tuiSlots.inject('conversation.navigation.dock', () => {
+    panel = ctx.tuiSlots.register(
+      { name: 'conversation.navigation.dock', id: 'agents-view', order: 0 },
+      dockNodes(current),
+    )
+    return () => panel.dispose()
+  })
+  const stopAgents = ctx.tuiAgents.subscribe((snapshot) => {
+    current = snapshot
+    panel?.update(dockNodes(current))
+  })
+  const stopCommand = ctx.tuiCommands.register({
+    name: 'agents',
+    description: 'Switch the visible Agent transcript',
+  }, async (args) => {
+    current = ctx.tuiAgents.current()
+    const target = args.trim()
+    if (target.length > 0) {
+      return ctx.tuiAgents.select(target)
+    }
+    return ctx.tuiAgents.navigate('begin')
+  })
+
+  return () => {
+    stopCommand?.()
+    stopAgents?.()
+    stopSlot?.()
+  }
+}
+
+function dockNodes(snapshot) {
+  if (!Array.isArray(snapshot?.items) || snapshot.items.length < 2) return []
+  const selecting = snapshot.selectedId !== null && snapshot.selectedId !== undefined
+  if (!selecting) {
+    const agents = snapshot.items.filter((item) => item.kind === 'subagent')
+    const marked = agents.filter((item) => item.current !== false)
+    const current = marked.length > 0 ? marked : agents
+    const completed = current.filter((item) => item.status === 'finished' || item.status === 'failed').length
+    const running = current.some((item) => item.status === 'running')
+    const failed = current.some((item) => item.status === 'failed')
+    return [
+      {
+        id: 'summary', kind: 'generic', title: '· Agents', body: `${completed}/${current.length}`,
+        status: failed ? 'err' : running ? 'running' : 'done', tone: 'caption',
+      },
+      {
+        id: 'switch', kind: 'generic', title: '↓ expand', body: '', tone: 'caption',
+      },
+    ]
+  }
+  const historyActive = snapshot.items.some((item) => (
+    item.kind === 'subagent'
+      && item.current === false
+      && sameId(item.id, snapshot.activeId)
+  ))
+  const visibleItems = snapshot.items
+    .filter((item) => item.kind !== 'subagent' || item.current !== false)
+    .sort((left, right) => Number(left.kind === 'history') - Number(right.kind === 'history'))
+  return [
+    {
+      id: 'label', kind: 'generic', title: '· Agents', body: '',
+      tone: 'caption',
+    },
+    ...visibleItems.map((item) => agentNode(item, {
+      active: sameId(item.id, snapshot.activeId) || (item.kind === 'history' && historyActive),
+      focused: selecting && sameId(item.id, snapshot.selectedId),
+      selecting,
+    })),
+    {
+      id: 'switch',
+      kind: 'generic',
+      title: '←/→ · enter · esc close',
+      body: '',
+      tone: 'caption',
+    },
+  ]
+}
+
+function agentNode(item, state) {
+  const prefix = state.focused
+    ? '▸ '
+    : state.selecting && state.active
+      ? '• '
+      : !state.selecting && state.active
+        ? '▸ '
+        : ''
+  return {
+    id: `agent-${item.id}`,
+    kind: 'generic',
+    title: `${prefix}${item.label}`,
+    body: '',
+    ...(item.kind === 'subagent' && item.status === 'running'
+      ? { status: 'running' }
+      : item.kind === 'subagent' && item.status === 'finished'
+        ? { status: 'done' }
+        : item.kind === 'subagent' && item.status === 'failed'
+          ? { status: 'err' }
+          : {}),
+    ...(state.focused ? { selected: true } : {}),
+    tone: state.focused
+      ? 'brand'
+      : state.active
+        ? state.selecting ? 'brand_soft' : 'brand'
+        : item.kind === 'history' ? 'caption' : 'fg',
+  }
+}
+
+function sameId(left, right) {
+  return right !== null && right !== undefined && String(left) === String(right)
+}
+
+export { dockNodes }

package/lib/boot.js

@@ -23,9 +23,13 @@ import { apply as applyIceberg, inject as icebergInject } from './iceberg.js'
 import { apply as applySolarized, inject as solarizedInject } from './solarized.js'
 import { apply as applyCommands } from './tui-commands.js'
 import { apply as applyOverlay } from './tui-overlay.js'
+import { apply as applyAgents } from './tui-agents.js'
+import { apply as applyQueue } from './tui-queue.js'
 import { apply as applyPresets, inject as presetsInject } from './tui-presets.js'
 import { apply as applyMarttyPreset, inject as marttyPresetInject } from './martty-preset.js'
 import { apply as applyPlanView, inject as planViewInject } from './plan-view.js'
+import { apply as applyAgentsView, inject as agentsViewInject } from './agents-view.js'
+import { apply as applyQueueView, inject as queueViewInject } from './queue-view.js'
 import { apply as applyStatsView, inject as statsViewInject } from './stats-view.js'
 import { apply as applySessionStatus, inject as sessionStatusInject } from './acp-session-status.js'
 import { apply as applyStatusView, inject as statusViewInject } from './status-view.js'
@@ -64,10 +68,14 @@ export async function bootClient(options = {}) {
     await ctx.plugin({ name: 'tui-slots', inject: [], apply: applySlots })
     await ctx.plugin({ name: 'tui-commands', inject: [], apply: applyCommands })
     await ctx.plugin({ name: 'tui-overlay', inject: [], apply: applyOverlay })
+    await ctx.plugin({ name: 'tui-agents', inject: [], apply: applyAgents })
+    await ctx.plugin({ name: 'tui-queue', inject: [], apply: applyQueue })
     await ctx.plugin({ name: 'tui-presets', inject: presetsInject, apply: applyPresets }, presetConfig)
     await ctx.plugin({ name: 'martty-preset', inject: marttyPresetInject, apply: applyMarttyPreset })
     await ctx.plugin({ name: 'acp-client', inject: [], apply: applyAcpClient }, acpConfig)
     await ctx.plugin({ name: 'plan-view', inject: planViewInject, apply: applyPlanView })
+    await ctx.plugin({ name: 'agents-view', inject: agentsViewInject, apply: applyAgentsView })
+    await ctx.plugin({ name: 'queue-view', inject: queueViewInject, apply: applyQueueView })
     await ctx.plugin({ name: 'stats-view', inject: statsViewInject, apply: applyStatsView })
     await ctx.plugin({ name: 'acp-session-status', inject: sessionStatusInject, apply: applySessionStatus })
     await ctx.plugin({ name: 'status-view', inject: statusViewInject, apply: applyStatusView })
@@ -100,6 +108,7 @@ export async function bootClient(options = {}) {
         inject: [
           'acpClient', 'tuiTheme', 'tuiSlots', 'tuiCommands', 'tuiOverlay',
           'tuiPresets', 'acpClientEvents', 'acpSessionConfig', 'tuiCordisClientRunner',
+          'tuiQueue', 'tuiAgents',
         ],
         apply: applyShell,
       },
@@ -116,10 +125,14 @@ export async function bootClient(options = {}) {
     applySlots(ctx)
     applyCommands(ctx)
     applyOverlay(ctx)
+    applyAgents(ctx)
+    applyQueue(ctx)
     applyPresets(ctx, presetConfig)
     applyMarttyPreset(ctx)
     applyAcpClient(ctx, acpConfig)
     applyPlanView(ctx)
+    applyAgentsView(ctx)
+    applyQueueView(ctx)
     applyStatsView(ctx)
     applySessionStatus(ctx)
     applyStatusView(ctx)

package/lib/client-process.js

@@ -4,6 +4,16 @@
 
 import { bootClient, parseClientPluginsEnv } from './boot.js'
 
+// The Host runner kills this process with SIGTERM on shutdown, and the user's
+// Ctrl+C reaches it as SIGINT from the foreground terminal group. Node's
+// default signal handling terminates without running 'exit' listeners, which
+// would strand the Rust painter as an orphan holding the TTY (it is only
+// killed from the Client's 'exit' hook). Convert signals into an orderly
+// process.exit so painter teardown and TTY restore always run.
+for (const [signal, code] of [['SIGTERM', 143], ['SIGINT', 130], ['SIGHUP', 129]]) {
+  process.on(signal, () => process.exit(code))
+}
+
 await bootClient({
   stream: { stdin: process.stdout, stdout: process.stdin },
   extraArgs: process.argv.slice(2),

package/lib/cordis-protocol.js

@@ -33,6 +33,10 @@ export const CORDIS_METHODS = Object.freeze({
   commandInvoke: '_dsh/cordis/tui/commands/invoke',
   overlayUpdate: '_dsh/cordis/tui/overlay/update',
   overlayEvent: '_dsh/cordis/tui/overlay/event',
+  queueUpdate: '_dsh/cordis/tui/queue/update',
+  agentsUpdate: '_dsh/cordis/tui/agents/update',
+  agentsSelect: '_dsh/cordis/tui/agents/select',
+  agentsNavigate: '_dsh/cordis/tui/agents/navigate',
   sessionConfigSet: '_dsh/cordis/tui/session-config/set',
 })
 

package/lib/index.js

@@ -17,7 +17,7 @@ import { muxAcpAndCompositor } from './mux.js'
 export const name = 'dsh-tui-shell'
 export const inject = [
   'acpClient', 'tuiTheme', 'tuiPresets', 'tuiSlots', 'tuiCommands', 'tuiOverlay',
-  'acpClientEvents', 'acpSessionConfig', 'tuiCordisClientRunner',
+  'acpClientEvents', 'acpSessionConfig', 'tuiQueue', 'tuiAgents', 'tuiCordisClientRunner',
 ]
 
 const shellStateKey = Symbol.for('martty/shell-state')
@@ -137,6 +137,15 @@ export async function applyShell(ctx, options = {}) {
       'dsh-tui-shell: ctx.acpClientEvents must expose ACP observers',
     )
   }
+  const queue = ctx.tuiQueue ?? ctx.get?.('tuiQueue')
+  if (queue === undefined || typeof queue.observe !== 'function') {
+    throw new Error('dsh-tui-shell: ctx.tuiQueue must expose observe')
+  }
+  const agents = ctx.tuiAgents ?? ctx.get?.('tuiAgents')
+  if (agents === undefined || typeof agents.observe !== 'function'
+    || typeof agents.bindNotify !== 'function') {
+    throw new Error('dsh-tui-shell: ctx.tuiAgents must expose observe and bindNotify')
+  }
 
   // Config-watch recomposes the tree at boot and disposes this fiber. Keep
   // one painter; do not kill it from ctx.effect or the screen never appears.
@@ -226,6 +235,12 @@ export async function applyShell(ctx, options = {}) {
         if (message.method === CORDIS_METHODS.overlayEvent) {
           return overlay.dispatch(message.params)
         }
+        if (message.method === CORDIS_METHODS.queueUpdate) {
+          return { ok: queue.observe(message.params) }
+        }
+        if (message.method === CORDIS_METHODS.agentsUpdate) {
+          return { ok: agents.observe(message.params) }
+        }
         if (message.method === CORDIS_METHODS.approvalRespond) {
           return clientRunner.respondApproval(message.params)
         }
@@ -242,6 +257,7 @@ export async function applyShell(ctx, options = {}) {
       slots.bindNotify(notifyTui)
       commands.bindNotify(notifyTui)
       overlay.bindNotify(notifyTui)
+      agents.bindNotify(notifyTui)
     }
     republishCompositorState()
     clientRunner.bindTransport(mux.requestAgent, notifyTui)

package/lib/inspect.js

@@ -204,7 +204,8 @@ export function slotInspectProvider(tuiSlots) {
           note:
             'welcome.hero and welcome.info are independent single root regions; '
             + 'chrome.right is a root list slot; conversation.input.dock is the additive row above '
-            + 'the composer; conversation.composer.dock is the additive compact row below it. '
+            + 'the composer; conversation.navigation.dock is compact session navigation inside '
+            + 'the composer above its metadata; conversation.composer.dock is the outer compact telemetry row. '
             + 'Node ids are stable inside one contribution; '
             + 'the compositor namespaces them by contribution id. Compose group/markdown/reasoning/'
             + 'user/generic/terminal/diff/image/notice/unknown nodes. Colors use theme tokens only.',

package/lib/mux.js

@@ -20,6 +20,10 @@ const COMPOSITOR_METHODS = Object.freeze(new Set([
   CORDIS_METHODS.overlayUpdate,
   CORDIS_METHODS.commandInvoke,
   CORDIS_METHODS.overlayEvent,
+  CORDIS_METHODS.queueUpdate,
+  CORDIS_METHODS.agentsUpdate,
+  CORDIS_METHODS.agentsSelect,
+  CORDIS_METHODS.agentsNavigate,
   CORDIS_METHODS.sessionConfigSet,
   CORDIS_METHODS.approvalRespond,
   CORDIS_METHODS.uiSelected,

package/lib/plan-view.js

@@ -46,22 +46,24 @@ function dockNodes(plan) {
     const focus = plan.entries.find((entry) => entry.status === 'in_progress')
       ?? plan.entries.find((entry) => entry.status !== 'completed')
       ?? plan.entries.at(-1)
-    return [{
-      id: 'summary',
-      kind: 'generic',
-      title: `Plan · ${completed}/${total}${focus ? ` · ${focus.content}` : ''}`,
-      body: '',
-      action: { kind: 'command', name: 'plan-view', args: '' },
-      ...(completed === total ? { status: 'ok' } : { status: 'running' }),
-    }]
+    const action = { kind: 'command', name: 'plan-view', args: '' }
+    return [
+      {
+        id: 'summary', kind: 'generic', title: '· Plan', body: `${completed}/${total}`,
+        tone: 'caption', status: completed === total ? 'done' : 'running', action,
+      },
+      ...(focus ? [{
+        id: 'focus', kind: 'generic', title: focus.content, body: '', tone: 'caption', action,
+      }] : []),
+    ]
   }
   return [{
     id: 'summary',
     kind: 'generic',
-    title: plan.kind === 'file' ? `Plan · ${plan.uri}` : 'Plan · available',
-    body: '',
+    title: '· Plan',
+    body: plan.kind === 'file' ? plan.uri : 'available',
+    tone: 'caption',
     action: { kind: 'command', name: 'plan-view', args: '' },
-    status: 'running',
   }]
 }
 

package/lib/queue-view.js

@@ -0,0 +1,66 @@
+/** Built-in Client Plugin: native Queue state in the composer input dock. */
+
+export const name = 'queue-view'
+export const inject = ['tuiQueue', 'tuiSlots']
+
+export function apply(ctx) {
+  let current = ctx.tuiQueue.current()
+  let panel
+
+  const stopSlot = ctx.tuiSlots.inject('conversation.input.dock', () => {
+    panel = ctx.tuiSlots.register(
+      { name: 'conversation.input.dock', id: 'queue-view', order: -10 },
+      dockNodes(current),
+    )
+    return () => panel.dispose()
+  })
+  const stopQueue = ctx.tuiQueue.subscribe((snapshot) => {
+    current = snapshot
+    panel?.update(dockNodes(current))
+  })
+
+  return () => {
+    stopQueue?.()
+    stopSlot?.()
+  }
+}
+
+function dockNodes(queue) {
+  if (!Array.isArray(queue?.items) || queue.items.length === 0) return []
+  const expanded = queue.selectedId !== null || queue.editingId !== null
+  const count = Number.isInteger(queue.count) ? queue.count : queue.items.length
+  const title = expanded
+    ? queue.editingId !== null
+      ? `Queue · ${count} · enter save · ctrl+d delete · esc cancel`
+      : `Queue · ${count} · ↑/↓ choose · enter edit · esc close`
+    : `Queue · ${count} · enter send first · ⌥↑ edit`
+  const nodes = [{
+    id: 'summary',
+    kind: 'generic',
+    title,
+    body: '',
+    status: 'running',
+  }]
+  nodes.push({
+    id: 'items',
+    kind: 'group',
+    children: queue.items.map((item) => {
+      const editing = sameId(item.id, queue.editingId)
+      const selected = sameId(item.id, queue.selectedId)
+      const deleting = editing && queue.deleteConfirm
+      return {
+        id: `item-${item.id}`,
+        kind: 'text',
+        text: `${deleting ? '×' : editing ? '✎' : selected ? '▸' : '›'} ${item.ordinal}  ${item.summary}`,
+        tone: deleting ? 'err' : editing ? 'warn' : selected ? 'brand' : 'fg_secondary',
+      }
+    }),
+  })
+  return nodes
+}
+
+function sameId(left, right) {
+  return right !== null && String(left) === String(right)
+}
+
+export { dockNodes }

package/lib/tui-agents.js

@@ -0,0 +1,133 @@
+/** Native-painter Agent navigation projected into the Cordis Client tree. */
+
+import { Service } from '@deepseek-ai/cordis'
+import { CORDIS_METHODS } from './cordis-protocol.js'
+
+export const name = 'tui-agents'
+export const inject = []
+
+class TuiAgentsService extends Service {
+  constructor(ctx, core) {
+    super(ctx, 'tuiAgents')
+    this.core = core
+  }
+
+  current() { return this.core.current() }
+  subscribe(listener) { return this.core.subscribe(this.ctx, listener) }
+  observe(snapshot) { return this.core.observe(snapshot) }
+  select(id) { return this.core.select(id) }
+  navigate(action) { return this.core.navigate(action) }
+  bindNotify(notify) { return this.core.bindNotify(notify) }
+}
+
+const EMPTY = Object.freeze({ activeId: null, selectedId: null, items: [] })
+const ITEM_KINDS = new Set(['main', 'subagent', 'history'])
+const ITEM_STATUSES = new Set(['idle', 'running', 'finished', 'failed'])
+const NAVIGATION_ACTIONS = new Set(['begin', 'previous', 'next', 'confirm', 'cancel'])
+
+export function installTuiAgents(ctx, options = {}) {
+  let value = EMPTY
+  let send = typeof options.notify === 'function' ? options.notify : undefined
+  const listeners = new Set()
+
+  function current() {
+    return structuredClone(value)
+  }
+
+  function subscribe(effectCtx, listener) {
+    if (typeof listener !== 'function') {
+      throw new Error('tuiAgents.subscribe: listener must be a function')
+    }
+    const setup = () => {
+      listeners.add(listener)
+      return () => listeners.delete(listener)
+    }
+    const release = typeof effectCtx?.effect === 'function'
+      ? effectCtx.effect(setup, 'tuiAgents.subscribe')
+      : setup()
+    let disposed = false
+    return () => {
+      if (disposed) return
+      disposed = true
+      return release?.()
+    }
+  }
+
+  function observe(snapshot) {
+    if (!object(snapshot) || snapshot.protocol !== 0 || !Array.isArray(snapshot.items)) return false
+    const items = snapshot.items.map(normalizeItem).filter((item) => item !== null)
+    const activeId = idOrNull(snapshot.activeId)
+    const selectedId = idOrNull(snapshot.selectedId)
+    value = {
+      activeId: items.some((item) => sameId(item.id, activeId)) ? activeId : null,
+      selectedId: items.some((item) => sameId(item.id, selectedId)) ? selectedId : null,
+      items,
+    }
+    const next = current()
+    for (const listener of [...listeners]) listener(next)
+    return true
+  }
+
+  function bindNotify(notify) {
+    if (typeof notify !== 'function') throw new Error('tuiAgents.bindNotify: notify must be a function')
+    send = notify
+  }
+
+  function select(id) {
+    const selected = idOrNull(id)
+    if (selected === null || !value.items.some((item) => sameId(item.id, selected))) return false
+    if (typeof send !== 'function') return false
+    send(CORDIS_METHODS.agentsSelect, { protocol: 0, id: selected })
+    return true
+  }
+
+  function navigate(action) {
+    if (!NAVIGATION_ACTIONS.has(action) || typeof send !== 'function') return false
+    send(CORDIS_METHODS.agentsNavigate, { protocol: 0, action })
+    return true
+  }
+
+  const core = { current, subscribe, observe, select, navigate, bindNotify }
+  const service = typeof ctx.provide === 'function'
+    ? new TuiAgentsService(ctx, core)
+    : {
+        current,
+        subscribe(listener) { return subscribe(ctx, listener) },
+        observe,
+        select,
+        navigate,
+        bindNotify,
+      }
+  if (typeof ctx.provide !== 'function') ctx.tuiAgents = service
+  return service
+}
+
+function normalizeItem(item) {
+  if (!object(item)) return null
+  const id = idOrNull(item.id)
+  if (id === null || typeof item.label !== 'string' || item.label.length === 0
+    || !ITEM_KINDS.has(item.kind) || !ITEM_STATUSES.has(item.status)) return null
+  return {
+    id, label: item.label, kind: item.kind, status: item.status,
+    ...(typeof item.current === 'boolean' ? { current: item.current } : {}),
+  }
+}
+
+function idOrNull(value) {
+  return (typeof value === 'string' && value.length > 0)
+    || (Number.isSafeInteger(value) && value >= 0)
+    ? value
+    : null
+}
+
+function sameId(left, right) {
+  return right !== null && String(left) === String(right)
+}
+
+function object(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+export function apply(ctx) {
+  installTuiAgents(ctx)
+}

package/lib/tui-queue.js

@@ -0,0 +1,103 @@
+/** Native-painter Queue state projected into the Cordis Client tree. */
+
+import { Service } from '@deepseek-ai/cordis'
+
+export const name = 'tui-queue'
+export const inject = []
+
+class TuiQueueService extends Service {
+  constructor(ctx, core) {
+    super(ctx, 'tuiQueue')
+    this.core = core
+  }
+
+  current() { return this.core.current() }
+  subscribe(listener) { return this.core.subscribe(this.ctx, listener) }
+  observe(snapshot) { return this.core.observe(snapshot) }
+}
+
+const EMPTY = Object.freeze({
+  count: 0,
+  items: [],
+  selectedId: null,
+  editingId: null,
+  deleteConfirm: false,
+})
+
+export function installTuiQueue(ctx) {
+  let value = EMPTY
+  const listeners = new Set()
+
+  function current() {
+    return structuredClone(value)
+  }
+
+  function subscribe(effectCtx, listener) {
+    if (typeof listener !== 'function') {
+      throw new Error('tuiQueue.subscribe: listener must be a function')
+    }
+    const setup = () => {
+      listeners.add(listener)
+      return () => listeners.delete(listener)
+    }
+    const release = typeof effectCtx?.effect === 'function'
+      ? effectCtx.effect(setup, 'tuiQueue.subscribe')
+      : setup()
+    let disposed = false
+    return () => {
+      if (disposed) return
+      disposed = true
+      return release?.()
+    }
+  }
+
+  function observe(snapshot) {
+    if (!object(snapshot) || snapshot.protocol !== 0 || !Array.isArray(snapshot.items)) return false
+    const items = snapshot.items.map(normalizeItem).filter((item) => item !== null)
+    value = {
+      count: Number.isInteger(snapshot.count) && snapshot.count >= items.length
+        ? snapshot.count
+        : items.length,
+      items,
+      selectedId: idOrNull(snapshot.selectedId),
+      editingId: idOrNull(snapshot.editingId),
+      deleteConfirm: snapshot.deleteConfirm === true,
+    }
+    const next = current()
+    for (const listener of [...listeners]) listener(next)
+    return true
+  }
+
+  const core = { current, subscribe, observe }
+  const service = typeof ctx.provide === 'function'
+    ? new TuiQueueService(ctx, core)
+    : {
+        current,
+        subscribe(listener) { return subscribe(ctx, listener) },
+        observe,
+      }
+  if (typeof ctx.provide !== 'function') ctx.tuiQueue = service
+  return service
+}
+
+function normalizeItem(item) {
+  if (!object(item) || idOrNull(item.id) === null
+    || !Number.isInteger(item.ordinal) || item.ordinal < 1
+    || typeof item.summary !== 'string') return null
+  return { id: item.id, ordinal: item.ordinal, summary: item.summary }
+}
+
+function idOrNull(value) {
+  return (typeof value === 'string' && value.length > 0)
+    || (Number.isSafeInteger(value) && value >= 0)
+    ? value
+    : null
+}
+
+function object(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+export function apply(ctx) {
+  installTuiQueue(ctx)
+}

package/lib/tui-slots.js

@@ -14,6 +14,7 @@ export const SLOT_NAMES = Object.freeze([
   'welcome.info',
   'chrome.right',
   'conversation.input.dock',
+  'conversation.navigation.dock',
   'conversation.composer.dock',
 ])
 
@@ -22,6 +23,7 @@ const SLOT_DEFINITIONS = Object.freeze({
   'welcome.info': Object.freeze({ kind: 'single', scope: 'root' }),
   'chrome.right': Object.freeze({ kind: 'list', scope: 'root' }),
   'conversation.input.dock': Object.freeze({ kind: 'list', scope: 'session' }),
+  'conversation.navigation.dock': Object.freeze({ kind: 'list', scope: 'session' }),
   'conversation.composer.dock': Object.freeze({ kind: 'list', scope: 'session' }),
 })
 
@@ -64,7 +66,10 @@ const NODE_FIELDS = Object.freeze({
   markdown: { required: ['id', 'kind', 'text'], optional: ['streaming'] },
   reasoning: { required: ['id', 'kind', 'text', 'done'], optional: ['seconds'] },
   user: { required: ['id', 'kind', 'text'], optional: ['queued'] },
-  generic: { required: ['id', 'kind', 'title', 'body'], optional: ['status', 'action'] },
+  generic: {
+    required: ['id', 'kind', 'title', 'body'],
+    optional: ['status', 'tone', 'selected', 'action'],
+  },
   terminal: { required: ['id', 'kind', 'title', 'body'], optional: ['exit'] },
   diff: { required: ['id', 'kind', 'title', 'unified'], optional: ['path'] },
   image: { required: ['id', 'kind', 'name', 'mime'], optional: ['dataBase64'] },
@@ -168,9 +173,13 @@ function validateNode(node, path, ids) {
     case 'generic':
       string(node.title, `${path}.title`)
       string(node.body, `${path}.body`)
-      if (node.status !== undefined && !['running', 'ok', 'err'].includes(node.status)) {
-        throw new Error(`tuiSlots: ${path}.status must be running, ok, or err`)
+      if (node.status !== undefined && !['running', 'done', 'ok', 'err'].includes(node.status)) {
+        throw new Error(`tuiSlots: ${path}.status must be running, done, ok, or err`)
       }
+      if (node.tone !== undefined && !THEME_TOKENS.has(node.tone)) {
+        throw new Error(`tuiSlots: ${path}.tone must be a theme token`)
+      }
+      optionalBoolean(node.selected, `${path}.selected`)
       optionalAction(node.action, `${path}.action`)
       break
     case 'terminal':

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "martty",
-  "version": "0.2.21",
+  "version": "0.2.24",
   "description": "Terminal-native ACP client UI; Cordis client tree, any ACP agent",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/openma-ai/Martty.git"
   },
-  "homepage": "https://dshsuite.dev",
+  "homepage": "https://martty.sh",
   "bugs": {
     "url": "https://github.com/openma-ai/Martty/issues"
   },
@@ -15,7 +15,7 @@
   "main": "lib/index.js",
   "scripts": {
     "pretest": "node --test ../scripts/workflow-release.test.mjs ../scripts/package-alias.test.mjs",
-    "test": "node --test ../scripts/package-native.test.mjs ../scripts/check-release-tag.test.mjs ../scripts/check-static-elf.test.mjs ../scripts/smoke-old-linux.test.mjs ../scripts/cargo-guard.test.mjs ../scripts/build-npm.test.mjs ../scripts/client-profile.test.mjs ../scripts/plugin-runner.test.mjs ../scripts/profile-link-resolution.test.mjs ../scripts/profile-smoke-tui.test.mjs ../scripts/release.test.mjs ../scripts/jsonrpc-line-transport.test.mjs ../scripts/tui-theme.test.mjs ../scripts/tui-presets.test.mjs ../scripts/tui-plugin-store.test.mjs ../scripts/tui-local-plugins.test.mjs ../scripts/tui-client-plugin-registry.test.mjs ../scripts/tui-slots.test.mjs ../scripts/tui-commands.test.mjs ../scripts/tui-overlay.test.mjs ../scripts/mux.test.mjs ../scripts/acp-client.test.mjs ../scripts/acp-client-events.test.mjs ../scripts/acp-session-config.test.mjs ../scripts/acp-session-plan.test.mjs ../scripts/acp-session-stats.test.mjs ../scripts/acp-session-status.test.mjs ../scripts/plan-view.test.mjs ../scripts/stats-view.test.mjs ../scripts/status-view.test.mjs ../scripts/deepseek-logo.test.mjs ../scripts/runner.test.mjs ../scripts/inspect.test.mjs ../scripts/creator-overlay.test.mjs ../scripts/real-agent-e2e.test.mjs",
+    "test": "node --test ../scripts/package-native.test.mjs ../scripts/check-release-tag.test.mjs ../scripts/check-static-elf.test.mjs ../scripts/smoke-old-linux.test.mjs ../scripts/cargo-guard.test.mjs ../scripts/build-npm.test.mjs ../scripts/client-profile.test.mjs ../scripts/plugin-runner.test.mjs ../scripts/profile-link-resolution.test.mjs ../scripts/profile-smoke-tui.test.mjs ../scripts/release.test.mjs ../scripts/jsonrpc-line-transport.test.mjs ../scripts/tui-theme.test.mjs ../scripts/tui-presets.test.mjs ../scripts/tui-plugin-store.test.mjs ../scripts/tui-local-plugins.test.mjs ../scripts/tui-client-plugin-registry.test.mjs ../scripts/tui-slots.test.mjs ../scripts/tui-commands.test.mjs ../scripts/tui-overlay.test.mjs ../scripts/tui-agents.test.mjs ../scripts/tui-queue.test.mjs ../scripts/mux.test.mjs ../scripts/acp-client.test.mjs ../scripts/acp-client-events.test.mjs ../scripts/acp-session-config.test.mjs ../scripts/acp-session-plan.test.mjs ../scripts/acp-session-stats.test.mjs ../scripts/acp-session-status.test.mjs ../scripts/agents-view.test.mjs ../scripts/plan-view.test.mjs ../scripts/queue-view.test.mjs ../scripts/stats-view.test.mjs ../scripts/status-view.test.mjs ../scripts/deepseek-logo.test.mjs ../scripts/runner.test.mjs ../scripts/inspect.test.mjs ../scripts/creator-overlay.test.mjs ../scripts/real-agent-e2e.test.mjs",
     "test:profile-install-matrix": "node --test ../scripts/profile-install-matrix.test.mjs"
   },
   "publishConfig": {
@@ -30,10 +30,14 @@
     "./slots": "./lib/tui-slots.js",
     "./commands": "./lib/tui-commands.js",
     "./overlay": "./lib/tui-overlay.js",
+    "./agents": "./lib/tui-agents.js",
+    "./agents-view": "./lib/agents-view.js",
+    "./queue": "./lib/tui-queue.js",
     "./session-plan": "./lib/acp-session-plan.js",
     "./session-stats": "./lib/acp-session-stats.js",
     "./session-status": "./lib/acp-session-status.js",
     "./plan-view": "./lib/plan-view.js",
+    "./queue-view": "./lib/queue-view.js",
     "./stats-view": "./lib/stats-view.js",
     "./status-view": "./lib/status-view.js",
     "./deepseek-logo": "./lib/deepseek-logo.js",
@@ -71,7 +75,7 @@
   },
   "dependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@openma/deepseek-harness-acp": "0.4.22"
+    "@openma/deepseek-harness-acp": "0.4.25"
   },
   "devDependencies": {
     "@deepseek-ai/dsh": "0.1.1-rc.2"