martty 0.2.13 → 0.2.15-beta.0

package/README.md

@@ -85,6 +85,8 @@ dsh-tui --demo-skin
   platform-native modifier bindings, mouse selection, and inline-expanded tools.
 - Dark/light themes, clipboard routing for local, tmux, and SSH sessions, plus
   the optional `/liang` pixel companion.
+- A built-in `/deepseeklogo` Client Plugin that opens the classic DeepSeek
+  Harness whale as a semantic overlay without writing to the transcript.
 - A root `chrome.right` plugin rail for validated TuiNode trees, with live
   update/unload and Client inspect support for Creator-authored plugins.
 - Lifecycle-owned local commands and native slider overlays, plus transactions

package/lib/acp-session-status.js

@@ -0,0 +1,276 @@
+/**
+ * Standard-ACP-backed run-state projection for the Client tree.
+ *
+ * Folds the non-statistics facts `/status` needs — connection, server,
+ * authenticate state, session binding, model, effort, permission, plan,
+ * agent preset, and the running/idle state — from messages the mux already
+ * observes. Statistics stay in `acpSessionStats`; this service never
+ * counts tokens or timings, so there is exactly one stats source.
+ */
+
+import { Service } from '@deepseek-ai/cordis'
+
+export const name = 'acp-session-status'
+export const inject = ['acpClientEvents', 'acpSessionConfig']
+
+const AUTH_REQUIRED_CODE = -32000
+const SETUP_METHODS = new Set(['session/new', 'session/load'])
+const RUNNING_UPDATE_TYPES = new Set([
+  'agent_message_chunk',
+  'agent_thought_chunk',
+  'tool_call',
+])
+
+class AcpSessionStatusService extends Service {
+  constructor(ctx, core) {
+    super(ctx, 'acpSessionStatus')
+    this.core = core
+  }
+
+  current() { return this.core.current() }
+  subscribe(listener) { return this.core.subscribe(this.ctx, listener) }
+  observeClient(message) { return this.core.observeClient(message) }
+  observeAgent(message) { return this.core.observeAgent(message) }
+}
+
+function zero() {
+  return {
+    state: 'idle',
+    connection: 'connecting',
+    server: undefined,
+    auth: { status: undefined, method: undefined },
+    session: { sessionId: undefined, bound: false },
+    model: undefined,
+    effort: undefined,
+    permission: undefined,
+    plan: undefined,
+    agent: undefined,
+  }
+}
+
+export function installAcpSessionStatus(ctx, options = {}) {
+  const events = options.events ?? ctx.acpClientEvents ?? ctx.get?.('acpClientEvents')
+  const sessionConfig = options.sessionConfig
+    ?? ctx.acpSessionConfig ?? ctx.get?.('acpSessionConfig')
+
+  const listeners = new Set()
+  let value = zero()
+  let initializeId
+  let pendingAuthenticate = new Set()
+  const pendingSetup = new Map()
+  let permissionPreset
+  let sandboxMode
+
+  function current() { return structuredClone(value) }
+
+  function publish() {
+    const snapshot = current()
+    for (const listener of [...listeners]) listener(snapshot)
+  }
+
+  function subscribe(effectCtx, listener) {
+    if (typeof listener !== 'function') {
+      throw new Error('acpSessionStatus.subscribe: listener must be a function')
+    }
+    const setup = () => {
+      listeners.add(listener)
+      return () => listeners.delete(listener)
+    }
+    const release = typeof effectCtx?.effect === 'function'
+      ? effectCtx.effect(setup, 'acpSessionStatus.subscribe')
+      : setup()
+    let disposed = false
+    return () => {
+      if (disposed) return
+      disposed = true
+      return release?.()
+    }
+  }
+
+  function observeClient(message) {
+    if (!object(message) || typeof message.method !== 'string') return
+    if (message.method === 'initialize' && message.id !== undefined) {
+      initializeId = message.id
+      return
+    }
+    if (message.method === 'authenticate' && message.id !== undefined) {
+      pendingAuthenticate.add(message.id)
+      value.auth.status = 'signing in'
+      publish()
+      return
+    }
+    if (SETUP_METHODS.has(message.method) && message.id !== undefined) {
+      pendingSetup.set(
+        message.id,
+        message.method === 'session/load'
+          ? readString(message.params, 'sessionId', 'session_id')
+          : undefined,
+      )
+      return
+    }
+    if (message.method === 'session/prompt' && value.state === 'idle') {
+      value.state = 'starting'
+      publish()
+    }
+  }
+
+  function observeAgent(message) {
+    if (!object(message)) return
+    if (message.id !== undefined && message.id === initializeId) {
+      initializeId = undefined
+      value.connection = 'attached'
+      const result = object(message.result) ? message.result : undefined
+      value.server = readString(result?.agentInfo, 'name')
+      const methods = Array.isArray(result?.authMethods) ? result.authMethods : []
+      const method = methods.find((candidate) => object(candidate)
+        && typeof candidate.id === 'string' && candidate.id.length > 0)
+      if (method !== undefined && value.auth.status === undefined) {
+        value.auth.method = readString(method, 'name', 'label') ?? method.id
+      }
+      publish()
+      return
+    }
+    if (message.id !== undefined && pendingAuthenticate.has(message.id)) {
+      pendingAuthenticate.delete(message.id)
+      if (message.error === undefined) {
+        value.auth.status = 'configured'
+      } else if (isAuthRequired(message.error)) {
+        value.auth.status = 'needs sign-in'
+      } else {
+        value.auth.status = undefined
+      }
+      publish()
+      return
+    }
+    if (message.id !== undefined && pendingSetup.has(message.id)) {
+      const requested = pendingSetup.get(message.id)
+      pendingSetup.delete(message.id)
+      if (message.error !== undefined) {
+        if (isAuthRequired(message.error)) value.auth.status = 'needs sign-in'
+        value.session = { sessionId: requested, bound: false }
+      } else {
+        const sessionId = readString(message.result, 'sessionId', 'session_id') ?? requested
+        value.session = { sessionId, bound: sessionId !== undefined }
+      }
+      publish()
+      return
+    }
+    if (message.error !== undefined && isAuthRequired(message.error)) {
+      value.auth.status = 'needs sign-in'
+      publish()
+      return
+    }
+
+    if (message.method === 'session.status' && object(message.params)) {
+      const status = readString(message.params, 'status')
+      if (status === 'running' || status === 'idle') {
+        value.state = status
+        publish()
+      }
+      return
+    }
+    if (message.method === 'session.event' && object(message.params)) {
+      const event = object(message.params.event) ? message.params.event : undefined
+      const type = readString(event, 'type')
+      const data = object(event?.data) ? event.data : undefined
+      if (type === 'permission/preset') {
+        const preset = readString(data, 'preset')
+        if (preset !== undefined) {
+          permissionPreset = preset
+          value.permission = permissionPreset ?? sandboxMode
+          publish()
+        }
+      } else if (type === 'sandbox/mode') {
+        const mode = readString(data, 'mode')
+        if (mode !== undefined) {
+          sandboxMode = mode
+          value.permission = permissionPreset ?? sandboxMode
+          publish()
+        }
+      } else if (type === 'plan/mode' && typeof data?.active === 'boolean') {
+        value.plan = data.active
+        publish()
+      } else if (type === 'agent-preset/selected') {
+        const preset = readString(data, 'agentPreset')
+        if (preset !== undefined) {
+          value.agent = preset
+          publish()
+        }
+      }
+      return
+    }
+    if (message.method !== 'session/update' || !object(message.params)) return
+    const update = object(message.params.update) ? message.params.update : undefined
+    const type = readString(update, 'sessionUpdate', 'session_update')
+    if (value.state === 'starting' && RUNNING_UPDATE_TYPES.has(type)) {
+      value.state = 'running'
+      publish()
+    }
+  }
+
+  function onConfigSnapshot(snapshot) {
+    if (snapshot === null || typeof snapshot !== 'object') return
+    if (typeof snapshot.sessionId === 'string' && snapshot.sessionId.length > 0
+      && value.session.sessionId === undefined) {
+      value.session = { sessionId: snapshot.sessionId, bound: true }
+    }
+    value.model = optionValue(snapshot.options, 'model') ?? value.model
+    value.effort = optionValue(snapshot.options, 'effort') ?? value.effort
+    publish()
+  }
+
+  function optionValue(options, id) {
+    if (!Array.isArray(options)) return undefined
+    const option = options.find((candidate) => candidate?.id === id)
+    if (option === undefined) return undefined
+    const raw = option.currentValue ?? option.current_value
+    return typeof raw === 'string' ? raw : undefined
+  }
+
+  const core = { current, subscribe, observeClient, observeAgent }
+  const service = typeof ctx.provide === 'function'
+    ? new AcpSessionStatusService(ctx, core)
+    : {
+        current,
+        subscribe(listener) { return subscribe(ctx, listener) },
+        observeClient,
+        observeAgent,
+      }
+  if (typeof ctx.provide !== 'function') ctx.acpSessionStatus = service
+
+  if (typeof sessionConfig?.subscribe === 'function') {
+    sessionConfig.subscribe(onConfigSnapshot)
+  }
+  // Seed model/effort from anything already folded (session/load replay).
+  if (typeof sessionConfig?.list === 'function') {
+    onConfigSnapshot({ sessionId: undefined, options: sessionConfig.list() })
+  }
+  if (typeof events?.register === 'function') {
+    // register(observer) only: the service scopes the subscription to its
+    // own Context, so pass the folding object alone.
+    events.register({ observeClient, observeAgent })
+  }
+
+  return service
+}
+
+function isAuthRequired(error) {
+  return object(error) && (error.code === AUTH_REQUIRED_CODE
+    || error.code === 'auth_required' || error.code === 'AuthRequired')
+}
+
+function readString(value, ...keys) {
+  if (!object(value)) return undefined
+  for (const key of keys) {
+    if (typeof value[key] === 'string' && value[key].length > 0) return value[key]
+  }
+  return undefined
+}
+
+function object(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+export function apply(ctx, options = {}) {
+  installAcpSessionStatus(ctx, options)
+}

package/lib/boot.js

@@ -16,6 +16,9 @@ import { apply as applyCommands } from './tui-commands.js'
 import { apply as applyOverlay } from './tui-overlay.js'
 import { apply as applyPlanView, inject as planViewInject } from './plan-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'
+import { apply as applyDeepseekLogo, inject as deepseekLogoInject } from './deepseek-logo.js'
 
 /**
  * @param {object} [options]
@@ -37,11 +40,14 @@ export async function bootClient(options = {}) {
     await ctx.plugin({ name: 'acp-client', inject: [], apply: applyAcpClient }, acpConfig)
     await ctx.plugin({ name: 'plan-view', inject: planViewInject, apply: applyPlanView })
     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 })
+    await ctx.plugin({ name: 'deepseek-logo', inject: deepseekLogoInject, apply: applyDeepseekLogo })
     await ctx.plugin({
       name: 'tui-cordis-client-runner',
       inject: [
         'tuiTheme', 'tuiSlots', 'tuiCommands', 'tuiOverlay', 'acpSessionConfig',
-        'acpSessionPlan', 'acpSessionStats',
+        'acpSessionPlan', 'acpSessionStats', 'acpSessionStatus',
       ],
       apply: applyCordisClientRunner,
     })
@@ -64,6 +70,9 @@ export async function bootClient(options = {}) {
     applyAcpClient(ctx, acpConfig)
     applyPlanView(ctx)
     applyStatsView(ctx)
+    applySessionStatus(ctx)
+    applyStatusView(ctx)
+    applyDeepseekLogo(ctx)
     applyCordisClientRunner(ctx)
     await applyShell(ctx, { extraArgs: options.extraArgs ?? [], tty: options.tty })
   }

package/lib/client-run.js

@@ -3,7 +3,8 @@
  *
  * Same closure convention as the web runner: the source is an async function
  * body that returns a plugin. Open services include `tuiTheme`, `tuiSlots`,
- * `acpSessionConfig`, `acpSessionPlan`, `acpSessionStats`, and lifecycle-owned `timer`; `host.call` reaches this
+ * `acpSessionConfig`, `acpSessionPlan`, `acpSessionStats`, `acpSessionStatus`,
+ * and lifecycle-owned `timer`; `host.call` reaches this
  * Package's Host half.
  * No React, browser slots, TTY, or raw Host service names.
  */
@@ -16,6 +17,7 @@ const ALLOWED_INJECT = new Set([
   'acpSessionConfig',
   'acpSessionPlan',
   'acpSessionStats',
+  'acpSessionStatus',
   'timer',
 ])
 
@@ -32,7 +34,7 @@ const SLOT_TEACHING =
 
 /**
  * @param {string} clientCode
- * @param {{ pluginId?: string, tuiTheme?: object, tuiSlots?: object, tuiCommands?: object, tuiOverlay?: object, acpSessionConfig?: object, acpSessionPlan?: object, acpSessionStats?: object, timer?: object, invoke?: Function }} env
+ * @param {{ pluginId?: string, tuiTheme?: object, tuiSlots?: object, tuiCommands?: object, tuiOverlay?: object, acpSessionConfig?: object, acpSessionPlan?: object, acpSessionStats?: object, acpSessionStatus?: object, timer?: object, invoke?: Function }} env
  * @returns {Promise<{ waitingFor: string[], dispose: () => void }>}
  */
 export async function applyClientHalf(clientCode, env) {
@@ -84,7 +86,7 @@ export async function applyClientHalf(clientCode, env) {
     }
     if (!ALLOWED_INJECT.has(name)) {
       throw new Error(
-        `TUI Client inject "${name}" is not open. Open services: tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan, acpSessionStats, timer.`,
+        `TUI Client inject "${name}" is not open. Open services: tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan, acpSessionStats, acpSessionStatus, timer.`,
       )
     }
   }
@@ -137,6 +139,7 @@ function restrictedCtx(env, own, inject) {
   const sourceSessionConfig = env.acpSessionConfig
   const sourceSessionPlan = env.acpSessionPlan
   const sourceSessionStats = env.acpSessionStats
+  const sourceSessionStatus = env.acpSessionStatus
   const sourceTimer = env.timer
   const tuiTheme = sourceTheme === undefined
     ? undefined
@@ -254,6 +257,16 @@ function restrictedCtx(env, own, inject) {
           return own(sourceSessionStats.subscribe(listener))
         },
       }
+  const acpSessionStatus = sourceSessionStatus === undefined
+    ? undefined
+    : {
+        current() {
+          return sourceSessionStatus.current()
+        },
+        subscribe(listener) {
+          return own(sourceSessionStatus.subscribe(listener))
+        },
+      }
   const timer = sourceTimer === undefined || !inject.has('timer')
     ? undefined
     : {
@@ -272,6 +285,7 @@ function restrictedCtx(env, own, inject) {
     acpSessionConfig,
     acpSessionPlan,
     acpSessionStats,
+    acpSessionStatus,
     timer,
     interval: timer?.interval,
     timeout: timer?.timeout,
@@ -283,6 +297,7 @@ function restrictedCtx(env, own, inject) {
       if (name === 'acpSessionConfig') return acpSessionConfig
       if (name === 'acpSessionPlan') return acpSessionPlan
       if (name === 'acpSessionStats') return acpSessionStats
+      if (name === 'acpSessionStatus') return acpSessionStatus
       if (name === 'timer') return timer
       return undefined
     },

package/lib/deepseek-logo.js

@@ -0,0 +1,62 @@
+/** Built-in Client Plugin: the classic DeepSeek Harness whale lockup. */
+
+export const name = 'deepseek-logo'
+export const inject = ['tuiCommands', 'tuiOverlay']
+
+const WHALE_LG = [
+  '          ▄▄▄▄ ▄▄▄███      █▄',
+  '     ▄▄█████████████       ███▄▄     ▄█',
+  '   ▄█████████████████▄▄    █████▄██████',
+  '  ▄█████████████████████▄  ▀██████████',
+  ' ▄████████████████████████▄  ▀████▀▀▀',
+  ' ██▀    ▀▀▀██████████▀▀█████▄████',
+  ' ███         ▀███████▀▄ ▀████████',
+  ' ███           ▀███████   ██████▀',
+  ' ████            ▀██████████████',
+  '  ████            ▀████████████',
+  '   ████▄     ▄▄▄    █████████▀',
+  '    ▀████▄    ███▄▄  ▀██████▄',
+  '      ▀█████████████▄▄▄████████',
+  '        ▀▀████████████▀▀',
+  '             ▀▀▀▀▀▀',
+]
+
+const WORDMARK_SMALL = [
+  ' ___  ___ ___ ___  ___ ___ ___ _  __',
+  '|   \\| __| __| _ \\/ __| __| __| |/ /',
+  '| |) | _|| _||  _/\\__ \\ _|| _|| \' < ',
+  '|___/|___|___|_|  |___/___|___|_|\\_\\',
+]
+
+export function deepseekLogoMarkdown() {
+  return [
+    '## DeepSeek Harness',
+    '',
+    '```text',
+    ...WHALE_LG,
+    '',
+    ...WORDMARK_SMALL,
+    'H A R N E S S',
+    '```',
+    '',
+    '_Into the Unknown_',
+  ].join('\n')
+}
+
+export function apply(ctx) {
+  const stopCommand = ctx.tuiCommands.register({
+    name: 'deepseeklogo',
+    description: 'Open the classic DeepSeek Harness whale',
+  }, async () => {
+    ctx.tuiOverlay.openView({
+      id: 'deepseek-logo',
+      title: 'DeepSeek Harness',
+      nodes: [{
+        id: 'lockup',
+        kind: 'markdown',
+        text: deepseekLogoMarkdown(),
+      }],
+    })
+  })
+  return () => stopCommand?.()
+}

package/lib/inspect.js

@@ -10,7 +10,7 @@ import { CORDIS_METHODS } from './cordis-protocol.js'
 export const name = 'tui-cordis-client-runner'
 export const inject = [
   'tuiTheme', 'tuiSlots', 'tuiCommands', 'tuiOverlay', 'acpSessionConfig',
-  'acpSessionPlan', 'acpSessionStats',
+  'acpSessionPlan', 'acpSessionStats', 'acpSessionStatus',
 ]
 
 const EMPTY_INPUT = Object.freeze({ type: 'object', properties: {}, additionalProperties: false })
@@ -589,6 +589,45 @@ export function statsInspectProvider(acpSessionStats) {
   }
 }
 
+/** Describe non-statistics run-state facts folded from standard ACP. */
+export function statusInspectProvider(acpSessionStatus) {
+  return {
+    manifest: {
+      id: 'Status',
+      description:
+        'Current ACP run-state facts (connection, server, auth, session, model, '
+        + 'effort, permission, plan, agent) folded from standard ACP traffic. '
+        + 'Statistics stay in the Stats provider.',
+      methods: [{
+        name: 'current',
+        description: 'Return the current status snapshot and the read/subscribe contract.',
+        inputSchema: EMPTY_INPUT,
+        outputSchema: ANY_OUTPUT,
+      }],
+    },
+    query(method) {
+      if (method !== 'current') throw new Error(`unknown Status inspect method "${method}"`)
+      return {
+        current: acpSessionStatus.current(),
+        api: {
+          service: 'acpSessionStatus',
+          inject: ['acpSessionStatus'],
+          current: {
+            call: 'ctx.acpSessionStatus.current()',
+            returns: 'SessionStatusSnapshot',
+          },
+          subscribe: {
+            call: 'ctx.acpSessionStatus.subscribe((snapshot) => { ... })',
+            returns: { type: 'function', role: 'dispose', idempotent: true },
+          },
+          transport: 'standard ACP initialize, authenticate, session and session/update messages',
+        },
+        referencedTypes: ['SessionStatusSnapshot'],
+      }
+    },
+  }
+}
+
 async function mountClientHalf(
   ctx,
   pluginId,
@@ -600,6 +639,7 @@ async function mountClientHalf(
   acpSessionConfig,
   acpSessionPlan,
   acpSessionStats,
+  acpSessionStatus,
   timer,
   invoke,
 ) {
@@ -607,7 +647,7 @@ async function mountClientHalf(
     return applyClientHalf(clientCode, {
       pluginId,
       tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
-      acpSessionStats, timer, invoke,
+      acpSessionStats, acpSessionStatus, timer, invoke,
     })
   }
 
@@ -619,7 +659,7 @@ async function mountClientHalf(
       applied = await applyClientHalf(clientCode, {
         pluginId,
         tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
-        acpSessionStats, timer, invoke,
+        acpSessionStats, acpSessionStatus, timer, invoke,
       })
       return applied.dispose
     },
@@ -650,6 +690,7 @@ async function mountClientHalf(
  *   acpSessionConfig?: object,
  *   acpSessionPlan?: object,
  *   acpSessionStats?: object,
+ *   acpSessionStatus?: object,
  *   requestAgent: (method: string, params?: object) => Promise<unknown>,
  * }} opts
  * @returns {{ onHost: (message: object) => void }}
@@ -657,7 +698,7 @@ async function mountClientHalf(
 export function attachTuiClient(opts) {
   const {
     ctx, tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
-    acpSessionStats,
+    acpSessionStats, acpSessionStatus,
     requestAgent,
   } = opts
   const providers = [
@@ -668,6 +709,7 @@ export function attachTuiClient(opts) {
     ...(acpSessionConfig === undefined ? [] : [configOptionsInspectProvider(acpSessionConfig)]),
     ...(acpSessionPlan === undefined ? [] : [planInspectProvider(acpSessionPlan)]),
     ...(acpSessionStats === undefined ? [] : [statsInspectProvider(acpSessionStats)]),
+    ...(acpSessionStatus === undefined ? [] : [statusInspectProvider(acpSessionStatus)]),
   ]
   const timer = createClientTimer()
   /** @type {Map<string, () => void>} */
@@ -765,6 +807,7 @@ export function attachTuiClient(opts) {
         acpSessionConfig,
         acpSessionPlan,
         acpSessionStats,
+        acpSessionStatus,
         timer,
         async (method, args) => {
           const answered = await requestAgent(CORDIS_METHODS.pluginInvoke, {
@@ -933,13 +976,14 @@ export function apply(ctx) {
   const acpSessionConfig = ctx.acpSessionConfig ?? ctx.get?.('acpSessionConfig')
   const acpSessionPlan = ctx.acpSessionPlan ?? ctx.get?.('acpSessionPlan')
   const acpSessionStats = ctx.acpSessionStats ?? ctx.get?.('acpSessionStats')
+  const acpSessionStatus = ctx.acpSessionStatus ?? ctx.get?.('acpSessionStatus')
   let client
   const service = {
     bindTransport(requestAgent) {
       client?.dispose()
       client = attachTuiClient({
         ctx, tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
-        acpSessionStats,
+        acpSessionStats, acpSessionStatus,
         requestAgent,
       })
       const attached = client

package/lib/plan-view.js

@@ -75,18 +75,23 @@ function viewNodes(plan) {
   if (plan.kind === 'file') {
     return [{ id: 'file', kind: 'notice', level: 'info', text: plan.uri }]
   }
-  return plan.entries.map((entry, index) => ({
-    id: `step-${index + 1}`,
-    kind: 'generic',
-    title: entry.content,
-    body: entry.priority ? `priority · ${entry.priority}` : '',
-    ...nodeStatus(entry.status),
-  }))
-}
-
-function nodeStatus(status) {
-  if (status === 'completed') return { status: 'ok' }
-  if (status === 'in_progress') return { status: 'running' }
-  if (status === 'cancelled' || status === 'failed') return { status: 'err' }
-  return {}
+  // Items render as one markdown node: a task-list review the transcript
+  // pipeline can fully render (headings, bold, strikethrough).
+  const total = plan.entries.length
+  const completed = plan.entries.filter((entry) => entry.status === 'completed').length
+  const lines = [`## Plan · ${completed}/${total}`, '']
+  for (const entry of plan.entries) {
+    const content = entry.content.replace(/\s*\n\s*/g, ' ')
+    let item
+    if (entry.status === 'completed') {
+      item = `- [x] ${content}`
+    } else if (entry.status === 'cancelled' || entry.status === 'failed') {
+      item = `- [ ] ~~${content}~~`
+    } else {
+      item = entry.status === 'in_progress' ? `- [ ] **${content}**` : `- [ ] ${content}`
+    }
+    if (entry.priority) item += ` · priority · ${entry.priority}`
+    lines.push(item)
+  }
+  return [{ id: 'content', kind: 'markdown', text: lines.join('\n') }]
 }

package/lib/stats-view.js

@@ -87,4 +87,4 @@ function formatRate(value) {
   return String(Math.round(value * 10) / 10)
 }
 
-export { formatDuration, formatTokens, nodesOf }
+export { formatDuration, formatRate, formatTokens, nodesOf }

package/lib/status-view.js

@@ -0,0 +1,70 @@
+/** Built-in Client Plugin: the `/status` run-state overlay. */
+
+import { formatDuration, formatRate, formatTokens } from './stats-view.js'
+
+export const name = 'status-view'
+export const inject = ['acpSessionStatus', 'acpSessionStats', 'tuiCommands', 'tuiOverlay']
+
+export function apply(ctx) {
+  const stopCommand = ctx.tuiCommands.register({
+    name: 'status',
+    description: 'Session run state and key stats',
+  }, async () => {
+    ctx.tuiOverlay.openView({
+      id: 'status',
+      title: 'Status',
+      nodes: [{
+        id: 'content',
+        kind: 'markdown',
+        text: statusMarkdown(
+          ctx.acpSessionStatus.current(),
+          ctx.acpSessionStats.current(),
+        ),
+      }],
+    })
+  })
+  return () => stopCommand?.()
+}
+
+/**
+ * One `## status` markdown node. Run-state facts come from
+ * `acpSessionStatus`; every token/turn/step/timing fact comes from
+ * `acpSessionStats.current()` — the same snapshot `stats-view` renders in
+ * the composer dock, so the two readouts can never drift apart.
+ */
+function statusMarkdown(status, stats) {
+  const usage = stats?.usage ?? {}
+  const folded = stats?.stats ?? {}
+  const total = (usage.input ?? 0) + (usage.output ?? 0)
+    + (usage.cached ?? 0) + (usage.reasoning ?? 0)
+  const lines = ['## status', '']
+  lines.push(`- state · ${status.state ?? 'idle'}`)
+  lines.push(`- acp · ${status.connection ?? 'not attached'}`)
+  if (status.auth?.status !== undefined) {
+    lines.push(`- auth · ${status.auth.status}${status.auth.method ? ` · ${status.auth.method}` : ''}`)
+  }
+  lines.push(`- session · ${status.session?.bound ? status.session.sessionId : 'unbound'}`)
+  if (status.server !== undefined) lines.push(`- server · ${status.server}`)
+  if (status.model !== undefined) lines.push(`- model · ${status.model}`)
+  if (status.agent !== undefined) lines.push(`- agent · ${status.agent}`)
+  if (status.permission !== undefined) lines.push(`- permission · ${status.permission}`)
+  if (status.plan !== undefined) lines.push(`- plan · ${status.plan ? 'on' : 'off'}`)
+  if (status.effort !== undefined) lines.push(`- effort · ${status.effort}`)
+  lines.push(
+    `- tokens · ↑${formatTokens(usage.input ?? 0)} ↓${formatTokens(usage.output ?? 0)}`
+    + ` (cached ${formatTokens(usage.cached ?? 0)}) · Σ ${formatTokens(total)}`,
+  )
+  lines.push(`- turns · ${folded.turns ?? 0} · steps · ${folded.steps ?? 0}`)
+  lines.push(`- LLM · ${formatDuration(folded.llmMillis ?? 0)} · tool · ${formatDuration(folded.toolMillis ?? 0)}`)
+  if ((folded.ttftCount ?? 0) > 0) {
+    lines.push(`- TTFT avg · ${formatDuration(folded.ttftTotalMillis / folded.ttftCount)}`)
+  }
+  const llmMillis = folded.llmMillis ?? 0
+  const output = usage.output ?? 0
+  if (llmMillis > 0 && output > 0) {
+    lines.push(`- rate · ${formatRate(output / (llmMillis / 1000))} tok/s`)
+  }
+  return lines.join('\n')
+}
+
+export { statusMarkdown }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "martty",
-  "version": "0.2.13",
+  "version": "0.2.15-beta.0",
   "description": "Terminal-native ACP client UI; Cordis client tree, any ACP agent",
   "license": "MIT",
   "repository": {
@@ -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/release.test.mjs ../scripts/jsonrpc-line-transport.test.mjs ../scripts/tui-theme.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/plan-view.test.mjs ../scripts/stats-view.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/release.test.mjs ../scripts/jsonrpc-line-transport.test.mjs ../scripts/tui-theme.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"
   },
   "publishConfig": {
     "access": "public",
@@ -30,8 +30,11 @@
     "./overlay": "./lib/tui-overlay.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",
     "./stats-view": "./lib/stats-view.js",
+    "./status-view": "./lib/status-view.js",
+    "./deepseek-logo": "./lib/deepseek-logo.js",
     "./right-demo": "./lib/right-demo.js",
     "./acp-client": "./lib/acp-client.js",
     "./acp-client-events": "./lib/acp-client-events.js",

package/skills/tui-plugin-development/SKILL.md

@@ -62,6 +62,7 @@ Use the narrowest capability:
 | Current ACP Session option | advertised config-option Provider | `acpSessionConfig` |
 | Current structured ACP Plan | `Plans` | `acpSessionPlan` |
 | Current ACP Session statistics | `Stats` | `acpSessionStats` |
+| Current ACP run-state facts | `Status` | `acpSessionStatus` |
 
 A transient control is not a side panel. When the user did not request
 persistent content, do not query Slots or mount `chrome.right`.
@@ -92,7 +93,8 @@ compose only in the Plugin code. The services do not imply one another:
   asked for persistent shell UI. Use stable node ids and update the existing
   contribution instead of creating parallel panels. Select the live seat from
   `Slots.list`: all current seats aggregate contributors. Use
-  `conversation.input.dock` for content needing its own line and keep
+  `conversation.input.dock` for content needing its own line (it owns the
+  single cap row and displaces the tip line while present) and keep
   `conversation.composer.dock` contributions compact.
 - **Overlays:** open a transient native control only in response to the
   interaction that needs it. A command is one possible trigger, not part of