martty 0.2.15-beta.1 → 0.2.16

package/README.md

@@ -85,8 +85,9 @@ 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.
+- Persistent UI Presets selected with the native `/ui` picker (or `/ui <id>`): builtin Martty and the classic
+  DeepSeek Harness composition, both assembled from independent welcome Hero
+  and information slots 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/boot.js

@@ -7,6 +7,8 @@
  */
 
 import { apply as applyAcpClient } from './acp-client.js'
+import { homedir } from 'node:os'
+import path from 'node:path'
 import { apply as applyCordisClientRunner } from './inspect.js'
 import { apply as applyShell } from './index.js'
 import { resolveStackedAgent } from './agent.js'
@@ -14,6 +16,8 @@ import { apply as applySlots } from './tui-slots.js'
 import { apply as applyTheme } from './tui-theme.js'
 import { apply as applyCommands } from './tui-commands.js'
 import { apply as applyOverlay } from './tui-overlay.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 applyStatsView, inject as statsViewInject } from './stats-view.js'
 import { apply as applySessionStatus, inject as sessionStatusInject } from './acp-session-status.js'
@@ -32,11 +36,16 @@ export async function bootClient(options = {}) {
   const acpConfig = options.stream !== undefined
     ? { stream: options.stream }
     : { agent: options.agent ?? resolveStackedAgent() }
+  const presetConfig = {
+    settingsPath: options.settingsPath ?? uiSettingsPath(options.extraArgs ?? []),
+  }
   if (typeof ctx.plugin === 'function') {
     await ctx.plugin({ name: 'tui-theme', inject: [], apply: applyTheme })
     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-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: 'stats-view', inject: statsViewInject, apply: applyStatsView })
@@ -46,7 +55,7 @@ export async function bootClient(options = {}) {
     await ctx.plugin({
       name: 'tui-cordis-client-runner',
       inject: [
-        'tuiTheme', 'tuiSlots', 'tuiCommands', 'tuiOverlay', 'acpSessionConfig',
+        'tuiTheme', 'tuiPresets', 'tuiSlots', 'tuiCommands', 'tuiOverlay', 'acpSessionConfig',
         'acpSessionPlan', 'acpSessionStats', 'acpSessionStatus',
       ],
       apply: applyCordisClientRunner,
@@ -67,6 +76,8 @@ export async function bootClient(options = {}) {
     applySlots(ctx)
     applyCommands(ctx)
     applyOverlay(ctx)
+    applyPresets(ctx, presetConfig)
+    applyMarttyPreset(ctx)
     applyAcpClient(ctx, acpConfig)
     applyPlanView(ctx)
     applyStatsView(ctx)
@@ -79,6 +90,15 @@ export async function bootClient(options = {}) {
   return ctx
 }
 
+export function uiSettingsPath(extraArgs = []) {
+  for (let index = 0; index < extraArgs.length; index += 1) {
+    if (extraArgs[index] === '--session-root' && typeof extraArgs[index + 1] === 'string') {
+      return path.join(extraArgs[index + 1], 'dsh-tui-settings.json')
+    }
+  }
+  return path.join(homedir(), '.dsh-tui', 'sessions', 'dsh-tui-settings.json')
+}
+
 /**
  * Parse `--agent` / `--agent-arg` from argv. Remaining flags pass through to Rust.
  * `--agent` is also forwarded via {@link painterArgs} so Terminal Auth can

package/lib/client-run.js

@@ -2,7 +2,7 @@
  * Evaluate a Cordis `code.client` function body on the TUI client tree.
  *
  * Same closure convention as the web runner: the source is an async function
- * body that returns a plugin. Open services include `tuiTheme`, `tuiSlots`,
+ * body that returns a plugin. Open services include `tuiTheme`, `tuiPresets`, `tuiSlots`,
  * `acpSessionConfig`, `acpSessionPlan`, `acpSessionStats`, `acpSessionStatus`,
  * and lifecycle-owned `timer`; `host.call` reaches this
  * Package's Host half.
@@ -11,6 +11,7 @@
 
 const ALLOWED_INJECT = new Set([
   'tuiTheme',
+  'tuiPresets',
   'tuiSlots',
   'tuiCommands',
   'tuiOverlay',
@@ -86,7 +87,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, acpSessionStatus, timer.`,
+        `TUI Client inject "${name}" is not open. Open services: tuiTheme, tuiPresets, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan, acpSessionStats, acpSessionStatus, timer.`,
       )
     }
   }
@@ -133,6 +134,7 @@ function normalizePlugin(value) {
 
 function restrictedCtx(env, own, inject) {
   const sourceTheme = env.tuiTheme
+  const sourcePresets = env.tuiPresets
   const sourceSlots = env.tuiSlots
   const sourceCommands = env.tuiCommands
   const sourceOverlay = env.tuiOverlay
@@ -183,6 +185,19 @@ function restrictedCtx(env, own, inject) {
           return sourceSlots.list()
         },
       }
+  const tuiPresets = sourcePresets === undefined
+    ? undefined
+    : {
+        register(options, mount) {
+          return own(sourcePresets.register(options, mount))
+        },
+        list() {
+          return sourcePresets.list()
+        },
+        active() {
+          return sourcePresets.active()
+        },
+      }
   const tuiCommands = sourceCommands === undefined
     ? undefined
     : {
@@ -279,6 +294,7 @@ function restrictedCtx(env, own, inject) {
       }
   return {
     tuiTheme,
+    tuiPresets,
     tuiSlots,
     tuiCommands,
     tuiOverlay,
@@ -291,6 +307,7 @@ function restrictedCtx(env, own, inject) {
     timeout: timer?.timeout,
     get(name) {
       if (name === 'tuiTheme') return tuiTheme
+      if (name === 'tuiPresets') return tuiPresets
       if (name === 'tuiSlots') return tuiSlots
       if (name === 'tuiCommands') return tuiCommands
       if (name === 'tuiOverlay') return tuiOverlay

package/lib/deepseek-logo.js

@@ -1,62 +1,29 @@
-/** Built-in Client Plugin: the classic DeepSeek Harness whale lockup. */
+/** Built-in Client Plugin: the classic DeepSeek Harness UI Preset. */
 
 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 const inject = ['tuiPresets', 'tuiSlots']
 
 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 ctx.tuiPresets.register({ id: 'deepseek', label: 'DeepSeek' }, () => {
+    const hero = ctx.tuiSlots.register(
+      { name: 'welcome.hero', id: 'deepseek-hero' },
+      [
+        { id: 'logo', kind: 'logo', name: 'deepseek' },
+        {
+          id: 'hint',
+          kind: 'text',
+          text: 'Into the Unknown',
+          tone: 'fg_tertiary',
+        },
+      ],
+    )
+    const info = ctx.tuiSlots.register(
+      { name: 'welcome.info', id: 'deepseek-info' },
+      [{ id: 'info', kind: 'welcomeinfo' }],
+    )
+    return () => {
+      info.dispose()
+      hero.dispose()
+    }
   })
-  return () => stopCommand?.()
 }

package/lib/index.js

@@ -184,6 +184,7 @@ export async function applyShell(ctx, options = {}) {
   }
 
   if (!connection.muxed) {
+    let republishCompositorState = () => {}
     const mux = muxAcpAndCompositor({
       agent,
       tui: connection,
@@ -191,6 +192,7 @@ export async function applyShell(ctx, options = {}) {
         clientRunner.onHost(message)
       },
       onCordisReady() {
+        republishCompositorState()
         clientRunner.sync()
       },
       onAcp(direction, message) {
@@ -213,10 +215,14 @@ export async function applyShell(ctx, options = {}) {
         throw new Error(`unsupported Cordis TUI method: ${String(message.method)}`)
       },
     })
-    handle.bindNotify((method, params) => mux.notifyTui(method, params))
-    slots.bindNotify((method, params) => mux.notifyTui(method, params))
-    commands.bindNotify((method, params) => mux.notifyTui(method, params))
-    overlay.bindNotify((method, params) => mux.notifyTui(method, params))
+    const notifyTui = (method, params) => mux.notifyTui(method, params)
+    republishCompositorState = () => {
+      handle.bindNotify(notifyTui)
+      slots.bindNotify(notifyTui)
+      commands.bindNotify(notifyTui)
+      overlay.bindNotify(notifyTui)
+    }
+    republishCompositorState()
     clientRunner.bindTransport(mux.requestAgent)
     sessionConfig.bindTransport(mux.requestTui)
     connection.resume?.()

package/lib/inspect.js

@@ -9,7 +9,7 @@ import { CORDIS_METHODS } from './cordis-protocol.js'
 
 export const name = 'tui-cordis-client-runner'
 export const inject = [
-  'tuiTheme', 'tuiSlots', 'tuiCommands', 'tuiOverlay', 'acpSessionConfig',
+  'tuiTheme', 'tuiPresets', 'tuiSlots', 'tuiCommands', 'tuiOverlay', 'acpSessionConfig',
   'acpSessionPlan', 'acpSessionStats', 'acpSessionStatus',
 ]
 
@@ -135,9 +135,43 @@ export function themeInspectProvider(tuiTheme) {
   }
 }
 
+/** Describe saved compositions of several independent TUI contributions. */
+export function uiPresetInspectProvider(tuiPresets) {
+  return {
+    manifest: {
+      id: 'UiPresets',
+      description:
+        'Saved UI compositions. One preset mounts several UI contributions as one lifecycle.',
+      methods: [{
+        name: 'list',
+        description: 'List registered UI Presets and the composition registration contract.',
+        inputSchema: EMPTY_INPUT,
+        outputSchema: ANY_OUTPUT,
+      }],
+    },
+    query(method) {
+      if (method !== 'list') throw new Error(`unknown UiPresets inspect method "${method}"`)
+      return {
+        active: tuiPresets.active(),
+        presets: tuiPresets.list(),
+        apply: {
+          inject: ['tuiPresets'],
+          register: {
+            call: 'ctx.tuiPresets.register({ id, label }, mount)',
+            mount:
+              'A synchronous callback that mounts multiple UI contributions and returns one disposer.',
+          },
+          selection: '/ui <id>',
+          persistence: 'The selected id survives restart in dsh-tui-settings.json.',
+        },
+      }
+    },
+  }
+}
+
 const TUI_NODE_KINDS = Object.freeze([
-  'group', 'markdown', 'reasoning', 'user', 'generic', 'terminal', 'diff',
-  'image', 'notice', 'unknown',
+  'ascii', 'logo', 'welcomeinfo', 'text', 'group', 'markdown', 'reasoning',
+  'user', 'generic', 'terminal', 'diff', 'image', 'notice', 'unknown',
 ])
 
 /** Describe the root TUI shell slots available to a dynamic Client half. */
@@ -168,7 +202,8 @@ export function slotInspectProvider(tuiSlots) {
           update: 'const panel = register(...); panel.update(nextNodes)',
           dispose: 'Return panel.dispose from inject; plugin unload removes the pane immediately.',
           note:
-            'chrome.right is a root list slot; conversation.input.dock is the additive row above '
+            '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. '
             + 'Node ids are stable inside one contribution; '
             + 'the compositor namespaces them by contribution id. Compose group/markdown/reasoning/'
@@ -225,6 +260,27 @@ export function commandInspectProvider(tuiCommands) {
                   slashPrefix: false,
                 },
                 description: { type: 'string', minLength: 1 },
+                input: {
+                  type: 'object',
+                  required: ['hint'],
+                  additionalProperties: false,
+                  properties: {
+                    hint: { type: 'string', minLength: 1 },
+                    options: {
+                      type: 'array',
+                      items: {
+                        type: 'object',
+                        required: ['value'],
+                        additionalProperties: false,
+                        properties: {
+                          value: { type: 'string', minLength: 1 },
+                          label: { type: 'string' },
+                          description: { type: 'string' },
+                        },
+                      },
+                    },
+                  },
+                },
               },
             },
             handler: {
@@ -242,6 +298,12 @@ export function commandInspectProvider(tuiCommands) {
               type: 'function',
               role: 'dispose',
               idempotent: true,
+              methods: {
+                update: {
+                  arguments: [{ name: 'patch', type: 'object' }],
+                  description: 'Refresh description or input completion metadata',
+                },
+              },
             },
           },
           list: {
@@ -633,6 +695,7 @@ async function mountClientHalf(
   pluginId,
   clientCode,
   tuiTheme,
+  tuiPresets,
   tuiSlots,
   tuiCommands,
   tuiOverlay,
@@ -646,7 +709,7 @@ async function mountClientHalf(
   if (typeof ctx.plugin !== 'function') {
     return applyClientHalf(clientCode, {
       pluginId,
-      tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
+      tuiTheme, tuiPresets, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
       acpSessionStats, acpSessionStatus, timer, invoke,
     })
   }
@@ -658,7 +721,7 @@ async function mountClientHalf(
     apply: async () => {
       applied = await applyClientHalf(clientCode, {
         pluginId,
-        tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
+        tuiTheme, tuiPresets, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
         acpSessionStats, acpSessionStatus, timer, invoke,
       })
       return applied.dispose
@@ -697,12 +760,13 @@ async function mountClientHalf(
  */
 export function attachTuiClient(opts) {
   const {
-    ctx, tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
+    ctx, tuiTheme, tuiPresets, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
     acpSessionStats, acpSessionStatus,
     requestAgent,
   } = opts
   const providers = [
     themeInspectProvider(tuiTheme),
+    ...(tuiPresets === undefined ? [] : [uiPresetInspectProvider(tuiPresets)]),
     ...(tuiSlots === undefined ? [] : [slotInspectProvider(tuiSlots)]),
     ...(tuiCommands === undefined ? [] : [commandInspectProvider(tuiCommands)]),
     ...(tuiOverlay === undefined ? [] : [overlayInspectProvider(tuiOverlay)]),
@@ -801,6 +865,7 @@ export function attachTuiClient(opts) {
         request.pluginId,
         typeof code === 'string' ? code : '',
         tuiTheme,
+        tuiPresets,
         tuiSlots,
         tuiCommands,
         tuiOverlay,
@@ -970,6 +1035,7 @@ export function attachTuiClient(opts) {
 /** Mount the TUI counterpart of the Web Cordis Client runner. */
 export function apply(ctx) {
   const tuiTheme = ctx.tuiTheme ?? ctx.get?.('tuiTheme')
+  const tuiPresets = ctx.tuiPresets ?? ctx.get?.('tuiPresets')
   const tuiSlots = ctx.tuiSlots ?? ctx.get?.('tuiSlots')
   const tuiCommands = ctx.tuiCommands ?? ctx.get?.('tuiCommands')
   const tuiOverlay = ctx.tuiOverlay ?? ctx.get?.('tuiOverlay')
@@ -982,7 +1048,7 @@ export function apply(ctx) {
     bindTransport(requestAgent) {
       client?.dispose()
       client = attachTuiClient({
-        ctx, tuiTheme, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
+        ctx, tuiTheme, tuiPresets, tuiSlots, tuiCommands, tuiOverlay, acpSessionConfig, acpSessionPlan,
         acpSessionStats, acpSessionStatus,
         requestAgent,
       })

package/lib/martty-preset.js

@@ -0,0 +1,24 @@
+/** Built-in Martty UI Preset. */
+
+export const name = 'martty-preset'
+export const inject = ['tuiPresets', 'tuiSlots']
+
+export function apply(ctx) {
+  return ctx.tuiPresets.register({ id: 'default', label: 'Martty' }, () => {
+    const hero = ctx.tuiSlots.register(
+      { name: 'welcome.hero', id: 'martty-hero' },
+      [
+        { id: 'logo', kind: 'logo', name: 'martty' },
+        { id: 'hint', kind: 'text', text: 'https://martty.sh', tone: 'fg_tertiary' },
+      ],
+    )
+    const info = ctx.tuiSlots.register(
+      { name: 'welcome.info', id: 'martty-info' },
+      [{ id: 'info', kind: 'welcomeinfo' }],
+    )
+    return () => {
+      info.dispose()
+      hero.dispose()
+    }
+  })
+}

package/lib/tui-commands.js

@@ -42,14 +42,60 @@ function validateCommand(options) {
   if (typeof options.description !== 'string' || options.description.length === 0) {
     throw new Error('tuiCommands.register: description must be a non-empty string')
   }
-  const extra = Object.keys(options).filter((key) => key !== 'name' && key !== 'description')
+  const extra = Object.keys(options).filter((key) => !['name', 'description', 'input'].includes(key))
   if (extra.length > 0) {
     throw new Error(`tuiCommands.register: unknown option field(s) ${extra.join(', ')}`)
   }
-  return {
+  const command = {
     name: options.name,
     description: options.description,
   }
+  if (options.input !== undefined) command.input = validateInput(options.input)
+  return command
+}
+
+function validateInput(input) {
+  if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+    throw new Error('tuiCommands.register: input must be an object')
+  }
+  const extra = Object.keys(input).filter((key) => !['hint', 'options'].includes(key))
+  if (extra.length > 0) {
+    throw new Error(`tuiCommands.register: unknown input field(s) ${extra.join(', ')}`)
+  }
+  if (typeof input.hint !== 'string' || input.hint.length === 0) {
+    throw new Error('tuiCommands.register: input.hint must be a non-empty string')
+  }
+  if (input.options !== undefined && !Array.isArray(input.options)) {
+    throw new Error('tuiCommands.register: input.options must be an array')
+  }
+  const normalized = { hint: input.hint }
+  if (input.options !== undefined) {
+    normalized.options = input.options.map((option) => {
+      if (option === null || typeof option !== 'object' || Array.isArray(option)) {
+        throw new Error('tuiCommands.register: each input option must be an object')
+      }
+      const unknown = Object.keys(option)
+        .filter((key) => !['value', 'label', 'description'].includes(key))
+      if (unknown.length > 0) {
+        throw new Error(`tuiCommands.register: unknown input option field(s) ${unknown.join(', ')}`)
+      }
+      if (typeof option.value !== 'string' || option.value.length === 0) {
+        throw new Error('tuiCommands.register: input option value must be a non-empty string')
+      }
+      if (option.label !== undefined && typeof option.label !== 'string') {
+        throw new Error('tuiCommands.register: input option label must be a string')
+      }
+      if (option.description !== undefined && typeof option.description !== 'string') {
+        throw new Error('tuiCommands.register: input option description must be a string')
+      }
+      return {
+        value: option.value,
+        ...(option.label === undefined ? {} : { label: option.label }),
+        ...(option.description === undefined ? {} : { description: option.description }),
+      }
+    })
+  }
+  return normalized
 }
 
 /**
@@ -101,11 +147,24 @@ export function installTuiCommands(ctx, options = {}) {
       ? effectCtx.effect(setup, `tuiCommands.register(${JSON.stringify(command.name)})`)
       : setup()
     let disposed = false
-    return () => {
+    const dispose = () => {
       if (disposed) return
       disposed = true
       return release?.()
     }
+    dispose.update = (patch) => {
+      if (disposed) return
+      if (patch === null || typeof patch !== 'object' || Array.isArray(patch)) {
+        throw new Error('tuiCommands.register: update patch must be an object')
+      }
+      const unknown = Object.keys(patch).filter((key) => !['description', 'input'].includes(key))
+      if (unknown.length > 0) {
+        throw new Error(`tuiCommands.register: unknown update field(s) ${unknown.join(', ')}`)
+      }
+      entry.command = validateCommand({ ...entry.command, ...patch, name: entry.command.name })
+      if (entry.active) publish()
+    }
+    return dispose
   }
 
   async function dispatch(params) {

package/lib/tui-overlay.js

@@ -19,6 +19,10 @@ class TuiOverlayService extends Service {
     return this.core.openSlider(options, handlers)
   }
 
+  openSelect(options, handlers) {
+    return this.core.openSelect(options, handlers)
+  }
+
   openView(options, handlers) {
     return this.core.openView(options, handlers)
   }
@@ -116,6 +120,50 @@ function validateView(input) {
   }
 }
 
+function validateSelect(input) {
+  if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+    throw new Error('tuiOverlay.openSelect: options must be an object')
+  }
+  if (typeof input.id !== 'string' || input.id.length === 0) {
+    throw new Error('tuiOverlay.openSelect: id must be a non-empty string')
+  }
+  if (typeof input.title !== 'string' || input.title.length === 0) {
+    throw new Error('tuiOverlay.openSelect: title must be a non-empty string')
+  }
+  if (!Array.isArray(input.options) || input.options.length === 0) {
+    throw new Error('tuiOverlay.openSelect: options must be a non-empty array')
+  }
+  const values = new Set()
+  const options = input.options.map((option, index) => {
+    if (option === null || typeof option !== 'object' || Array.isArray(option)) {
+      throw new Error(`tuiOverlay.openSelect: options[${index}] must be an object`)
+    }
+    if (typeof option.value !== 'string' || option.value.length === 0) {
+      throw new Error(`tuiOverlay.openSelect: options[${index}].value must be a non-empty string`)
+    }
+    if (values.has(option.value)) {
+      throw new Error(`tuiOverlay.openSelect: duplicate value "${option.value}"`)
+    }
+    values.add(option.value)
+    if (typeof option.label !== 'string' || option.label.length === 0) {
+      throw new Error(`tuiOverlay.openSelect: options[${index}].label must be a non-empty string`)
+    }
+    if (option.description !== undefined && typeof option.description !== 'string') {
+      throw new Error(`tuiOverlay.openSelect: options[${index}].description must be a string`)
+    }
+    return {
+      value: option.value,
+      label: option.label,
+      ...(option.description === undefined ? {} : { description: option.description }),
+    }
+  })
+  const value = input.value === undefined ? options[0].value : input.value
+  if (typeof value !== 'string' || !values.has(value)) {
+    throw new Error('tuiOverlay.openSelect: value must match one option')
+  }
+  return { kind: 'select', id: input.id, title: input.title, value, options }
+}
+
 /**
  * @param {object} ctx
  * @param {{ notify?: (method: string, params: object) => void }} [options]
@@ -164,6 +212,17 @@ export function installTuiOverlay(ctx, options = {}) {
     return controllerFor(entry)
   }
 
+  function openSelect(options, handlers = {}) {
+    if (current !== null) {
+      throw new Error(`tuiOverlay.openSelect: overlay "${current.overlay.id}" is already open`)
+    }
+    const select = validateSelect(options)
+    const entry = { overlay: select, handlers, closed: false }
+    current = entry
+    publish(structuredClone(select))
+    return controllerFor(entry)
+  }
+
   function openView(options, handlers = {}) {
     const view = validateView(options)
     if (current !== null) {
@@ -205,6 +264,31 @@ export function installTuiOverlay(ctx, options = {}) {
       return handler?.()
     }
 
+    if (entry.overlay.kind === 'select') {
+      if (!['change', 'submit', 'cancel'].includes(params.event)) {
+        throw new Error(`tuiOverlay.dispatch: unknown select event "${String(params.event)}"`)
+      }
+      if (params.event !== 'cancel') {
+        if (typeof params.value !== 'string'
+          || !entry.overlay.options.some((option) => option.value === params.value)) {
+          throw new Error('tuiOverlay.dispatch: select value is not an option')
+        }
+        entry.overlay.value = params.value
+      }
+      if (params.event === 'change') {
+        return entry.handlers.onChange?.(entry.overlay.value)
+      }
+      const handler = params.event === 'submit'
+        ? entry.handlers.onSubmit
+        : entry.handlers.onCancel
+      entry.closed = true
+      if (current === entry) {
+        current = null
+        publish(null)
+      }
+      return handler?.(entry.overlay.value)
+    }
+
     const slider = entry.overlay
     const value = finite(params.value, 'event.value')
     if (value < slider.min || value > slider.max) {
@@ -239,10 +323,10 @@ export function installTuiOverlay(ctx, options = {}) {
     return current === null ? null : structuredClone(current.overlay)
   }
 
-  const core = { openSlider, openView, dispatch, active, bindNotify }
+  const core = { openSlider, openSelect, openView, dispatch, active, bindNotify }
   const service = typeof ctx.provide === 'function'
     ? new TuiOverlayService(ctx, core)
-    : { openSlider, openView, dispatch, active, bindNotify }
+    : { openSlider, openSelect, openView, dispatch, active, bindNotify }
   if (typeof ctx.provide !== 'function') ctx.tuiOverlay = service
   return service
 }

package/lib/tui-presets.js

@@ -0,0 +1,242 @@
+/** UI Presets compose several UI plugin contributions into one saved choice. */
+
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import path from 'node:path'
+import { Service } from '@deepseek-ai/cordis'
+
+export const name = 'tui-presets'
+export const inject = ['tuiCommands', 'tuiOverlay']
+
+const ID = /^[a-z0-9][a-z0-9-]*$/
+
+class TuiPresetsService extends Service {
+  constructor(ctx, core) {
+    super(ctx, 'tuiPresets')
+    this.core = core
+  }
+
+  register(options, mount) {
+    return this.core.register(options, mount)
+  }
+
+  activate(id) {
+    return this.core.activate(id)
+  }
+
+  list() {
+    return this.core.list()
+  }
+
+  active() {
+    return this.core.active()
+  }
+}
+
+function readSettings(settingsPath) {
+  if (typeof settingsPath !== 'string' || settingsPath.length === 0) return {}
+  try {
+    const value = JSON.parse(readFileSync(settingsPath, 'utf8'))
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {}
+  } catch {
+    return {}
+  }
+}
+
+function writePreferred(settingsPath, id) {
+  if (typeof settingsPath !== 'string' || settingsPath.length === 0) return
+  const settings = readSettings(settingsPath)
+  settings.uiPreset = id
+  mkdirSync(path.dirname(settingsPath), { recursive: true })
+  writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`)
+}
+
+function releaseOf(value) {
+  if (typeof value === 'function') return value
+  if (value !== null && typeof value === 'object' && typeof value.dispose === 'function') {
+    return () => value.dispose()
+  }
+  return () => {}
+}
+
+export function installTuiPresets(ctx, options = {}) {
+  const entries = new Map()
+  const settingsPath = options.settingsPath
+  const saved = readSettings(settingsPath).uiPreset
+  let preferredId = typeof saved === 'string' && ID.test(saved) ? saved : 'default'
+  let activeEntry
+  let releaseActive
+  let presetSelector
+  let disposed = false
+
+  function mount(entry) {
+    const mounted = entry.mount()
+    if (mounted !== undefined && typeof mounted?.then === 'function') {
+      throw new Error('tuiPresets: preset mounts must be synchronous')
+    }
+    return releaseOf(mounted)
+  }
+
+  function switchTo(entry) {
+    if (activeEntry === entry) return
+    const previous = activeEntry
+    const releasePrevious = releaseActive
+    releasePrevious?.()
+    activeEntry = undefined
+    releaseActive = undefined
+    try {
+      releaseActive = mount(entry)
+      activeEntry = entry
+    } catch (error) {
+      if (previous !== undefined) {
+        try {
+          releaseActive = mount(previous)
+          activeEntry = previous
+        } catch {
+          activeEntry = undefined
+          releaseActive = undefined
+        }
+      }
+      throw error
+    }
+  }
+
+  function activate(id, persist = true) {
+    if (disposed) throw new Error('tuiPresets: registry is disposed')
+    if (typeof id !== 'string' || !ID.test(id)) {
+      throw new Error('tuiPresets.activate: id must be a lowercase preset identifier')
+    }
+    const entry = entries.get(id)
+    if (entry === undefined) {
+      throw new Error(`tuiPresets.activate: preset "${id}" is not registered`)
+    }
+    switchTo(entry)
+    if (persist) {
+      preferredId = id
+      writePreferred(settingsPath, id)
+    }
+  }
+
+  function fallback() {
+    const next = entries.get(preferredId) ?? entries.get('default') ?? entries.values().next().value
+    if (next !== undefined) switchTo(next)
+  }
+
+  function refreshCommandInput() {
+    stopCommand?.update?.({
+      input: {
+        hint: 'preset',
+        options: list().map((entry) => ({
+          value: entry.id,
+          label: entry.label,
+        })),
+      },
+    })
+  }
+
+  function register(options, mountPreset) {
+    if (disposed) throw new Error('tuiPresets: registry is disposed')
+    if (options === null || typeof options !== 'object' || Array.isArray(options)) {
+      throw new Error('tuiPresets.register: options must be an object')
+    }
+    if (typeof options.id !== 'string' || !ID.test(options.id)) {
+      throw new Error('tuiPresets.register: id must be a lowercase preset identifier')
+    }
+    if (typeof options.label !== 'string' || options.label.length === 0) {
+      throw new Error('tuiPresets.register: label must be a non-empty string')
+    }
+    const extras = Object.keys(options).filter((key) => !['id', 'label'].includes(key))
+    if (extras.length > 0) {
+      throw new Error(`tuiPresets.register: unknown option(s) ${extras.join(', ')}`)
+    }
+    if (typeof mountPreset !== 'function') {
+      throw new Error('tuiPresets.register: mount must be a function')
+    }
+    if (entries.has(options.id)) {
+      throw new Error(`tuiPresets.register: preset "${options.id}" is already registered`)
+    }
+    const entry = { id: options.id, label: options.label, mount: mountPreset }
+    entries.set(entry.id, entry)
+    refreshCommandInput()
+    if (activeEntry === undefined || entry.id === preferredId) fallback()
+
+    let stopped = false
+    return () => {
+      if (stopped) return
+      stopped = true
+      if (entries.get(entry.id) !== entry) return
+      const wasActive = activeEntry === entry
+      if (wasActive) {
+        releaseActive?.()
+        activeEntry = undefined
+        releaseActive = undefined
+      }
+      entries.delete(entry.id)
+      refreshCommandInput()
+      if (wasActive) fallback()
+    }
+  }
+
+  function list() {
+    return [...entries.values()].map(({ id, label }) => ({ id, label }))
+  }
+
+  function active() {
+    return activeEntry?.id
+  }
+
+  const stopCommand = ctx.tuiCommands.register({
+    name: 'ui',
+    description: 'Switch UI preset',
+  }, async (args = '') => {
+    const id = args.trim().toLowerCase()
+    if (id.length === 0) {
+      const choices = list()
+      presetSelector?.close()
+      presetSelector = ctx.tuiOverlay.openSelect({
+        id: 'ui-preset',
+        title: 'UI preset',
+        value: active(),
+        options: choices.map((entry) => ({
+          value: entry.id,
+          label: entry.label,
+        })),
+      }, {
+        onSubmit(value) {
+          presetSelector = undefined
+          activate(value)
+        },
+        onCancel() {
+          presetSelector = undefined
+        },
+      })
+      return
+    }
+    activate(id)
+  })
+  refreshCommandInput()
+
+  function dispose() {
+    if (disposed) return
+    disposed = true
+    stopCommand?.()
+    presetSelector?.close()
+    presetSelector = undefined
+    releaseActive?.()
+    activeEntry = undefined
+    releaseActive = undefined
+    entries.clear()
+  }
+
+  const core = { register, activate, list, active, dispose }
+  const service = typeof ctx.provide === 'function'
+    ? new TuiPresetsService(ctx, core)
+    : core
+  service.dispose = dispose
+  if (typeof ctx.provide !== 'function') ctx.tuiPresets = service
+  return service
+}
+
+export function apply(ctx, options) {
+  const service = installTuiPresets(ctx, options)
+  return () => service.dispose()
+}

package/lib/tui-slots.js

@@ -10,12 +10,16 @@ export const name = 'tui-slots'
 export const inject = []
 
 export const SLOT_NAMES = Object.freeze([
+  'welcome.hero',
+  'welcome.info',
   'chrome.right',
   'conversation.input.dock',
   'conversation.composer.dock',
 ])
 
 const SLOT_DEFINITIONS = Object.freeze({
+  'welcome.hero': Object.freeze({ kind: 'single', scope: 'root' }),
+  '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.composer.dock': Object.freeze({ kind: 'list', scope: 'session' }),
@@ -52,6 +56,10 @@ const THEME_TOKENS = new Set([
 ])
 
 const NODE_FIELDS = Object.freeze({
+  ascii: { required: ['id', 'kind', 'lines'], optional: ['tone'] },
+  logo: { required: ['id', 'kind', 'name'], optional: [] },
+  welcomeinfo: { required: ['id', 'kind'], optional: [] },
+  text: { required: ['id', 'kind', 'text'], optional: ['tone'] },
   group: { required: ['id', 'kind', 'children'], optional: ['title', 'tone'] },
   markdown: { required: ['id', 'kind', 'text'], optional: ['streaming'] },
   reasoning: { required: ['id', 'kind', 'text', 'done'], optional: ['seconds'] },
@@ -113,6 +121,28 @@ function validateNode(node, path, ids) {
   ids.add(node.id)
 
   switch (node.kind) {
+    case 'ascii':
+      if (!Array.isArray(node.lines) || node.lines.length === 0) {
+        throw new Error(`tuiSlots: ${path}.lines must be a non-empty array`)
+      }
+      node.lines.forEach((line, index) => string(line, `${path}.lines[${index}]`))
+      if (node.tone !== undefined && !THEME_TOKENS.has(node.tone)) {
+        throw new Error(`tuiSlots: ${path}.tone must be a theme token`)
+      }
+      break
+    case 'logo':
+      if (!['martty', 'deepseek'].includes(node.name)) {
+        throw new Error(`tuiSlots: ${path}.name must be a built-in logo primitive`)
+      }
+      break
+    case 'welcomeinfo':
+      break
+    case 'text':
+      string(node.text, `${path}.text`)
+      if (node.tone !== undefined && !THEME_TOKENS.has(node.tone)) {
+        throw new Error(`tuiSlots: ${path}.tone must be a theme token`)
+      }
+      break
     case 'group':
       optionalString(node.title, `${path}.title`)
       if (node.tone !== undefined && !THEME_TOKENS.has(node.tone)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "martty",
-  "version": "0.2.15-beta.1",
+  "version": "0.2.16",
   "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/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/release.test.mjs ../scripts/jsonrpc-line-transport.test.mjs ../scripts/tui-theme.test.mjs ../scripts/tui-presets.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",
@@ -25,6 +25,7 @@
     ".": "./lib/index.js",
     "./ember": "./lib/ember.js",
     "./theme": "./lib/tui-theme.js",
+    "./presets": "./lib/tui-presets.js",
     "./slots": "./lib/tui-slots.js",
     "./commands": "./lib/tui-commands.js",
     "./overlay": "./lib/tui-overlay.js",
@@ -35,6 +36,7 @@
     "./stats-view": "./lib/stats-view.js",
     "./status-view": "./lib/status-view.js",
     "./deepseek-logo": "./lib/deepseek-logo.js",
+    "./martty-preset": "./lib/martty-preset.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

@@ -56,6 +56,7 @@ Use the narrowest capability:
 | Need | Inspect family | Runtime service |
 | --- | --- | --- |
 | Palette registration/activation | `Theme` | `tuiTheme` |
+| Saved composition of several UI contributions | `UiPresets` | `tuiPresets` |
 | Persistent terminal content | `Slots` | `tuiSlots` |
 | Local slash command | `Commands` | `tuiCommands` |
 | Transient slider or node view | `Overlay` | `tuiOverlay` |
@@ -85,10 +86,17 @@ compose only in the Plugin code. The services do not imply one another:
   in that one Plugin. Never read/subscribe to active theme or implement a
   theme condition yourself. Immediate preview uses the inspected registration
   option and enters the same Plugin seat.
+- **UI Presets:** use `tuiPresets.register({ id, label }, mount)` when the user
+  wants one saved `/ui` choice to mount several UI contributions together.
+  The synchronous mount callback returns one disposer. A UI Preset composes
+  Theme, slots, pet, or other UI Plugins; it is not another name for Theme.
 - **Commands:** register a local slash command. Registration publishes slash
   completion and keeps invocation out of the ACP prompt. Its availability is
   the registration's lifetime; Commands does not know about themes, overlays,
-  config categories, or Slots.
+  config categories, or Slots. Optional `input: { hint, options }` metadata
+  reuses the same upward slash menu after `/name `; each option has `value`
+  plus optional `label` and `description`. Call the returned disposer’s
+  `update({ input })` method when a dynamic candidate catalog changes.
 - **Slots:** register persistent native `TuiNode` content only when the user
   asked for persistent shell UI. Use stable node ids and update the existing
   contribution instead of creating parallel panels. Select the live seat from