goatchain 0.0.1

package/cli/repl.mjs

@@ -0,0 +1,3141 @@
+import path from 'node:path'
+import readline from 'node:readline'
+import { randomUUID } from 'node:crypto'
+import { readFile, writeFile } from 'node:fs/promises'
+import { ansi, clearScreen, deriveSessionSummary, deriveSessionTitle, formatOneLine, formatWhen, printHistory } from './ui.mjs'
+import { getReplHelpText, buildProgram } from './args.mjs'
+import { runTurnWithApprovals } from './turn.mjs'
+import { confirmWithClack, multiselectWithClack, passwordWithClack, selectWithClack, textWithClack } from './clack.mjs'
+import { ensureAllowedFile, expandFileMentions, listWorkspaceFiles } from './files.mjs'
+import { readClipboardImageCandidatesDarwin, readClipboardTextDarwin, readClipboardTypesDarwin, readFinderSelectionPathsDarwin, readImageFileAsDataUrl } from './clipboard.mjs'
+import { extractIterm2FilePastes } from './itermPaste.mjs'
+import { buildSessionsExportBundle, parseSessionsImportJson, planSessionImports, selectSessionsById, sessionsToMarkdown } from './sessionTransfer.mjs'
+
+const KNOWN_COMMANDS = [
+  'help',
+  'exit',
+  'quit',
+  'tools',
+  'status',
+  'model',
+  'edit',
+  'multiline',
+  'ml',
+  'params',
+  'set',
+  'unset',
+  'api-key',
+  'key',
+  'base-url',
+  'save',
+  'new',
+  'workspace',
+  'files',
+  'images',
+  'settings',
+  'output',
+  'diag',
+  'diagnostics',
+  'sessions',
+  'use',
+  'rm',
+  'delete',
+  'clipboard',
+]
+
+const KNOWN_MENTIONS = [
+  '@',
+  '@continue',
+  '@sessions',
+  '@workspace',
+  '@model',
+  '@settings',
+  '@file',
+  '@image',
+  '@img',
+  '@clear',
+]
+
+function normalizeParamKey(key) {
+  const k = String(key || '').trim()
+  if (!k)
+    return ''
+  const lowered = k.toLowerCase()
+  if (lowered === 'maxtokens' || lowered === 'max_tokens')
+    return 'maxOutputTokens'
+  if (lowered === 'top_p' || lowered === 'topp')
+    return 'topP'
+  if (lowered === 'presence_penalty')
+    return 'presencePenalty'
+  if (lowered === 'frequency_penalty')
+    return 'frequencyPenalty'
+  if (lowered === 'timeout' || lowered === 'timeoutms')
+    return 'timeoutMs'
+  return k
+}
+
+function parseParamValue(key, valueRaw) {
+  const k = normalizeParamKey(key)
+  const v = String(valueRaw ?? '').trim()
+  if (!k)
+    return { ok: false, error: 'Missing key' }
+  if (v.length === 0)
+    return { ok: false, error: 'Missing value' }
+
+  const asNumber = (name) => {
+    const n = Number(v)
+    if (!Number.isFinite(n))
+      return { ok: false, error: `Invalid ${name}: ${v}` }
+    return { ok: true, value: n }
+  }
+
+  const asInt = (name) => {
+    const n = Number.parseInt(v, 10)
+    if (!Number.isFinite(n))
+      return { ok: false, error: `Invalid ${name}: ${v}` }
+    return { ok: true, value: n }
+  }
+
+  if (k === 'maxOutputTokens')
+    return asInt('maxTokens')
+  if (k === 'timeoutMs' || k === 'seed')
+    return asInt(k)
+  if (k === 'temperature' || k === 'topP' || k === 'presencePenalty' || k === 'frequencyPenalty')
+    return asNumber(k)
+
+  return { ok: false, error: `Unknown param: ${key}` }
+}
+
+function printStatus({ version, provider, modelId, sessionId, history, agent, baseUrl, requestDefaults, workspaceCwd, emoji }) {
+  const useEmoji = Boolean(emoji) && process.stdout.isTTY && process.env.TERM !== 'dumb'
+  const p = (e, s) => (useEmoji ? `${e} ${s}` : s)
+
+  const turns = Math.floor(history.length / 2)
+  const usage = agent.stats.totalUsage
+  const cfg = requestDefaults ?? {}
+  const cfgParts = [
+    typeof cfg.maxOutputTokens === 'number' ? `maxTokens=${cfg.maxOutputTokens}` : undefined,
+    typeof cfg.temperature === 'number' ? `temperature=${cfg.temperature}` : undefined,
+    typeof cfg.topP === 'number' ? `topP=${cfg.topP}` : undefined,
+    typeof cfg.presencePenalty === 'number' ? `presencePenalty=${cfg.presencePenalty}` : undefined,
+    typeof cfg.frequencyPenalty === 'number' ? `frequencyPenalty=${cfg.frequencyPenalty}` : undefined,
+    typeof cfg.seed === 'number' ? `seed=${cfg.seed}` : undefined,
+    typeof cfg.timeoutMs === 'number' ? `timeoutMs=${cfg.timeoutMs}` : undefined,
+  ].filter(Boolean)
+
+  process.stdout.write(
+    [
+      p('🧾', `version:   ${version}`),
+      p('🗂️', `session:   ${sessionId}`),
+      p('🤖', `model:     ${provider}/${modelId}`),
+      p('🌐', `baseUrl:   ${baseUrl ?? ''}`),
+      p('⚙️', `params:    ${cfgParts.join(' ')}`),
+      p('🔁', `turns:     ${turns}`),
+      p('💬', `messages:  ${history.length}`),
+      p('📊', `usage:     prompt=${usage.promptTokens} completion=${usage.completionTokens} total=${usage.totalTokens}`),
+      p('📁', `workspace:  ${workspaceCwd}`),
+      '',
+    ].join('\n'),
+  )
+}
+
+
+function supportsAltScreen() {
+  if (!process.stdout.isTTY)
+    return false
+  if (process.env.TERM === 'dumb')
+    return false
+  if (process.env.GOATCHAIN_NO_ALT_SCREEN === '1')
+    return false
+  return true
+}
+
+function enterAltScreen() {
+  if (!supportsAltScreen())
+    return false
+  // Switch to alternate screen buffer + hide cursor.
+  process.stdout.write('\u001B[?1049h\u001B[2J\u001B[H\u001B[?25l')
+  return true
+}
+
+function exitAltScreen() {
+  if (!process.stdout.isTTY)
+    return
+  // Show cursor + reset attributes + return to normal buffer.
+  process.stdout.write('\u001B[?25h\u001B[0m\u001B[?1049l')
+}
+
+function editDistance(aRaw, bRaw) {
+  const a = String(aRaw ?? '')
+  const b = String(bRaw ?? '')
+  const n = a.length
+  const m = b.length
+  if (n === 0)
+    return m
+  if (m === 0)
+    return n
+
+  const prev = new Array(m + 1)
+  const curr = new Array(m + 1)
+  for (let j = 0; j <= m; j++)
+    prev[j] = j
+  for (let i = 1; i <= n; i++) {
+    curr[0] = i
+    const ai = a.charCodeAt(i - 1)
+    for (let j = 1; j <= m; j++) {
+      const cost = ai === b.charCodeAt(j - 1) ? 0 : 1
+      curr[j] = Math.min(
+        prev[j] + 1,
+        curr[j - 1] + 1,
+        prev[j - 1] + cost,
+      )
+    }
+    for (let j = 0; j <= m; j++)
+      prev[j] = curr[j]
+  }
+  return prev[m]
+}
+
+function isCommandToken(token) {
+  return /^[a-z0-9][a-z0-9_-]*$/.test(token)
+}
+
+export function resolveCommand(cmdRaw) {
+  const cmd = String(cmdRaw ?? '').trim().toLowerCase()
+  if (!cmd)
+    return { kind: 'empty', cmd: '' }
+  // Avoid suggesting slash commands for non-command-like inputs (e.g. CJK text),
+  // where edit-distance matching produces noisy results.
+  if (!isCommandToken(cmd))
+    return { kind: 'none', cmd: '' }
+  if (KNOWN_COMMANDS.includes(cmd))
+    return { kind: 'exact', cmd }
+
+  const prefix = KNOWN_COMMANDS.filter(c => c.startsWith(cmd))
+  if (prefix.length === 1)
+    return { kind: 'prefix', cmd: prefix[0], matches: prefix }
+  if (prefix.length > 1)
+    return { kind: 'ambiguous', cmd: '', matches: prefix }
+
+  const maxDist = cmd.length <= 4 ? 1 : 2
+  const fuzzy = KNOWN_COMMANDS
+    .filter(c => c[0] === cmd[0])
+    .map(c => ({ c, d: editDistance(cmd, c) }))
+    .filter(x => x.d <= maxDist)
+    .sort((a, b) => a.d - b.d || a.c.localeCompare(b.c))
+    .slice(0, 5)
+    .map(x => x.c)
+  if (fuzzy.length > 0)
+    return { kind: 'fuzzy', cmd: '', matches: fuzzy }
+
+  if (cmd.length >= 3) {
+    const contains = KNOWN_COMMANDS
+      .filter(c => c.includes(cmd))
+      .slice(0, 5)
+    if (contains.length > 0)
+      return { kind: 'contains', cmd: '', matches: contains }
+  }
+
+  return { kind: 'none', cmd: '' }
+}
+
+function getFilteredSessions(sessions, filter) {
+  const f = String(filter ?? '').trim().toLowerCase()
+  if (!f)
+    return sessions
+  return sessions.filter((s) => {
+    const hay = `${s.title ?? ''} ${s.summary ?? ''} ${s.sessionId ?? ''}`.toLowerCase()
+    return hay.includes(f)
+  })
+}
+
+function highlightFirst(text, needleRaw) {
+  const needle = String(needleRaw ?? '').trim()
+  if (!needle)
+    return String(text ?? '')
+  const s = String(text ?? '')
+  const lower = s.toLowerCase()
+  const idx = lower.indexOf(needle.toLowerCase())
+  if (idx < 0)
+    return s
+  return `${s.slice(0, idx)}${ansi.highlight(s.slice(idx, idx + needle.length))}${s.slice(idx + needle.length)}`
+}
+
+function renderSessionPicker({ sessions, currentSessionId, filter, alt, emoji }) {
+  if (alt)
+    clearScreen()
+  else
+    process.stdout.write('\n')
+
+  const useEmoji = Boolean(emoji) && process.stdout.isTTY && process.env.TERM !== 'dumb'
+  const f = String(filter ?? '').trim()
+  const filtered = getFilteredSessions(sessions, filter)
+
+  const cols = process.stdout.isTTY && typeof process.stdout.columns === 'number' && process.stdout.columns > 0
+    ? process.stdout.columns
+    : 120
+  const rows = process.stdout.isTTY && typeof process.stdout.rows === 'number' && process.stdout.rows > 0
+    ? process.stdout.rows
+    : 24
+
+  const headerRaw = `${useEmoji ? '🗂️ ' : ''}Sessions ${filtered.length}/${sessions.length}  filter: ${f || '∅'}  (# open · text filter · empty cancel)`
+  const header = formatOneLine(headerRaw, Math.max(20, cols - 2))
+
+  const maxShow = Math.min(filtered.length, Math.max(8, rows - 6))
+  const indexWidth = String(Math.min(filtered.length, maxShow) || 1).length
+  const metaBudget = Math.min(38, Math.max(26, Math.floor(cols * 0.25)))
+  const titleBudget = Math.min(52, Math.max(22, Math.floor(cols * 0.32)))
+  const summaryBudget = Math.max(0, cols - (6 + indexWidth + metaBudget + titleBudget))
+
+  const lines = [ansi.header(` ${header} `), '']
+  for (let i = 0; i < Math.min(filtered.length, maxShow); i++) {
+    const s = filtered[i]
+    const isActive = s.sessionId === currentSessionId
+    const activeMark = isActive ? ansi.green(useEmoji ? '▶️' : '▶') : ' '
+    const pinMark = s.pinned ? ansi.yellow('★') : ' '
+    const msgCount = Array.isArray(s.messages) ? s.messages.length : 0
+    const titleRaw = formatOneLine(s.title ?? 'New session', titleBudget)
+    const title = isActive ? ansi.bold(titleRaw) : highlightFirst(titleRaw, f)
+    const when = formatWhen(s.updatedAt)
+    const idShort = typeof s.sessionId === 'string' ? s.sessionId.slice(-8) : ''
+    const metaRaw = formatOneLine(`(${msgCount} msgs · ${when}${idShort ? ` · ${idShort}` : ''})`, metaBudget)
+    const meta = ansi.dim(metaRaw)
+
+    const summaryRaw = summaryBudget >= 20 ? formatOneLine(s.summary ?? '', summaryBudget) : ''
+    const summary = summaryRaw ? ` ${ansi.gray(`— ${summaryRaw}`)}` : ''
+    const idx = ansi.yellow(`[${String(i + 1).padStart(indexWidth, ' ')}]`)
+    lines.push(`${activeMark}${pinMark} ${idx} ${title} ${meta}${summary}`)
+  }
+  if (filtered.length > maxShow)
+    lines.push(ansi.dim(`… and ${filtered.length - maxShow} more (refine with filter text)`))
+
+  lines.push('')
+  process.stdout.write(`${lines.join('\n')}\n`)
+  return { filtered }
+}
+
+export async function runRepl(options) {
+  const {
+    version,
+    provider,
+    system,
+    agentRef,
+    modelRef,
+    toolsInfo,
+    requestDefaults,
+    baseUrlRef,
+    setBaseUrl,
+    setApiKey,
+    saveAll,
+    listSessions,
+    loadSessionById,
+    saveSessionByData,
+    renameSessionById,
+    setPinnedSessionsById,
+    deleteSessionById,
+    deleteSessionsById,
+    uiPrefs,
+    switchWorkspace,
+    getWorkspaceCwd,
+  } = options
+
+  const useEmoji = () => Boolean(uiPrefs?.emoji) && process.stdout.isTTY && process.env.TERM !== 'dumb'
+  const icon = s => (useEmoji() ? `${s} ` : '')
+  const label = (e, s) => (useEmoji() ? `${e}\u00A0${s}` : s)
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: '> ',
+    completer: (lineRaw) => {
+      const line = String(lineRaw ?? '')
+      const trimmed = line.trimStart()
+      const isSingleToken = !/\s/.test(trimmed)
+      if (!isSingleToken)
+        return [[], line]
+
+      if (trimmed.startsWith('/')) {
+        const pref = trimmed.slice(1).toLowerCase()
+        const hits = KNOWN_COMMANDS
+          .filter(c => c.startsWith(pref))
+          .map(c => `/${c}`)
+        return [hits, line]
+      }
+
+      if (trimmed.startsWith('@')) {
+        const pref = trimmed.toLowerCase()
+        const hits = KNOWN_MENTIONS
+          .filter(m => m.startsWith(pref))
+          .filter(m => !(pref === '@' && m === '@'))
+        return [hits, line]
+      }
+
+      return [[], line]
+    },
+  })
+
+  let lineQueue = Promise.resolve()
+  let uiMode = /** @type {'normal' | 'select_session'} */ ('normal')
+  let sessionPicker = /** @type {null | { sessions: any[], filter?: string }} */ (null)
+  let sessionPickerAlt = false
+  let activeAbort = null
+  let busy = false
+  let clackDepth = 0
+  let commandPaletteInFlight = false
+  let exiting = false
+  let lastTurnMeta = /** @type {any} */ ({})
+  let workspaceFilesCache = /** @type {null | { at: number, files: string[] }} */ (null)
+  let workspaceImagesCache = /** @type {null | { at: number, files: string[] }} */ (null)
+  /** @type {Array<{ name: string, mime: string, bytes: number, dataUrl: string, source: 'paste' | 'path' }>} */
+  let pendingImages = []
+  let itermPasteBuffer = ''
+  let pasteImageCounter = 0
+  let lastClipboardAutoAttachAt = 0
+  /** @type {null | { name: string, startedAt: number }} */
+  let clipboardAttachInFlight = null
+  /** @type {null | { name: string, at: number }} */
+  let lastPastedImageName = null
+  let bracketedPasteActive = false
+  let bracketedPasteBuffer = ''
+  /** @type {null | { lines: string[] }} */
+  let multiline = null
+
+  const showInlineHint = (text) => {
+    if (!process.stdout.isTTY)
+      return
+    try {
+      rl.output.write(`\n${ansi.dim(text)}\n`)
+      rl.prompt(true)
+    }
+    catch {
+      // ignore
+    }
+  }
+
+  const useClack = () => {
+    const uiMode = (process.env.GOATCHAIN_UI ?? 'auto').toLowerCase()
+    return process.stdout.isTTY && uiMode !== 'legacy'
+  }
+
+  const workspaceCwd = () => {
+    if (typeof getWorkspaceCwd === 'function') {
+      const v = getWorkspaceCwd()
+      if (typeof v === 'string' && v.trim())
+        return v
+    }
+    return toolsInfo?.workspaceCwd ?? process.cwd()
+  }
+
+  const withClack = async (fn) => {
+    clackDepth++
+    const wasPaused = rl.paused
+    if (!wasPaused)
+      rl.pause()
+    try {
+      return await fn()
+    }
+    finally {
+      if (!wasPaused)
+        rl.resume()
+      clackDepth = Math.max(0, clackDepth - 1)
+    }
+  }
+
+  const getInlineCompletions = (lineRaw) => {
+    const line = String(lineRaw ?? '')
+    const trimmed = line.trimStart()
+    const isSingleToken = !/\s/.test(trimmed)
+    if (!isSingleToken)
+      return []
+    if (trimmed.startsWith('/')) {
+      const pref = trimmed.slice(1).toLowerCase()
+      return KNOWN_COMMANDS.filter(c => c.startsWith(pref)).map(c => `/${c}`)
+    }
+    if (trimmed.startsWith('@')) {
+      const pref = trimmed.toLowerCase()
+      return KNOWN_MENTIONS.filter(m => m.startsWith(pref))
+        .filter(m => !(pref === '@' && m === '@'))
+    }
+    return []
+  }
+
+  const humanBytes = (n) => {
+    const num = Number(n)
+    if (!Number.isFinite(num) || num < 0)
+      return ''
+    if (num < 1024)
+      return `${num} B`
+    if (num < 1024 * 1024)
+      return `${(num / 1024).toFixed(2)} KB`
+    return `${(num / (1024 * 1024)).toFixed(2)} MB`
+  }
+
+  const refreshPrompt = () => {
+    try {
+      rl._refreshLine?.()
+    }
+    catch {
+      // ignore
+    }
+  }
+
+  const attachTabCycler = () => {
+    if (!process.stdin.isTTY)
+      return
+    const orig = rl._ttyWrite?.bind(rl)
+    if (typeof orig !== 'function')
+      return
+
+    /** @type {{ prefix: string, options: string[], index: number, lastAt: number } | null} */
+    let state = null
+    let lastHintAt = 0
+
+    const reset = () => {
+      state = null
+    }
+
+    const cycle = () => {
+      const now = Date.now()
+      const token = rl.line.trimStart()
+      if (!token)
+        return false
+
+      if (!state || now - state.lastAt > 2500) {
+        const opts = getInlineCompletions(token)
+        if (opts.length === 0)
+          return false
+        state = { prefix: token, options: opts, index: -1, lastAt: now }
+      }
+      else {
+        // Keep cycling based on the original typed prefix (state.prefix),
+        // even though rl.line is being replaced with a completion candidate.
+        const opts = getInlineCompletions(state.prefix)
+        state.options = opts.length > 0 ? opts : state.options
+        state.lastAt = now
+      }
+
+      state.index = (state.index + 1) % state.options.length
+      const next = state.options[state.index] ?? token
+      rl.line = next
+      rl.cursor = rl.line.length
+      rl._refreshLine?.()
+      return true
+    }
+
+    const addPendingImages = (files, source) => {
+      if (!Array.isArray(files) || files.length === 0)
+        return
+      const extFromMime = (mime) => {
+        const m = String(mime ?? '')
+        if (m === 'image/png')
+          return '.png'
+        if (m === 'image/jpeg')
+          return '.jpg'
+        if (m === 'image/webp')
+          return '.webp'
+        if (m === 'image/gif')
+          return '.gif'
+        return ''
+      }
+      for (const f of files) {
+        if (!f || typeof f !== 'object')
+          continue
+        const rawName = typeof f.name === 'string' ? f.name : 'pasted-image'
+        const mime = typeof f.mime === 'string' ? f.mime : 'application/octet-stream'
+        const bytes = typeof f.bytes === 'number' ? f.bytes : 0
+        const dataUrl = typeof f.dataUrl === 'string' ? f.dataUrl : ''
+        if (!dataUrl)
+          continue
+        if (!mime.startsWith('image/')) {
+          queueMicrotask(() => showInlineHint(`Ignored non-image paste: ${rawName} (${mime})`))
+          continue
+        }
+        let name = rawName
+        if (source === 'paste') {
+          const lower = rawName.toLowerCase()
+          const duplicate = pendingImages.some(p => p && typeof p.name === 'string' && p.name.toLowerCase() === lower)
+          if (!rawName || rawName === 'pasted-image') {
+            const ext = extFromMime(mime)
+            name = `pasted-image-${++pasteImageCounter}${ext}`
+          }
+          else if (duplicate) {
+            const parsed = path.parse(rawName)
+            const ext = parsed.ext || extFromMime(mime)
+            const base = parsed.name || rawName
+            name = `${base}-${++pasteImageCounter}${ext}`
+          }
+        }
+        pendingImages.push({ name, mime, bytes, dataUrl, source })
+      }
+      setPromptForMode()
+      refreshPrompt()
+    }
+
+    const normalizeStandaloneImageName = (text) => {
+      let t = String(text ?? '').trim()
+      if (!t)
+        return null
+      if (t.length > 260)
+        return null
+      // Bracketed paste wrappers (common on modern terminals).
+      t = t.replace(/^\u001B\[200~/, '').replace(/\u001B\[201~$/, '').trim()
+      // Strip zero-width characters that sometimes appear in clipboard content.
+      t = t.replace(/[\u200B\u200C\u200D\uFEFF]/g, '')
+      if (t.includes('\n') || t.includes('\r'))
+        return null
+      if (t.includes('/') || t.includes('\\'))
+        return null
+      // Strip common quoting.
+      t = t.replace(/^["'`]+|["'`]+$/g, '').trim()
+      // Accept (and normalize) accidental spaces around dot: "name .png" -> "name.png".
+      const m = t.match(/^(.*?)(?:\s*\.\s*)(png|jpe?g|webp|gif|bmp|tiff?|heic)$/i)
+      if (!m)
+        return null
+      const base = String(m[1] ?? '').trim()
+      const ext = String(m[2] ?? '').trim().toLowerCase()
+      if (!base)
+        return null
+      return `${base}.${ext}`
+    }
+
+    const stripTokenOnceFromLine = (token) => {
+      const t = String(rl.line ?? '')
+      const tok = String(token ?? '').trim()
+      if (!tok)
+        return false
+      const idx = t.indexOf(tok)
+      if (idx < 0)
+        return false
+      const before = idx === 0 ? '' : t[idx - 1]
+      const after = idx + tok.length >= t.length ? '' : t[idx + tok.length]
+      const okBefore = !before || /\s|[，,。.!?？:：;；、()[\]{}"'“”‘’]/.test(before)
+      // If token is pasted at the start, allow stripping even if the user immediately continues typing.
+      const okAfter = idx === 0 || !after || /\s|[，,。.!?？:：;；、()[\]{}"'“”‘’]/.test(after)
+      if (!okBefore || !okAfter)
+        return false
+      const next = `${t.slice(0, idx)} ${t.slice(idx + tok.length)}`.replace(/\s{2,}/g, ' ').trimStart()
+      rl.line = next
+      rl.cursor = next.length
+      return true
+    }
+
+    const stripLeadingImageNameFromLine = () => {
+      const t = String(rl.line ?? '')
+      const m = t.match(/^\s*(.*?)(?:\s*\.\s*)(png|jpe?g|webp|gif|bmp|tiff?|heic)(?=\s|[，,。.!?？:：;；、()[\]{}"'“”‘’]|$)\s*/i)
+      if (!m)
+        return false
+      const whole = String(m[0] ?? '')
+      if (!whole)
+        return false
+      rl.line = t.slice(whole.length).trimStart()
+      rl.cursor = rl.line.length
+      return true
+    }
+
+    const maybeAutoAttachClipboardForPastedName = (pastedName) => {
+      const now = Date.now()
+      if (now - lastClipboardAutoAttachAt < 700)
+        return
+      lastClipboardAutoAttachAt = now
+
+      const nameTok = normalizeStandaloneImageName(pastedName)
+      if (!nameTok)
+        return
+      lastPastedImageName = { name: nameTok, at: Date.now() }
+      if (clipboardAttachInFlight)
+        return
+
+      clipboardAttachInFlight = { name: nameTok, startedAt: now }
+      setPromptForMode()
+      refreshPrompt()
+
+      queueMicrotask(async () => {
+        let didAttach = false
+        try {
+          const candidates = await readClipboardImageCandidatesDarwin()
+          if (!Array.isArray(candidates) || candidates.length === 0) {
+            // Clipboard is text-only; try resolving within the current workspace by basename.
+            const imgs = await getWorkspaceImages()
+            const lower = nameTok.toLowerCase()
+            const matches = imgs.filter(p => path.basename(String(p)).toLowerCase() === lower).slice(0, 8)
+            if (matches.length === 1) {
+              const rel = String(matches[0])
+              const abs = ensureAllowedFile(workspaceCwd(), rel)
+              const file = await readImageFileAsDataUrl(abs)
+              if (file?.dataUrl && String(file.mime).startsWith('image/')) {
+                addPendingImages([{
+                  name: path.basename(rel),
+                  mime: String(file.mime),
+                  bytes: Buffer.isBuffer(file.buf) ? file.buf.byteLength : 0,
+                  dataUrl: String(file.dataUrl),
+                }], 'path')
+                didAttach = true
+                if (stripTokenOnceFromLine(nameTok) || stripLeadingImageNameFromLine())
+                  rl._refreshLine?.()
+                showInlineHint(`Attached image from workspace: ${path.basename(rel)}`)
+              }
+            }
+            if (didAttach)
+              return
+
+            // If user has the file selected in Finder, we can still attach it even when clipboard is text-only.
+            const sel = await readFinderSelectionPathsDarwin()
+            if (Array.isArray(sel) && sel.length > 0) {
+              const picked = sel.find(p => path.basename(String(p)).toLowerCase() === lower) ?? (sel.length === 1 ? sel[0] : null)
+              if (picked) {
+                const file = await readImageFileAsDataUrl(String(picked))
+                if (file?.dataUrl && String(file.mime).startsWith('image/')) {
+                  addPendingImages([{
+                    name: path.basename(String(picked)),
+                    mime: String(file.mime),
+                    bytes: Buffer.isBuffer(file.buf) ? file.buf.byteLength : 0,
+                    dataUrl: String(file.dataUrl),
+                  }], 'paste')
+                  didAttach = true
+                  if (stripTokenOnceFromLine(nameTok) || stripLeadingImageNameFromLine())
+                    rl._refreshLine?.()
+                  showInlineHint(`Attached image from Finder selection: ${path.basename(String(picked))}`)
+                }
+              }
+            }
+            return
+          }
+
+          const lower = nameTok.toLowerCase()
+          const fileCandidates = candidates.filter(c => c?.source === 'file' && c?.absPath)
+          const picked = fileCandidates.find(c => path.basename(String(c.absPath)).toLowerCase() === lower)
+            ?? (fileCandidates.length === 1 ? fileCandidates[0] : null)
+            ?? (candidates.length === 1 ? candidates[0] : null)
+          if (!picked)
+            return
+          if (!picked?.dataUrl || typeof picked.dataUrl !== 'string' || !picked.dataUrl.startsWith('data:image/'))
+            return
+
+          addPendingImages([{
+            name: path.basename(String(picked.absPath ?? nameTok)),
+            mime: String(picked.mime ?? 'image/png'),
+            bytes: Buffer.isBuffer(picked.buf) ? picked.buf.byteLength : 0,
+            dataUrl: String(picked.dataUrl),
+          }], 'paste')
+          didAttach = true
+
+          if (stripTokenOnceFromLine(nameTok) || stripLeadingImageNameFromLine()) {
+            rl._refreshLine?.()
+          }
+          showInlineHint(`Attached image: ${path.basename(String(picked.absPath ?? nameTok))}`)
+        }
+        catch {
+          // ignore
+        }
+        finally {
+          if (!didAttach) {
+            // If we saw something that looks like an image filename but couldn't attach, hint why.
+            queueMicrotask(() => showInlineHint(`${icon('💡')}Tip: clipboard is text-only. In Finder, select the file (not rename text) then Cmd+C; or drag & drop; or use @image.`))
+          }
+          clipboardAttachInFlight = null
+          setPromptForMode()
+          refreshPrompt()
+        }
+      })
+    }
+
+    rl._ttyWrite = (s, key) => {
+      if (key?.ctrl && key?.name === 'o') {
+        if (clackDepth > 0)
+          return
+        if (busy) {
+          queueMicrotask(() => showInlineHint('busy (wait for current turn to finish)'))
+          return
+        }
+        queueMicrotask(() => {
+          void openAttachmentsFlow()
+        })
+        return
+      }
+
+      if (key?.ctrl && key?.name === 'g') {
+        if (pendingImages.length > 0) {
+          pendingImages = []
+          itermPasteBuffer = ''
+          clipboardAttachInFlight = null
+          setPromptForMode()
+          refreshPrompt()
+          queueMicrotask(() => showInlineHint('Cleared pending attachments.'))
+          return
+        }
+      }
+
+      // Normalize bracketed paste: \x1b[200~ ... \x1b[201~
+      // Some terminals emit the wrappers separately / across multiple chunks.
+      if (typeof s === 'string' && (bracketedPasteActive || s.includes('\u001B[200~') || s.includes('\u001B[201~'))) {
+        reset()
+        const beforeLine = rl.line
+        const BP_START = '\u001B[200~'
+        const BP_END = '\u001B[201~'
+        let chunk = s
+        let forward = ''
+
+        while (chunk.length > 0) {
+          if (!bracketedPasteActive) {
+            const startIdx = chunk.indexOf(BP_START)
+            if (startIdx === -1) {
+              forward += chunk
+              chunk = ''
+              break
+            }
+            forward += chunk.slice(0, startIdx)
+            chunk = chunk.slice(startIdx + BP_START.length)
+            bracketedPasteActive = true
+            bracketedPasteBuffer = ''
+            continue
+          }
+
+          const endIdx = chunk.indexOf(BP_END)
+          if (endIdx === -1) {
+            bracketedPasteBuffer += chunk
+            forward += chunk
+            chunk = ''
+            break
+          }
+
+          const pastePart = chunk.slice(0, endIdx)
+          bracketedPasteBuffer += pastePart
+          forward += pastePart
+          chunk = chunk.slice(endIdx + BP_END.length)
+          bracketedPasteActive = false
+
+          // Paste finished: try auto-attach from clipboard/Finder/workspace using the full pasted content.
+          if (String(beforeLine ?? '').trim() === '') {
+            const tok = normalizeStandaloneImageName(bracketedPasteBuffer)
+            if (tok)
+              maybeAutoAttachClipboardForPastedName(tok)
+          }
+          bracketedPasteBuffer = ''
+        }
+
+        if (forward)
+          return orig(forward, key)
+        return
+      }
+
+      // Handle iTerm2 image paste: \x1b]1337;File=...:base64\x07
+      if (!key && typeof s === 'string') {
+        reset()
+        const beforeLine = rl.line
+        const extracted = extractIterm2FilePastes(s, itermPasteBuffer)
+        itermPasteBuffer = extracted.buffer
+        if (Array.isArray(extracted.files) && extracted.files.length > 0) {
+          queueMicrotask(() => addPendingImages(extracted.files, 'paste'))
+        }
+        // Only forward non-OSC text. If we are buffering an incomplete OSC sequence, suppress output.
+        if (extracted.text && (!itermPasteBuffer || extracted.text.trim().length > 0)) {
+          const forwarded = extracted.text
+          const res = orig(forwarded, key)
+          // If a standalone image filename got pasted on an empty line, try turning it into a clipboard attachment.
+          if (String(beforeLine ?? '').trim() === '') {
+            const tok = normalizeStandaloneImageName(forwarded)
+            if (tok)
+              maybeAutoAttachClipboardForPastedName(tok)
+          }
+          return res
+        }
+        if (itermPasteBuffer)
+          return
+      }
+
+      // Some terminals provide paste chunks with a key object; try to detect standalone image names anyway.
+      if (typeof s === 'string' && s.length > 1 && !key?.ctrl && !key?.meta && !key?.alt) {
+        reset()
+        const beforeLine = rl.line
+        const res = orig(s, key)
+        if (String(beforeLine ?? '').trim() === '') {
+          const tok = normalizeStandaloneImageName(s)
+          if (tok)
+            maybeAutoAttachClipboardForPastedName(tok)
+        }
+        return res
+      }
+
+      if (key?.ctrl && key?.name === 'k') {
+        if (clackDepth > 0 || commandPaletteInFlight)
+          return
+        if (busy) {
+          queueMicrotask(() => showInlineHint('busy (wait for current turn to finish)'))
+          return
+        }
+        queueMicrotask(() => {
+          void openCommandPalette()
+        })
+        return
+      }
+      // Hint when user starts a mention.
+      if (s === '@' && rl.line.trim() === '' && Date.now() - lastHintAt > 2000) {
+        lastHintAt = Date.now()
+        queueMicrotask(() => showInlineHint(`${icon('💡')}Mentions: @continue @sessions @workspace @file @image/@img @clear @model @settings (Tab to cycle)`))
+      }
+
+      // Hint when user starts a slash command.
+      if (s === '/' && rl.line.trim() === '' && Date.now() - lastHintAt > 2000) {
+        lastHintAt = Date.now()
+        queueMicrotask(() => showInlineHint(`${icon('💡')}Commands: /help /sessions /workspace /files /images /settings /output /diag /edit /multiline /model /set … (Tab to cycle)`))
+      }
+
+      if (key?.name === 'tab') {
+        if (cycle())
+          return
+        // fall through to default completion if we didn't handle it
+      }
+      else if (key?.name !== 'shift' && key?.name !== 'ctrl' && key?.name !== 'alt') {
+        reset()
+      }
+
+      return orig(s, key)
+    }
+  }
+
+  attachTabCycler()
+
+  const setPromptForMode = () => {
+    const base = uiMode === 'select_session'
+      ? 'session> '
+      : multiline
+        ? '... '
+        : '> '
+    if (uiMode !== 'select_session' && (pendingImages.length > 0 || clipboardAttachInFlight || multiline) && process.stdout.isTTY) {
+      const maxShow = 4
+      const parts = pendingImages.slice(0, maxShow).map((img, idx) => {
+        const size = img.bytes ? ` (${humanBytes(img.bytes)})` : ''
+        return `[${idx + 1}] ${img.name}${size}`
+      })
+      const more = pendingImages.length > maxShow ? ` …(+${pendingImages.length - maxShow})` : ''
+      const attaching = clipboardAttachInFlight ? `attaching: ${clipboardAttachInFlight.name}…` : ''
+      const header = pendingImages.length > 0
+        ? `images: ${parts.join('  ')}${more}`
+        : attaching
+      const hint = multiline ? 'multiline: .send · .cancel' : 'Ctrl+O manage · Ctrl+G clear'
+      const extra = multiline && pendingImages.length > 0 ? 'Ctrl+O manage · Ctrl+G clear' : ''
+      const line1 = header || hint
+      const line2 = header ? hint : extra
+      rl.setPrompt(line2 ? `${line1}\n${line2}\n${base}` : `${line1}\n${base}`)
+      return
+    }
+    rl.setPrompt(base)
+  }
+  setPromptForMode()
+
+  const leaveSessionPickerUi = () => {
+    if (sessionPickerAlt) {
+      exitAltScreen()
+      sessionPickerAlt = false
+    }
+  }
+
+  const exit = () => {
+    if (activeAbort)
+      activeAbort.abort('cli_exit')
+    leaveSessionPickerUi()
+    exiting = true
+    void saveAll().finally(() => rl.close())
+  }
+
+  process.on('SIGINT', () => {
+    if (activeAbort) {
+      activeAbort.abort('sigint')
+      return
+    }
+    process.stdout.write('\n')
+    exit()
+  })
+
+  rl.on('close', () => {
+    exiting = true
+    void lineQueue
+      .finally(() => saveAll())
+      .finally(() => {
+        process.stdout.write('\n')
+        process.exit(0)
+      })
+  })
+
+  const handleSlash = async (trimmed) => {
+    const [cmdRaw, ...rest] = trimmed.trim().split(/\s+/)
+    const cmdInput = cmdRaw.slice(1).toLowerCase()
+    let cmd = cmdInput
+    const arg = rest.join(' ').trim()
+
+    const agent = agentRef.get()
+    const model = modelRef.get()
+
+    const resetToNewSession = async () => {
+      options.session.sessionId = randomUUID()
+      options.session.createdAt = Date.now()
+      options.session.title = undefined
+      options.session.summary = undefined
+      options.session.pinned = false
+      options.session.history = []
+      await saveAll()
+      process.stdout.write(`${ansi.green(`${icon('🆕')}new session:`)} ${options.session.sessionId}\n`)
+    }
+
+    const useSessionById = async (id) => {
+      if (!id) {
+        process.stdout.write(`${icon('❌')}Missing sessionId (try /sessions)\n`)
+        return false
+      }
+      const s = await loadSessionById(id)
+      if (!s) {
+        process.stdout.write(`${icon('❌')}Session not found: ${id}\n`)
+        return false
+      }
+      leaveSessionPickerUi()
+      options.session.sessionId = s.sessionId
+      options.session.createdAt = s.createdAt ?? Date.now()
+      options.session.title = s.title
+      options.session.summary = s.summary
+      options.session.pinned = Boolean(s.pinned)
+      options.session.history = Array.isArray(s.messages) ? s.messages : []
+      if (s.modelId && typeof model?.setModelId === 'function')
+        model.setModelId(s.modelId)
+      await saveAll()
+      uiMode = 'normal'
+      sessionPicker = null
+      setPromptForMode()
+      process.stdout.write('\n')
+      process.stdout.write(`${ansi.green(`${icon('🗂️')}using session:`)} ${options.session.sessionId}\n`)
+      if (options.session.history.length > 0) {
+        const title = options.session.title ?? deriveSessionTitle(options.session.history)
+        const summary = options.session.summary ?? deriveSessionSummary(options.session.history)
+        process.stdout.write(`${ansi.bold('Title:')} ${title}\n`)
+        if (summary)
+          process.stdout.write(`${ansi.bold('Summary:')} ${summary}\n`)
+        printHistory(options.session.history, { maxMessages: 12, maxCharsPerMessage: 400, emoji: uiPrefs?.emoji })
+      }
+      return true
+    }
+
+    const resolved = resolveCommand(cmdInput)
+    if (resolved.kind === 'prefix')
+      cmd = resolved.cmd
+    else if (resolved.kind === 'ambiguous') {
+      process.stdout.write(`${icon('❓')}ambiguous command: ${cmdRaw} (did you mean ${resolved.matches.map(m => `/${m}`).join(', ')}?)\n`)
+      return
+    }
+
+    if (cmd === 'help') {
+      await openCommandPalette()
+      return
+    }
+
+    if (cmd === 'multiline' || cmd === 'ml') {
+      if (busy) {
+        process.stdout.write(`${icon('⏳')}busy (Ctrl+C to cancel)\n`)
+        return
+      }
+      if (uiMode === 'select_session') {
+        process.stdout.write(`${icon('ℹ️')}Exit session picker first.\n`)
+        return
+      }
+      multiline = { lines: [] }
+      setPromptForMode()
+      showInlineHint('Multiline mode: type .send to send, .cancel to cancel.')
+      return
+    }
+
+    if (cmd === 'edit') {
+      if (busy) {
+        process.stdout.write(`${icon('⏳')}busy (Ctrl+C to cancel)\n`)
+        return
+      }
+      if (uiMode === 'select_session') {
+        process.stdout.write(`${icon('ℹ️')}Exit session picker first.\n`)
+        return
+      }
+      await openEditorFlow()
+      return
+    }
+
+    if (cmd === 'exit' || cmd === 'quit') {
+      exit()
+      return
+    }
+
+    if (cmd === 'tools') {
+      const list = typeof agent?.tools?.list === 'function' ? agent.tools.list() : []
+      process.stdout.write(`${icon('🧰')}${list.map(t => t.name).join(', ')}\n`)
+      return
+    }
+
+    if (cmd === 'status') {
+      printStatus({
+        version,
+        provider,
+        modelId: model.modelId,
+        sessionId: options.session.sessionId,
+        history: options.session.history,
+        agent,
+        baseUrl: baseUrlRef.get(),
+        requestDefaults,
+        workspaceCwd: workspaceCwd(),
+        emoji: uiPrefs?.emoji,
+      })
+      return
+    }
+
+    if (cmd === 'model') {
+      if (!arg) {
+        process.stdout.write(`${icon('🤖')}model: ${provider}/${model.modelId}\n`)
+        return
+      }
+      if (typeof model?.setModelId === 'function')
+        model.setModelId(arg)
+      await saveAll()
+      process.stdout.write(`${icon('🤖')}model set: ${provider}/${model.modelId}\n`)
+      return
+    }
+
+    if (cmd === 'params') {
+      const cfg = requestDefaults ?? {}
+      const cfgParts = [
+        typeof cfg.maxOutputTokens === 'number' ? `maxTokens=${cfg.maxOutputTokens}` : undefined,
+        typeof cfg.temperature === 'number' ? `temperature=${cfg.temperature}` : undefined,
+        typeof cfg.topP === 'number' ? `topP=${cfg.topP}` : undefined,
+        typeof cfg.presencePenalty === 'number' ? `presencePenalty=${cfg.presencePenalty}` : undefined,
+        typeof cfg.frequencyPenalty === 'number' ? `frequencyPenalty=${cfg.frequencyPenalty}` : undefined,
+        typeof cfg.seed === 'number' ? `seed=${cfg.seed}` : undefined,
+        typeof cfg.timeoutMs === 'number' ? `timeoutMs=${cfg.timeoutMs}` : undefined,
+      ].filter(Boolean)
+      process.stdout.write(`${icon('⚙️')}${cfgParts.join(' ')}\n`)
+      return
+    }
+
+    if (cmd === 'set') {
+      const [kRaw, ...vParts] = arg.split(/\s+/)
+      const vRaw = vParts.join(' ')
+      const parsed = parseParamValue(kRaw, vRaw)
+      if (!parsed.ok) {
+        process.stdout.write(`${icon('❌')}${parsed.error} (try /help)\n`)
+        return
+      }
+      const k = normalizeParamKey(kRaw)
+      requestDefaults[k] = parsed.value
+      await saveAll()
+      process.stdout.write(`${icon('⚙️')}set ${k}=${parsed.value}\n`)
+      return
+    }
+
+    if (cmd === 'unset') {
+      const k = normalizeParamKey(arg)
+      if (!k) {
+        process.stdout.write(`${icon('❌')}Missing key (try /help)\n`)
+        return
+      }
+      if (!(k in requestDefaults)) {
+        process.stdout.write(`${icon('❌')}unknown key: ${arg}\n`)
+        return
+      }
+      delete requestDefaults[k]
+      await saveAll()
+      process.stdout.write(`${icon('⚙️')}unset ${k}\n`)
+      return
+    }
+
+    if (cmd === 'api-key' || cmd === 'key') {
+      if (!arg) {
+        process.stdout.write(`${icon('❌')}Missing key (try /help)\n`)
+        return
+      }
+      setApiKey(arg)
+      if (typeof model?.resetClient === 'function')
+        model.resetClient()
+      await saveAll()
+      process.stdout.write(`${icon('🔑')}api key set\n`)
+      return
+    }
+
+    if (cmd === 'base-url') {
+      if (!arg) {
+        process.stdout.write(`${icon('❌')}Missing url (try /help)\n`)
+        return
+      }
+      await setBaseUrl(arg)
+      process.stdout.write(`${icon('🌐')}baseUrl set: ${baseUrlRef.get() ?? ''}\n`)
+      return
+    }
+
+    if (cmd === 'save') {
+      await saveAll()
+      process.stdout.write(`${icon('💾')}saved\n`)
+      return
+    }
+
+    if (cmd === 'workspace') {
+      await openWorkspaceFlow()
+      return
+    }
+
+    if (cmd === 'files') {
+      await openFilesFlow()
+      return
+    }
+
+    if (cmd === 'images') {
+      await openImagesFlow()
+      return
+    }
+
+    if (cmd === 'settings') {
+      await openSettingsFlow()
+      return
+    }
+
+    if (cmd === 'output') {
+      await openOutputFlow()
+      return
+    }
+
+    if (cmd === 'diag' || cmd === 'diagnostics') {
+      await openDiagnosticsFlow()
+      return
+    }
+
+    if (cmd === 'clipboard') {
+      const candidates = await readClipboardImageCandidatesDarwin()
+      const types = await readClipboardTypesDarwin()
+      const txt = await readClipboardTextDarwin()
+      const sel = await readFinderSelectionPathsDarwin()
+      const one = String(txt ?? '').split(/\r?\n/).find(Boolean) ?? ''
+      if (types)
+        process.stdout.write(`${icon('📋')}clipboard types: ${types}\n`)
+      if (one)
+        process.stdout.write(`${icon('📋')}clipboard text: ${formatOneLine(one, 120)}\n`)
+      if (Array.isArray(sel) && sel.length > 0) {
+        process.stdout.write(`${icon('🗂️')}finder selection: ${sel.slice(0, 3).map(p => path.basename(String(p))).join(', ')}\n`)
+      }
+
+      if (!Array.isArray(candidates) || candidates.length === 0) {
+        process.stdout.write(`${icon('📋')}clipboard: no attachable image found\n`)
+        process.stdout.write(`${icon('💡')}tip: clipboard is text-only. If you have the file selected in Finder, try pasting again (CLI can use Finder selection); otherwise drag & drop or use @image.\n`)
+        return
+      }
+      process.stdout.write(`${icon('🖼️')}clipboard images: ${candidates.length} candidate(s)\n`)
+      for (const c of candidates.slice(0, 6)) {
+        const src = c?.source ? String(c.source) : 'unknown'
+        const p = c?.absPath ? path.basename(String(c.absPath)) : ''
+        const mime = c?.mime ? String(c.mime) : ''
+        const bytes = c?.buf && Buffer.isBuffer(c.buf) ? c.buf.byteLength : (typeof c?.bytes === 'number' ? c.bytes : 0)
+        process.stdout.write(`- ${src}${p ? ` ${p}` : ''}${mime ? ` ${mime}` : ''}${bytes ? ` (${humanBytes(bytes)})` : ''}\n`)
+      }
+      if (candidates.length > 6)
+        process.stdout.write(`… (+${candidates.length - 6})\n`)
+      return
+    }
+
+    if (cmd === 'new') {
+      await resetToNewSession()
+      leaveSessionPickerUi()
+      uiMode = 'normal'
+      sessionPicker = null
+      setPromptForMode()
+      return
+    }
+
+    if (cmd === 'sessions') {
+      const sessions = await listSessions()
+      if (sessions.length === 0) {
+        process.stdout.write(`${icon('ℹ️')}[no sessions]\n`)
+        return
+      }
+
+      const uiPref = (uiPrefs?.sessionsUi ?? process.env.GOATCHAIN_SESSIONS_UI ?? 'auto').toLowerCase()
+      const canClack = process.stdout.isTTY && uiPref !== 'legacy' && useClack()
+      if (canClack) {
+        await withClack(async () => {
+          const actionRes = await selectWithClack({
+            message: 'Sessions',
+            options: [
+              { value: 'open', label: label('🗂️', 'Open a session') },
+              { value: 'rename', label: label('✏️', 'Rename a session…') },
+              { value: 'pin', label: label('📌', 'Pin session(s)…') },
+              { value: 'unpin', label: label('📍', 'Unpin session(s)…') },
+              { value: 'export', label: label('📤', 'Export session(s)…') },
+              { value: 'import', label: label('📥', 'Import session(s) from JSON…') },
+              { value: 'delete', label: label('🗑️', 'Delete session(s)…') },
+            ],
+            initialValue: 0,
+          })
+          if (!actionRes.ok)
+            return
+
+          const cols = process.stdout.isTTY && typeof process.stdout.columns === 'number' && process.stdout.columns > 0
+            ? process.stdout.columns
+            : 120
+          const titleBudget = Math.max(18, Math.min(52, Math.floor(cols * 0.4)))
+          const summaryBudget = Math.max(0, cols - (8 + titleBudget + 22))
+
+          const optionsList = sessions.slice(0, 120).map((s) => {
+            const msgCount = Array.isArray(s.messages) ? s.messages.length : 0
+            const pin = s.pinned ? '★ ' : ''
+            const title = `${pin}${formatOneLine(s.title ?? 'New session', Math.max(6, titleBudget - pin.length))}`
+            const when = formatWhen(s.updatedAt)
+            const idShort = typeof s.sessionId === 'string' ? s.sessionId.slice(-8) : ''
+            const meta = formatOneLine(`${msgCount} msgs · ${when}${idShort ? ` · ${idShort}` : ''}`, 26)
+            const summary = summaryBudget >= 18 ? formatOneLine(s.summary ?? '', summaryBudget) : ''
+            const label = `${title} (${meta})${summary ? ` — ${summary}` : ''}`
+            return { value: s.sessionId, label }
+          })
+
+          if (actionRes.value === 'open') {
+            const initialValue = sessions.findIndex(s => s.sessionId === options.session.sessionId)
+            const res = await selectWithClack({
+              message: 'Select a session',
+              options: optionsList,
+              initialValue: initialValue >= 0 ? initialValue : 0,
+            })
+            if (res.ok)
+              await useSessionById(String(res.value))
+            return
+          }
+
+          if (actionRes.value === 'rename') {
+            if (!renameSessionById) {
+              process.stdout.write(`${icon('❌')}Rename is not configured (missing renameSessionById)\n`)
+              return
+            }
+            const initialValue = sessions.findIndex(s => s.sessionId === options.session.sessionId)
+            const picked = await selectWithClack({
+              message: 'Select a session to rename',
+              options: optionsList,
+              initialValue: initialValue >= 0 ? initialValue : 0,
+            })
+            if (!picked.ok)
+              return
+
+            const id = String(picked.value)
+            const current = sessions.find(s => s.sessionId === id)
+            const txt = await textWithClack({ message: 'New title', placeholder: current?.title ?? 'New session' })
+            if (!txt.ok)
+              return
+            const title = String(txt.value ?? '').trim()
+            await renameSessionById(id, title)
+            if (id === options.session.sessionId) {
+              options.session.title = title
+              await saveAll()
+            }
+            process.stdout.write(`${ansi.green(`${icon('✏️')}renamed:`)} ${id}\n`)
+            return
+          }
+
+          if (actionRes.value === 'pin' || actionRes.value === 'unpin') {
+            if (!setPinnedSessionsById) {
+              process.stdout.write(`${icon('❌')}Pin is not configured (missing setPinnedSessionsById)\n`)
+              return
+            }
+            const pick = await multiselectWithClack({
+              message: actionRes.value === 'pin' ? 'Select sessions to pin' : 'Select sessions to unpin',
+              options: optionsList,
+              required: true,
+            })
+            if (!pick.ok)
+              return
+            const ids = Array.isArray(pick.value) ? pick.value.map(String) : []
+            if (ids.length === 0)
+              return
+            const pinned = actionRes.value === 'pin'
+            await setPinnedSessionsById(ids, pinned)
+            if (ids.includes(options.session.sessionId)) {
+              options.session.pinned = pinned
+              await saveAll()
+            }
+            process.stdout.write(`${ansi.green(`${icon(pinned ? '📌' : '📍')}${pinned ? 'pinned:' : 'unpinned:'}`)} ${ids.length} session(s)\n`)
+            return
+          }
+
+          if (actionRes.value === 'export') {
+            const pick = await multiselectWithClack({
+              message: 'Select sessions to export',
+              options: optionsList,
+              required: true,
+            })
+            if (!pick.ok)
+              return
+            const ids = Array.isArray(pick.value) ? pick.value.map(String) : []
+            if (ids.length === 0)
+              return
+
+            const fmtRes = await selectWithClack({
+              message: 'Export format',
+              options: [
+                { value: 'json', label: 'JSON (bundle)' },
+                { value: 'md', label: 'Markdown' },
+              ],
+              initialValue: 0,
+            })
+            if (!fmtRes.ok)
+              return
+            const fmt = String(fmtRes.value)
+
+            const stamp = new Date().toISOString().replace(/[:.]/g, '-')
+            const defaultName = `sessions-export-${stamp}.${fmt === 'md' ? 'md' : 'json'}`
+            const outRes = await textWithClack({ message: 'Output file (workspace-relative)', placeholder: defaultName })
+            if (!outRes.ok)
+              return
+            const relOut = String(outRes.value ?? '').trim() || defaultName
+            const absOut = path.resolve(workspaceCwd(), relOut)
+            const rel = path.relative(workspaceCwd(), absOut)
+            if (rel.startsWith('..') || path.isAbsolute(rel)) {
+              process.stdout.write(`${icon('❌')}Export path must be inside the workspace\n`)
+              return
+            }
+
+            const confirmRes = await confirmWithClack({ message: `Write ${relOut}?`, initialValue: true })
+            if (!confirmRes.ok || !confirmRes.value)
+              return
+
+            const selected = selectSessionsById(sessions, ids)
+            if (fmt === 'md') {
+              await writeFile(absOut, sessionsToMarkdown(selected), 'utf8')
+            }
+            else {
+              const bundle = buildSessionsExportBundle(selected)
+              await writeFile(absOut, `${JSON.stringify(bundle, null, 2)}\n`, 'utf8')
+            }
+
+            process.stdout.write(`${ansi.green(`${icon('📤')}exported:`)} ${ids.length} session(s) -> ${relOut}\n`)
+            return
+          }
+
+          if (actionRes.value === 'import') {
+            if (!saveSessionByData) {
+              process.stdout.write(`${icon('❌')}Import is not configured (missing saveSessionByData)\n`)
+              return
+            }
+            const inRes = await textWithClack({ message: 'JSON file to import (workspace-relative)', placeholder: 'sessions-export.json' })
+            if (!inRes.ok)
+              return
+            const relIn = String(inRes.value ?? '').trim()
+            if (!relIn)
+              return
+            const absIn = path.resolve(workspaceCwd(), relIn)
+            const rel = path.relative(workspaceCwd(), absIn)
+            if (rel.startsWith('..') || path.isAbsolute(rel)) {
+              process.stdout.write(`${icon('❌')}Import path must be inside the workspace\n`)
+              return
+            }
+            let parsed
+            try {
+              parsed = JSON.parse(await readFile(absIn, 'utf8'))
+            }
+            catch (err) {
+              process.stdout.write(`${icon('❌')}Failed to read JSON: ${err instanceof Error ? err.message : String(err)}\n`)
+              return
+            }
+
+            const rawSessions = parseSessionsImportJson(parsed)
+
+            if (rawSessions.length === 0) {
+              process.stdout.write(`${icon('ℹ️')}No sessions found in JSON\n`)
+              return
+            }
+
+            const conflictRes = await selectWithClack({
+              message: 'On sessionId conflict',
+              options: [
+                { value: 'new_ids', label: 'Create new IDs' },
+                { value: 'overwrite', label: 'Overwrite' },
+                { value: 'skip', label: 'Skip conflicts' },
+              ],
+              initialValue: 0,
+            })
+            if (!conflictRes.ok)
+              return
+            const conflict = String(conflictRes.value)
+
+            const plan = await planSessionImports(rawSessions, {
+              conflict,
+              exists: async (id) => Boolean(await loadSessionById(id)),
+              makeId: () => randomUUID(),
+            })
+
+            for (const item of plan) {
+              // eslint-disable-next-line no-await-in-loop
+              await saveSessionByData(item.session)
+            }
+
+            process.stdout.write(`${ansi.green(`${icon('📥')}imported:`)} ${plan.length} session(s)\n`)
+            return
+          }
+
+          if (actionRes.value === 'delete') {
+            if (!deleteSessionsById && !deleteSessionById) {
+              process.stdout.write(`${icon('❌')}Delete is not configured (missing deleteSessionsById)\n`)
+              return
+            }
+
+            const pick = await multiselectWithClack({
+              message: 'Select sessions to delete',
+              options: optionsList,
+              required: true,
+            })
+            if (!pick.ok)
+              return
+
+            const ids = Array.isArray(pick.value) ? pick.value.map(String) : []
+            if (ids.length === 0)
+              return
+
+            const confirmRes = await confirmWithClack({
+              message: `Delete ${ids.length} session(s)? This cannot be undone.`,
+              initialValue: false,
+            })
+            if (!confirmRes.ok || !confirmRes.value)
+              return
+
+            if (deleteSessionsById) {
+              await deleteSessionsById(ids)
+            }
+            else {
+              for (const id of ids) {
+                // eslint-disable-next-line no-await-in-loop
+                await deleteSessionById(id)
+              }
+            }
+
+            process.stdout.write(`${ansi.yellow(`${icon('🗑️')}deleted:`)} ${ids.length} session(s)\n`)
+
+            if (ids.includes(options.session.sessionId)) {
+              const remaining = await listSessions()
+              if (remaining.length > 0)
+                await useSessionById(remaining[0].sessionId)
+              else
+                await resetToNewSession()
+            }
+            return
+          }
+        })
+        return
+      }
+
+      uiMode = 'select_session'
+      sessionPicker = { sessions, filter: '' }
+      if (!sessionPickerAlt)
+        sessionPickerAlt = enterAltScreen()
+      setPromptForMode()
+      renderSessionPicker({
+        sessions,
+        currentSessionId: options.session.sessionId,
+        filter: '',
+        alt: sessionPickerAlt,
+        emoji: uiPrefs?.emoji,
+      })
+      return
+    }
+
+    if (cmd === 'rm' || cmd === 'delete') {
+      const ids = arg.split(/\s+/).filter(Boolean)
+      if (ids.length === 0) {
+        process.stdout.write(`${icon('ℹ️')}Usage: /rm <sessionId...>\n`)
+        return
+      }
+      if (!deleteSessionsById && !deleteSessionById) {
+        process.stdout.write(`${icon('❌')}Delete is not configured\n`)
+        return
+      }
+      if (useClack() && process.stdout.isTTY) {
+        const uniqueIds = [...new Set(ids)]
+        const previews = await Promise.all(
+          uniqueIds.map(async (id) => {
+            try {
+              const s = await loadSessionById(id)
+              if (!s)
+                return { id, missing: true }
+              const msgs = Array.isArray(s.messages) ? s.messages : []
+              const title = s.title ?? deriveSessionTitle(msgs)
+              const summary = s.summary ?? deriveSessionSummary(msgs)
+              return { id, title, summary, missing: false }
+            }
+            catch {
+              return { id, missing: true }
+            }
+          }),
+        )
+        process.stdout.write(`${ansi.bold('About to delete:')}\n`)
+        for (const p of previews.slice(0, 12)) {
+          if (p.missing) {
+            process.stdout.write(`- ${p.id} (not found)\n`)
+            continue
+          }
+          const title = p.title ? formatOneLine(String(p.title), 80) : ''
+          process.stdout.write(`- ${p.id}${title ? ` — ${title}` : ''}\n`)
+        }
+        if (previews.length > 12)
+          process.stdout.write(`… (+${previews.length - 12})\n`)
+        const confirmRes = await withClack(() => confirmWithClack({
+          message: `Delete ${uniqueIds.length} session(s)? This cannot be undone.`,
+          initialValue: false,
+        }))
+        if (!confirmRes.ok || !confirmRes.value)
+          return
+      }
+      else {
+        const q = `Delete ${ids.length} session(s)? [y/N] `
+        const ans = await new Promise(resolve => rl.question(q, resolve))
+        const ok = String(ans ?? '').trim().toLowerCase()
+        if (!(ok === 'y' || ok === 'yes'))
+          return
+      }
+      if (deleteSessionsById)
+        await deleteSessionsById(ids)
+      else {
+        for (const id of ids) {
+          // eslint-disable-next-line no-await-in-loop
+          await deleteSessionById(id)
+        }
+      }
+      process.stdout.write(`${ansi.yellow(`${icon('🗑️')}deleted:`)} ${ids.length} session(s)\n`)
+      if (ids.includes(options.session.sessionId)) {
+        const remaining = await listSessions()
+        if (remaining.length > 0)
+          await useSessionById(remaining[0].sessionId)
+        else
+          await resetToNewSession()
+      }
+      return
+    }
+
+    if (cmd === 'use') {
+      await useSessionById(arg)
+      return
+    }
+
+    const suggestion = resolveCommand(cmdInput)
+    if (suggestion.kind === 'fuzzy' || suggestion.kind === 'contains') {
+      process.stdout.write(`${icon('❓')}unknown command: ${cmdRaw} (did you mean ${suggestion.matches.map(m => `/${m}`).join(', ')}?)\n`)
+      return
+    }
+    process.stdout.write(`${icon('❓')}unknown command: ${cmdRaw} (try /help)\n`)
+  }
+
+  process.stdout.write(`${icon('💡')}Type /help for commands. Ctrl+K for palette. Ctrl+C to cancel/exit.\n`)
+  if (options.session.history.length > 0) {
+    const title = options.session.title ?? deriveSessionTitle(options.session.history)
+    const summary = options.session.summary ?? deriveSessionSummary(options.session.history)
+    process.stdout.write(`${icon('🗂️')}Restored session: ${options.session.sessionId}\n`)
+    process.stdout.write(`Title: ${title}\n`)
+    if (summary)
+      process.stdout.write(`Summary: ${summary}\n`)
+    printHistory(options.session.history, { maxMessages: 8, maxCharsPerMessage: 240, emoji: uiPrefs?.emoji })
+    process.stdout.write('\n')
+  }
+  rl.prompt()
+
+  const rewriteAllFileMentions = (text, mode) => {
+    const m = String(mode ?? 'summary').trim().toLowerCase()
+    if (m !== 'path' && m !== 'summary' && m !== 'full')
+      return String(text ?? '')
+    return String(text ?? '').replace(/@file(?:\((?:path|summary|full)\))?:/g, `@file(${m}):`)
+  }
+
+  const runChatTurn = async (inputText) => {
+    busy = true
+    activeAbort = new AbortController()
+    const rawInput = String(inputText ?? '').trim()
+    let input = rawInput
+    let pushed = false
+
+    const stripTokenOnce = (text, token) => {
+      const t = String(text ?? '')
+      const tok = String(token ?? '').trim()
+      if (!tok)
+        return t
+      // remove the first occurrence when it is token-delimited by whitespace or punctuation
+      const idx = t.indexOf(tok)
+      if (idx < 0)
+        return t
+      const before = idx === 0 ? '' : t[idx - 1]
+      const after = idx + tok.length >= t.length ? '' : t[idx + tok.length]
+      const okBefore = !before || /\s|[，,。.!?？:：;；、()[\]{}"'“”‘’]/.test(before)
+      const okAfter = !after || /\s|[，,。.!?？:：;；、()[\]{}"'“”‘’]/.test(after)
+      if (!okBefore || !okAfter)
+        return t
+      return `${t.slice(0, idx)} ${t.slice(idx + tok.length)}`.replace(/\s{2,}/g, ' ').trim()
+    }
+
+    const maybeImageNameToken = () => {
+      // heuristic: a single filename-ish token with image extension (no slashes), allow accidental spaces around dot.
+      const m = rawInput.match(/(^|\s)([^\s/\\]+?)(?:\s*\.\s*)(png|jpg|jpeg|webp|gif|bmp|tiff?|heic)(?=\s|[，,。.!?？:：;；、()[\]{}"'“”‘’]|$)/i)
+      if (!m)
+        return null
+      const base = String(m[2] ?? '').trim()
+      const ext = String(m[3] ?? '').trim().toLowerCase()
+      if (!base || !ext)
+        return null
+      // avoid triggering when user is already using explicit markers
+      if (rawInput.includes('@image') || rawInput.includes('@img'))
+        return null
+      return `${base}.${ext}`
+    }
+
+    // If the user pasted an image but only a filename got inserted, try to attach from clipboard.
+    if (pendingImages.length === 0) {
+      const tok = maybeImageNameToken()
+      if (tok) {
+        const candidates = await readClipboardImageCandidatesDarwin()
+        const lower = tok.toLowerCase()
+        const candidate = (Array.isArray(candidates) && candidates.length > 0)
+          ? (candidates.find(c => c?.absPath && path.basename(String(c.absPath)).toLowerCase() === lower) ?? candidates[0])
+          : null
+        if (!candidate) {
+          if (process.stdout.isTTY) {
+            process.stdout.write(ansi.dim('(no image found in clipboard; send text only — use cmd+v in iTerm2 or @image to attach)\n'))
+          }
+        }
+        else if (typeof candidate.dataUrl === 'string' && candidate.dataUrl.startsWith('data:image/')) {
+          let allow = true
+          if (process.stdout.isTTY) {
+            if (useClack()) {
+              await withClack(async () => {
+                const res = await confirmWithClack({
+                  message: `Attach image from clipboard as “${tok}”?`,
+                  initialValue: true,
+                })
+                allow = Boolean(res.ok && res.value)
+              })
+            }
+            else {
+              const ans = await new Promise(resolve => rl.question(`Attach image from clipboard as "${tok}"? [Y/n] `, resolve))
+              const ok = String(ans ?? '').trim().toLowerCase()
+              allow = ok === '' || ok === 'y' || ok === 'yes'
+            }
+          }
+          if (allow) {
+            pendingImages.push({
+              name: tok,
+              mime: candidate.mime,
+              bytes: Buffer.isBuffer(candidate.buf) ? candidate.buf.byteLength : 0,
+              dataUrl: candidate.dataUrl,
+              source: 'paste',
+            })
+            input = stripTokenOnce(input, tok)
+            setPromptForMode()
+            refreshPrompt()
+          }
+        }
+      }
+    }
+
+    if (input.includes('@file')) {
+      try {
+        let expanded = await expandFileMentions(workspaceCwd(), input, {
+          maxTotalBytes: 220_000,
+          maxBytesPerFile: 120_000,
+          maxBytesPerFileSummary: 40_000,
+          headLines: 80,
+          tailLines: 30,
+        })
+
+        const omitted = Array.isArray(expanded.omitted) ? expanded.omitted : []
+        const hasBudgetOmit = omitted.some(o => o && o.reason === 'budget')
+        const files = Array.isArray(expanded.files) ? expanded.files : []
+        const hasFullTrunc = files.some(f => f && f.mode === 'full' && f.truncated)
+
+        if ((hasBudgetOmit || hasFullTrunc) && process.stdout.isTTY) {
+          let decision = /** @type {'proceed'|'summary'|'path'|'cancel'} */ ('proceed')
+          if (useClack()) {
+            await withClack(async () => {
+              const res = await selectWithClack({
+                message: 'File attachments exceed budget',
+                options: [
+                  { value: 'proceed', label: 'Proceed (some may be truncated/omitted)' },
+                  { value: 'summary', label: 'Downgrade to Summary' },
+                  { value: 'path', label: 'Paths only (no content)' },
+                  { value: 'cancel', label: 'Cancel send' },
+                ],
+                initialValue: 1,
+              })
+              if (!res.ok) {
+                decision = 'cancel'
+                return
+              }
+              decision = /** @type {any} */ (String(res.value))
+            })
+          }
+          else {
+            const ans = await new Promise(resolve => rl.question('Attachments exceed budget. Use Summary instead? [Y/n] ', resolve))
+            const ok = String(ans ?? '').trim().toLowerCase()
+            decision = ok === '' || ok === 'y' || ok === 'yes' ? 'summary' : 'proceed'
+          }
+
+          if (decision === 'cancel') {
+            busy = false
+            activeAbort = null
+            return
+          }
+
+          if (decision === 'summary') {
+            const rewritten = rewriteAllFileMentions(input, 'summary')
+            expanded = await expandFileMentions(workspaceCwd(), rewritten, {
+              maxTotalBytes: 220_000,
+              maxBytesPerFile: 120_000,
+              maxBytesPerFileSummary: 40_000,
+              headLines: 80,
+              tailLines: 30,
+            })
+          }
+          else if (decision === 'path') {
+            const rewritten = rewriteAllFileMentions(input, 'path')
+            expanded = await expandFileMentions(workspaceCwd(), rewritten, {
+              maxTotalBytes: 220_000,
+              maxBytesPerFile: 120_000,
+              maxBytesPerFileSummary: 40_000,
+              headLines: 80,
+              tailLines: 30,
+            })
+          }
+        }
+
+        input = expanded.text
+        const fileCount = Array.isArray(expanded.files) ? expanded.files.length : 0
+        if (fileCount > 0)
+          process.stdout.write(ansi.dim(`(${icon('📎')}attached ${fileCount} file(s))\n`))
+      }
+      catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+        busy = false
+        activeAbort = null
+        return
+      }
+    }
+
+    const hasImageMarkers = input.includes('@image') || input.includes('@img')
+    const hasPendingImages = pendingImages.length > 0
+
+    /** @type {any} */
+    let modelInput = input
+    /** @type {string} */
+    let historyContent = input
+
+    const consumedPending = hasPendingImages ? [...pendingImages] : []
+
+    if (hasImageMarkers || hasPendingImages) {
+      try {
+        let cleanedText = input
+        /** @type {any[]} */
+        let blocks = []
+        /** @type {Array<{ relPath?: string, name?: string }>} */
+        let markerImages = []
+
+        if (hasImageMarkers) {
+          const expanded = await expandImageMentions(input)
+          cleanedText = expanded.cleanedText
+          markerImages = Array.isArray(expanded.images) ? expanded.images : []
+          blocks = Array.isArray(expanded.blocks)
+            ? expanded.blocks
+            : (cleanedText ? [{ type: 'text', text: cleanedText }] : [])
+        }
+        else {
+          blocks = cleanedText ? [{ type: 'text', text: cleanedText }] : []
+        }
+
+        // Add pending images (from paste or other sources) without polluting the stored history.
+        for (const img of consumedPending) {
+          if (!img?.dataUrl)
+            continue
+          blocks.push({ type: 'image', source: { data: img.dataUrl } })
+        }
+
+        const names = [
+          ...markerImages.map(i => String(i?.relPath ?? i?.name ?? '').trim()).filter(Boolean),
+          ...consumedPending.map(i => String(i?.name ?? '').trim()).filter(Boolean),
+        ]
+
+        if (names.length > 0) {
+          historyContent = [
+            cleanedText,
+            '[attached images]',
+            ...names.map(n => `- ${n}`),
+          ].filter(Boolean).join('\n')
+        }
+        else {
+          historyContent = cleanedText
+        }
+
+        modelInput = blocks.length > 0 ? blocks : cleanedText
+
+        const count = names.length
+        if (count > 0)
+          process.stdout.write(ansi.dim(`(${icon('🖼️')}attached ${count} image(s))\n`))
+      }
+      catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+        busy = false
+        activeAbort = null
+        return
+      }
+    }
+
+    // Persist a compact history (no base64), but send full multimodal content to the model.
+    options.session.history.push({ role: 'user', content: historyContent })
+    pushed = true
+
+    const prevPendingImages = pendingImages
+    if (consumedPending.length > 0) {
+      pendingImages = []
+      setPromptForMode()
+    }
+
+    try {
+      const { messagesToAppend, meta } = await runTurnWithApprovals({
+        agent: agentRef.get(),
+        sessionId: options.session.sessionId,
+        history: options.session.history.slice(0, -1),
+        input: modelInput,
+        signal: activeAbort.signal,
+        approvalStrategy: 'high_risk',
+        autoApprove: process.env.GOATCHAIN_AUTO_APPROVE === '1',
+        askApproval: (q) => new Promise(resolve => rl.question(q, resolve)),
+        askApprovalForTool: useClack() && process.stdout.isTTY
+          ? async ({ toolName, riskLevel, display }) => {
+              const risk = riskLevel ? ` (${riskLevel})` : ''
+              const lines = display?.lines && Array.isArray(display.lines) ? display.lines : []
+              process.stdout.write(`\n${ansi.bold('Approval required:')} ${String(toolName ?? 'tool')}${risk}\n`)
+              for (const line of lines.slice(0, 10))
+                process.stdout.write(`${ansi.dim(`- ${line}`)}\n`)
+              if (lines.length > 10)
+                process.stdout.write(`${ansi.dim(`… (+${lines.length - 10})`)}\n`)
+              const res = await withClack(() => selectWithClack({
+                message: 'Allow this tool?',
+                options: [
+                  { value: 'approve', label: label('✅', 'Approve (once)') },
+                  { value: 'approve_all', label: label('🧷', 'Approve all tools (this turn)') },
+                  { value: 'deny', label: label('❌', 'Deny') },
+                  { value: 'abort', label: label('🛑', 'Abort turn') },
+                ],
+                initialValue: 2,
+              }))
+              if (!res.ok)
+                return 'deny'
+              return String(res.value)
+            }
+          : undefined,
+        showTools: typeof uiPrefs?.showTools === 'boolean' ? uiPrefs.showTools : undefined,
+        toolStyle: typeof uiPrefs?.toolStyle === 'string' ? uiPrefs.toolStyle : undefined,
+        showStatus: typeof uiPrefs?.showStatus === 'boolean' ? uiPrefs.showStatus : undefined,
+        showStatusLine: typeof uiPrefs?.showStatusLine === 'boolean' ? uiPrefs.showStatusLine : undefined,
+        emoji: typeof uiPrefs?.emoji === 'boolean' ? uiPrefs.emoji : undefined,
+        promptContinue: typeof uiPrefs?.promptContinue === 'boolean' ? uiPrefs.promptContinue : undefined,
+        autoContinue: typeof uiPrefs?.autoContinue === 'boolean' ? uiPrefs.autoContinue : undefined,
+      })
+      lastTurnMeta = meta ?? lastTurnMeta
+      options.session.history.push(...messagesToAppend)
+      await saveAll()
+    }
+    catch (err) {
+      process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+      if (pushed)
+        options.session.history.pop()
+      if (consumedPending.length > 0) {
+        pendingImages = prevPendingImages
+        setPromptForMode()
+      }
+    }
+    finally {
+      busy = false
+      activeAbort = null
+    }
+  }
+
+  const openEditorFlow = async () => {
+    const editor = process.env.VISUAL || process.env.EDITOR || 'vi'
+    const { tmpdir } = await import('node:os')
+    const { spawnSync } = await import('node:child_process')
+    const { mkdtemp, readFile, rm, writeFile } = await import('node:fs/promises')
+
+    const quote = (s) => {
+      if (process.platform === 'win32')
+        return `"${String(s).replace(/"/g, '\\"')}"`
+      return `'${String(s).replace(/'/g, `'\\''`)}'`
+    }
+
+    const dir = await mkdtemp(path.join(tmpdir(), 'goatchain-edit-'))
+    const filePath = path.join(dir, 'message.md')
+    await writeFile(filePath, '', 'utf8')
+
+    const wasPaused = rl.paused
+    if (!wasPaused)
+      rl.pause()
+    try {
+      const cmd = `${editor} ${quote(filePath)}`
+      const res = spawnSync(cmd, { stdio: 'inherit', shell: true })
+      if (typeof res.status === 'number' && res.status !== 0) {
+        process.stdout.write(`${icon('❌')}Editor exited with status ${res.status}\n`)
+        return
+      }
+      const text = String(await readFile(filePath, 'utf8') ?? '').replace(/\r\n/g, '\n').trim()
+      if (!text) {
+        showInlineHint('Canceled (empty message).')
+        return
+      }
+      await runChatTurn(text)
+    }
+    finally {
+      if (!wasPaused)
+        rl.resume()
+      await rm(dir, { recursive: true, force: true })
+    }
+  }
+
+  const openModelFlow = async () => {
+    const model = modelRef.get()
+    const current = model?.modelId ? String(model.modelId) : ''
+    const rawPresets = String(process.env.GOATCHAIN_MODEL_PRESETS ?? '')
+    const presets = rawPresets
+      .split(',')
+      .map(s => s.trim())
+      .filter(Boolean)
+    const defaults = ['deepseek-v3.1', 'gpt-4o', 'gpt-4o-mini']
+    const list = [current, ...presets, ...defaults].filter(Boolean)
+    const uniq = [...new Set(list)].slice(0, 20)
+
+    const opts = [
+      ...uniq.map(v => ({ value: v, label: v })),
+      { value: '__custom__', label: 'Custom…' },
+    ]
+    const picked = await selectWithClack({
+      message: 'Select model',
+      options: opts,
+      initialValue: 0,
+    })
+    if (!picked.ok)
+      return
+
+    let nextId = String(picked.value)
+    if (nextId === '__custom__') {
+      const txt = await textWithClack({ message: 'Model id', placeholder: 'e.g. gpt-4o-mini' })
+      if (!txt.ok)
+        return
+      nextId = String(txt.value).trim()
+    }
+    if (!nextId)
+      return
+    if (typeof model?.setModelId === 'function')
+      model.setModelId(nextId)
+    await saveAll()
+    process.stdout.write(`${icon('🤖')}model set: ${provider}/${model.modelId}\n`)
+  }
+
+  const openSettingsFlow = async () => {
+    const model = modelRef.get()
+    if (!useClack()) {
+      if (!process.stdout.isTTY) {
+        process.stdout.write(
+          [
+            'Settings:',
+            '- /base-url <url>',
+            '- /api-key <key>',
+            '- /set maxTokens <n>',
+            '- Set env GOATCHAIN_AUTO_APPROVE=1 to skip approval prompts.',
+            '',
+          ].join('\n'),
+        )
+        return
+      }
+
+      const ans = await new Promise(resolve => rl.question('Settings: [1] base-url [2] api-key [3] maxTokens [4] autoApprove info (empty cancel): ', resolve))
+      const pick = String(ans ?? '').trim()
+      if (!pick)
+        return
+
+      if (pick === '1' || pick.toLowerCase() === 'base-url') {
+        const val = await new Promise(resolve => rl.question('Base URL: ', resolve))
+        const url = String(val ?? '').trim()
+        if (!url)
+          return
+        await setBaseUrl(url)
+        process.stdout.write(`${icon('🌐')}baseUrl set: ${baseUrlRef.get() ?? ''}\n`)
+        return
+      }
+
+      if (pick === '2' || pick.toLowerCase() === 'api-key') {
+        process.stdout.write('For security, use /api-key <key> (note: your shell history may record it) or set OPENAI_API_KEY.\n')
+        return
+      }
+
+      if (pick === '3' || pick.toLowerCase() === 'maxtokens') {
+        const val = await new Promise(resolve => rl.question(`Max tokens (current: ${String(requestDefaults.maxOutputTokens ?? '') || '∅'}): `, resolve))
+        const n = Number.parseInt(String(val ?? '').trim(), 10)
+        if (!Number.isFinite(n) || n <= 0) {
+          process.stdout.write('Invalid maxTokens\n')
+          return
+        }
+        requestDefaults.maxOutputTokens = n
+        await saveAll()
+        process.stdout.write(`${icon('⚙️')}set maxTokens=${n}\n`)
+        return
+      }
+
+      if (pick === '4' || pick.toLowerCase() === 'autoapprove') {
+        process.stdout.write('Set env GOATCHAIN_AUTO_APPROVE=1 to skip approval prompts.\n')
+        return
+      }
+
+      return
+    }
+
+    const k = await selectWithClack({
+      message: 'Settings',
+      options: [
+        { value: 'baseUrl', label: label('🌐', 'Base URL') },
+        { value: 'apiKey', label: label('🔑', 'API key') },
+        { value: 'maxTokens', label: label('⚙️', 'Max tokens') },
+        { value: 'autoApprove', label: label('🧷', 'Auto approve tools (env)') },
+      ],
+      initialValue: 0,
+    })
+    if (!k.ok)
+      return
+
+    if (k.value === 'baseUrl') {
+      const txt = await textWithClack({ message: 'Base URL', placeholder: baseUrlRef.get() ?? 'https://…/v1' })
+      if (!txt.ok)
+        return
+      const url = String(txt.value).trim()
+      if (!url)
+        return
+      await setBaseUrl(url)
+      process.stdout.write(`${icon('🌐')}baseUrl set: ${baseUrlRef.get() ?? ''}\n`)
+      return
+    }
+
+    if (k.value === 'apiKey') {
+      const pwd = await passwordWithClack({ message: 'API key', placeholder: 'sk-…' })
+      if (!pwd.ok)
+        return
+      const key = String(pwd.value).trim()
+      if (!key)
+        return
+      setApiKey(key)
+      if (typeof model?.resetClient === 'function')
+        model.resetClient()
+      await saveAll()
+      process.stdout.write(`${icon('🔑')}api key set\n`)
+      return
+    }
+
+    if (k.value === 'maxTokens') {
+      const txt = await textWithClack({ message: 'Max tokens', placeholder: String(requestDefaults.maxOutputTokens ?? '') })
+      if (!txt.ok)
+        return
+      const n = Number.parseInt(String(txt.value).trim(), 10)
+      if (!Number.isFinite(n) || n <= 0) {
+        process.stdout.write('Invalid maxTokens\n')
+        return
+      }
+      requestDefaults.maxOutputTokens = n
+      await saveAll()
+      process.stdout.write(`${icon('⚙️')}set maxTokens=${n}\n`)
+      return
+    }
+
+    if (k.value === 'autoApprove') {
+      process.stdout.write('Set env GOATCHAIN_AUTO_APPROVE=1 to skip approval prompts.\n')
+    }
+  }
+
+  const openOutputFlow = async () => {
+    if (!useClack()) {
+      if (!process.stdout.isTTY) {
+        process.stdout.write(
+          [
+            'Output / UX:',
+            '- Enable clack UI (default) or set GOATCHAIN_UI=legacy to disable.',
+            '- Current settings are persisted in .goatchain config.',
+            '',
+          ].join('\n'),
+        )
+        return
+      }
+
+      process.stdout.write(
+        [
+          'Output / UX:',
+          `1) showTools: ${uiPrefs?.showTools ? 'on' : 'off'}`,
+          `2) toolStyle: ${uiPrefs?.toolStyle ?? 'inline'}`,
+          `3) statusLine: ${uiPrefs?.showStatusLine ? 'on' : 'off'}`,
+          `4) doneLine: ${uiPrefs?.showStatus ? 'on' : 'off'}`,
+          `5) emoji: ${uiPrefs?.emoji ? 'on' : 'off'}`,
+          `6) promptContinue: ${uiPrefs?.promptContinue ? 'on' : 'off'}`,
+          `7) autoContinue: ${uiPrefs?.autoContinue ? 'on' : 'off'}`,
+          '',
+        ].join('\n'),
+      )
+
+      const ans = await new Promise(resolve => rl.question('Toggle which? (1-7, empty cancel): ', resolve))
+      const pick = String(ans ?? '').trim()
+      if (!pick)
+        return
+
+      if (pick === '1')
+        uiPrefs.showTools = !uiPrefs.showTools
+      else if (pick === '2') {
+        const val = await new Promise(resolve => rl.question('Tool style [inline/box]: ', resolve))
+        const style = String(val ?? '').trim().toLowerCase()
+        if (style !== 'inline' && style !== 'box')
+          return
+        uiPrefs.toolStyle = style
+      }
+      else if (pick === '3')
+        uiPrefs.showStatusLine = !uiPrefs.showStatusLine
+      else if (pick === '4')
+        uiPrefs.showStatus = !uiPrefs.showStatus
+      else if (pick === '5')
+        uiPrefs.emoji = !uiPrefs.emoji
+      else if (pick === '6')
+        uiPrefs.promptContinue = !uiPrefs.promptContinue
+      else if (pick === '7')
+        uiPrefs.autoContinue = !uiPrefs.autoContinue
+      else
+        return
+
+      await saveAll()
+      process.stdout.write(`${icon('💾')}saved\n`)
+      return
+    }
+
+    const pick = await selectWithClack({
+      message: 'Output / UX',
+      options: [
+        { value: 'showTools', label: label('🛠️', `Show tools: ${uiPrefs?.showTools ? 'on' : 'off'}`) },
+        { value: 'toolStyle', label: label('🎛️', `Tool style: ${uiPrefs?.toolStyle ?? 'inline'}`) },
+        { value: 'statusLine', label: label('…', `Status line: ${uiPrefs?.showStatusLine ? 'on' : 'off'}`) },
+        { value: 'doneLine', label: label('✅', `Done line: ${uiPrefs?.showStatus ? 'on' : 'off'}`) },
+        { value: 'emoji', label: label('🙂', `Emoji: ${uiPrefs?.emoji ? 'on' : 'off'}`) },
+        { value: 'promptContinue', label: label('💬', `Prompt continue: ${uiPrefs?.promptContinue ? 'on' : 'off'}`) },
+        { value: 'autoContinue', label: label('⏭️', `Auto continue: ${uiPrefs?.autoContinue ? 'on' : 'off'}`) },
+      ],
+      initialValue: 0,
+    })
+    if (!pick.ok)
+      return
+
+    if (pick.value === 'showTools')
+      uiPrefs.showTools = !uiPrefs.showTools
+    else if (pick.value === 'statusLine')
+      uiPrefs.showStatusLine = !uiPrefs.showStatusLine
+    else if (pick.value === 'doneLine')
+      uiPrefs.showStatus = !uiPrefs.showStatus
+    else if (pick.value === 'emoji')
+      uiPrefs.emoji = !uiPrefs.emoji
+    else if (pick.value === 'promptContinue')
+      uiPrefs.promptContinue = !uiPrefs.promptContinue
+    else if (pick.value === 'autoContinue')
+      uiPrefs.autoContinue = !uiPrefs.autoContinue
+    else if (pick.value === 'toolStyle') {
+      const style = await selectWithClack({
+        message: 'Tool style',
+        options: [
+          { value: 'inline', label: 'inline (compact)' },
+          { value: 'box', label: 'box (verbose)' },
+        ],
+        initialValue: uiPrefs.toolStyle === 'box' ? 1 : 0,
+      })
+      if (!style.ok)
+        return
+      uiPrefs.toolStyle = String(style.value)
+    }
+
+    await saveAll()
+    process.stdout.write(`${icon('💾')}saved\n`)
+  }
+
+  const openDiagnosticsFlow = async () => {
+    process.stdout.write(`${ansi.bold('Last turn:')}\n`)
+    const stop = lastTurnMeta?.stopReason ? String(lastTurnMeta.stopReason) : ''
+    const modelStop = lastTurnMeta?.modelStopReason ? String(lastTurnMeta.modelStopReason) : ''
+    process.stdout.write(`stopReason: ${stop || '∅'}\n`)
+    process.stdout.write(`modelStopReason: ${modelStop || '∅'}\n`)
+    const tools = Array.isArray(lastTurnMeta?.tools) ? lastTurnMeta.tools : []
+    if (tools.length > 0) {
+      process.stdout.write(`${ansi.bold('tools:')}\n`)
+      for (const t of tools.slice(-12)) {
+        const name = t?.toolName ? String(t.toolName) : 'tool'
+        const a = t?.argsSummary ? String(t.argsSummary) : ''
+        const r = t?.resultSummary ? String(t.resultSummary) : ''
+        process.stdout.write(`- ${name}${a ? ` ${a}` : ''}${r ? ` -> ${r}` : ''}\n`)
+      }
+    }
+    process.stdout.write('\n')
+  }
+
+  async function getWorkspaceFiles() {
+    const now = Date.now()
+    if (workspaceFilesCache && now - workspaceFilesCache.at < 30_000)
+      return workspaceFilesCache.files
+    const files = await listWorkspaceFiles(workspaceCwd(), { maxFiles: 8000 })
+    workspaceFilesCache = { at: now, files }
+    return files
+  }
+
+  async function getWorkspaceImages() {
+    const now = Date.now()
+    if (workspaceImagesCache && now - workspaceImagesCache.at < 30_000)
+      return workspaceImagesCache.files
+    const files = await listWorkspaceFiles(workspaceCwd(), { maxFiles: 8000 })
+    const imgs = files.filter((f) => {
+      const lower = String(f).toLowerCase()
+      return lower.endsWith('.png') || lower.endsWith('.jpg') || lower.endsWith('.jpeg') || lower.endsWith('.webp') || lower.endsWith('.gif')
+    })
+    workspaceImagesCache = { at: now, files: imgs }
+    return imgs
+  }
+
+  async function openFilesFlow() {
+    if (!useClack()) {
+      if (process.stdout.isTTY) {
+        const modeAns = await new Promise(resolve => rl.question('Attach mode [path/summary/full] (default summary): ', resolve))
+        const modeRaw = String(modeAns ?? '').trim().toLowerCase()
+        const mode = modeRaw === 'path' || modeRaw === 'full' ? modeRaw : 'summary'
+        const pathsAns = await new Promise(resolve => rl.question('File paths (space-separated, workspace-relative): ', resolve))
+        const rawPaths = String(pathsAns ?? '').trim()
+        if (!rawPaths)
+          return
+        const toks = rawPaths.split(/\s+/).filter(Boolean)
+        const rels = []
+        for (const tok of toks) {
+          try {
+            const abs = ensureAllowedFile(workspaceCwd(), tok)
+            rels.push(path.relative(workspaceCwd(), abs))
+          }
+          catch (err) {
+            process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+            return
+          }
+        }
+        const markers = rels.map(f => `@file(${mode}):${f}`).join(' ')
+        const applyAns = await new Promise(resolve => rl.question('Apply [i]nsert / [s]end now? (default insert): ', resolve))
+        const apply = String(applyAns ?? '').trim().toLowerCase()
+        if (apply === 's' || apply === 'send') {
+          const msgAns = await new Promise(resolve => rl.question('Message (optional): ', resolve))
+          const line = `${String(msgAns ?? '').trim()} ${markers}`.trim()
+          if (!line)
+            return
+          await runChatTurn(line)
+          return
+        }
+
+        const existing = String(rl.line ?? '').trim()
+        const next = existing ? `${existing} ${markers}` : `${markers} `
+        rl.line = next
+        rl.cursor = rl.line.length
+        rl._refreshLine?.()
+        showInlineHint('Inserted @file markers (send the prompt to attach files).')
+        return
+      }
+
+      process.stdout.write(
+        [
+          'Attach files:',
+          '- Use @file(summary):path/to/file (default summary)',
+          '- Or run @file to pick files (TTY + clack)',
+          '',
+        ].join('\n'),
+      )
+      return
+    }
+
+    /** @type {null | { kind: 'insert', markers: string } | { kind: 'send', line: string }} */
+    let nextAction = null
+
+    await withClack(async () => {
+      const all = await getWorkspaceFiles()
+      if (all.length === 0) {
+        process.stdout.write('[no files found]\n')
+        return
+      }
+
+      const filterRes = await textWithClack({ message: 'Search files (substring)', placeholder: 'e.g. src/agent or cli/repl' })
+      if (!filterRes.ok)
+        return
+      const filter = String(filterRes.value ?? '').trim().toLowerCase()
+
+      const filtered = filter
+        ? all.filter(f => String(f).toLowerCase().includes(filter))
+        : all
+
+      if (filtered.length === 0) {
+        process.stdout.write('[no matches]\n')
+        return
+      }
+
+      const maxOptions = 240
+      const sliced = filtered.slice(0, maxOptions)
+      const picked = await multiselectWithClack({
+        message: `Select files (${sliced.length}${filtered.length > maxOptions ? `/${filtered.length}` : ''})`,
+        options: sliced.map(f => ({ value: f, label: f })),
+        required: true,
+      })
+      if (!picked.ok)
+        return
+
+      const files = Array.isArray(picked.value) ? picked.value.map(String).filter(Boolean) : []
+      if (files.length === 0)
+        return
+
+      const modeRes = await selectWithClack({
+        message: 'Attach mode',
+        options: [
+          { value: 'path', label: 'Paths only' },
+          { value: 'summary', label: 'Summary (head/tail excerpt)' },
+          { value: 'full', label: 'Full (size-limited)' },
+        ],
+        initialValue: 1,
+      })
+      if (!modeRes.ok)
+        return
+
+      const mode = String(modeRes.value)
+      const markers = files.map(f => `@file(${mode}):${f}`).join(' ')
+
+      const apply = await selectWithClack({
+        message: 'Apply',
+        options: [
+          { value: 'insert', label: 'Insert into prompt' },
+          { value: 'send', label: 'Send now' },
+        ],
+        initialValue: 0,
+      })
+      if (!apply.ok)
+        return
+
+      if (apply.value === 'send') {
+        const msg = await textWithClack({ message: 'Message', placeholder: 'Optional message to send with attachments' })
+        if (!msg.ok)
+          return
+        const line = `${String(msg.value ?? '').trim()} ${markers}`.trim()
+        if (!line)
+          return
+        nextAction = { kind: 'send', line }
+        return
+      }
+
+      nextAction = { kind: 'insert', markers }
+    })
+
+    if (!nextAction)
+      return
+
+    if (nextAction.kind === 'send') {
+      await runChatTurn(nextAction.line)
+      return
+    }
+
+    const existing = String(rl.line ?? '').trim()
+    const next = existing ? `${existing} ${nextAction.markers}` : `${nextAction.markers} `
+    rl.line = next
+    rl.cursor = rl.line.length
+    rl._refreshLine?.()
+    showInlineHint('Inserted @file markers (send the prompt to attach files).')
+  }
+
+  async function openWorkspaceFlow() {
+    if (typeof switchWorkspace !== 'function') {
+      process.stdout.write('Workspace switching is not configured (missing switchWorkspace)\n')
+      return
+    }
+
+    if (!useClack()) {
+      const ans = await new Promise(resolve => rl.question(`Workspace path (current: ${workspaceCwd()}): `, resolve))
+      const raw = String(ans ?? '').trim()
+      if (!raw)
+        return
+      const abs = path.resolve(workspaceCwd(), raw)
+      try {
+        await switchWorkspace(abs)
+        workspaceFilesCache = null
+        workspaceImagesCache = null
+        process.stdout.write(`${ansi.green('workspace:')} ${workspaceCwd()}\n`)
+      }
+      catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+      }
+      return
+    }
+
+    await withClack(async () => {
+      const txt = await textWithClack({ message: 'Workspace path', placeholder: workspaceCwd() })
+      if (!txt.ok)
+        return
+      const raw = String(txt.value ?? '').trim()
+      if (!raw)
+        return
+      const abs = path.resolve(workspaceCwd(), raw)
+      const ok = await confirmWithClack({ message: `Switch to ${abs}?`, initialValue: true })
+      if (!ok.ok || !ok.value)
+        return
+      try {
+        await switchWorkspace(abs)
+        workspaceFilesCache = null
+        workspaceImagesCache = null
+        process.stdout.write(`${ansi.green('workspace:')} ${workspaceCwd()}\n`)
+      }
+      catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+      }
+    })
+  }
+
+  function mimeFromPath(p) {
+    const lower = String(p ?? '').toLowerCase()
+    if (lower.endsWith('.png'))
+      return 'image/png'
+    if (lower.endsWith('.jpg') || lower.endsWith('.jpeg'))
+      return 'image/jpeg'
+    if (lower.endsWith('.webp'))
+      return 'image/webp'
+    if (lower.endsWith('.gif'))
+      return 'image/gif'
+    return 'application/octet-stream'
+  }
+
+  async function expandImageMentions(inputText) {
+    const s = String(inputText ?? '')
+    /** @type {Array<{ raw: string, filePath: string }>} */
+    const mentions = []
+    const re = /@(image|img):([^\s]+)/g
+    let m
+    while ((m = re.exec(s)) != null) {
+      mentions.push({ raw: m[0], filePath: m[2] })
+    }
+    if (mentions.length === 0)
+      return { cleanedText: s.trim(), images: [], blocks: null }
+
+    const uniq = new Map()
+    for (const mm of mentions) {
+      const key = mm.filePath
+      if (!uniq.has(key))
+        uniq.set(key, mm)
+    }
+
+    const images = []
+    for (const mm of uniq.values()) {
+      const abs = ensureAllowedFile(workspaceCwd(), mm.filePath)
+      // eslint-disable-next-line no-await-in-loop
+      const buf = await readFile(abs)
+      const max = 4 * 1024 * 1024
+      if (buf.byteLength > max)
+        throw new Error(`Image too large (${Math.round(buf.byteLength / 1024)} KB): ${mm.filePath}`)
+      const b64 = buf.toString('base64')
+      const mime = mimeFromPath(mm.filePath)
+      const url = `data:${mime};base64,${b64}`
+      images.push({ relPath: path.relative(workspaceCwd(), abs), absPath: abs, mime, bytes: buf.byteLength, url })
+    }
+
+    let cleaned = s
+    for (const mm of mentions) {
+      cleaned = cleaned.replace(mm.raw, '').replace(/\s{2,}/g, ' ')
+    }
+    cleaned = cleaned.trim()
+
+    const blocks = []
+    if (cleaned)
+      blocks.push({ type: 'text', text: cleaned })
+    for (const img of images) {
+      blocks.push({ type: 'image', source: { data: img.url } })
+    }
+
+    return { cleanedText: cleaned, images, blocks }
+  }
+
+  async function openAttachmentsFlow() {
+    if (clipboardAttachInFlight && pendingImages.length === 0) {
+      showInlineHint('Attaching image from clipboard… (try again in a moment)')
+      return
+    }
+    if (pendingImages.length === 0) {
+      const recent = lastPastedImageName && Date.now() - lastPastedImageName.at < 60_000 ? lastPastedImageName : null
+      if (!useClack() || !process.stdout.isTTY) {
+        if (recent)
+          showInlineHint(`No pending attachments. Last pasted: ${recent.name} (use @image, or paste/drag a full path)`)
+        else
+          showInlineHint('No pending attachments.')
+        return
+      }
+
+      await withClack(async () => {
+        const action = await selectWithClack({
+          message: recent ? `Attachments (last pasted: ${recent.name})` : 'Attachments',
+          options: [
+            { value: 'images', label: 'Attach image(s) from workspace…' },
+            { value: 'path', label: 'Attach image by path…' },
+            { value: 'cancel', label: 'Cancel' },
+          ],
+          initialValue: 0,
+        })
+        if (!action.ok || action.value === 'cancel')
+          return
+        if (action.value === 'images') {
+          await openImagesFlow()
+          return
+        }
+        if (action.value === 'path') {
+          const txt = await textWithClack({
+            message: 'Image path',
+            placeholder: '/Users/you/Desktop/image.png (you can drag & drop here)',
+          })
+          if (!txt.ok)
+            return
+          const raw = String(txt.value ?? '').trim()
+          if (!raw)
+            return
+          const abs = raw.startsWith('/') ? raw : ensureAllowedFile(workspaceCwd(), raw)
+          const file = await readImageFileAsDataUrl(abs)
+          if (!file?.dataUrl) {
+            showInlineHint('Not a supported image path.')
+            return
+          }
+          pendingImages.push({
+            name: path.basename(abs),
+            mime: String(file.mime),
+            bytes: Buffer.isBuffer(file.buf) ? file.buf.byteLength : 0,
+            dataUrl: String(file.dataUrl),
+            source: raw.startsWith('/') ? 'paste' : 'path',
+          })
+          setPromptForMode()
+          refreshPrompt()
+          showInlineHint(`Attached image: ${path.basename(abs)}`)
+        }
+      })
+      return
+    }
+
+    if (!useClack()) {
+      const q = `Remove which attachments? (e.g. 1,3) or 'a' to clear all: `
+      const ans = await new Promise(resolve => rl.question(q, resolve))
+      const raw = String(ans ?? '').trim().toLowerCase()
+      if (!raw)
+        return
+      if (raw === 'a' || raw === 'all' || raw === 'clear') {
+        pendingImages = []
+        itermPasteBuffer = ''
+        setPromptForMode()
+        refreshPrompt()
+        showInlineHint('Cleared pending attachments.')
+        return
+      }
+      const nums = raw.split(/[, ]+/).map(x => Number.parseInt(x, 10)).filter(n => Number.isFinite(n))
+      const idxs = new Set(nums.map(n => n - 1).filter(i => i >= 0 && i < pendingImages.length))
+      if (idxs.size === 0)
+        return
+      pendingImages = pendingImages.filter((_, i) => !idxs.has(i))
+      setPromptForMode()
+      refreshPrompt()
+      return
+    }
+
+    await withClack(async () => {
+      const opts = pendingImages.map((img, idx) => {
+        const size = img.bytes ? ` (${humanBytes(img.bytes)})` : ''
+        return { value: String(idx), label: `${img.name}${size}` }
+      })
+      const pick = await multiselectWithClack({
+        message: 'Select attachments to remove',
+        options: opts,
+        required: false,
+      })
+      if (!pick.ok)
+        return
+      const values = Array.isArray(pick.value) ? pick.value.map(String) : []
+      const idxs = new Set(values.map(v => Number.parseInt(v, 10)).filter(n => Number.isFinite(n)))
+      if (idxs.size === 0)
+        return
+      pendingImages = pendingImages.filter((_, i) => !idxs.has(i))
+      setPromptForMode()
+      refreshPrompt()
+    })
+  }
+
+  async function openImagesFlow() {
+    if (!useClack()) {
+      if (process.stdout.isTTY) {
+        const ans = await new Promise(resolve => rl.question('Image paths (space-separated; absolute or workspace-relative): ', resolve))
+        const raw = String(ans ?? '').trim()
+        if (!raw)
+          return
+        const toks = raw.split(/\s+/).filter(Boolean)
+        const toAdd = []
+        for (const tok of toks) {
+          try {
+            const abs = tok.startsWith('/') ? tok : ensureAllowedFile(workspaceCwd(), tok)
+            // eslint-disable-next-line no-await-in-loop
+            const file = await readImageFileAsDataUrl(abs)
+            if (!file?.dataUrl) {
+              showInlineHint('Not a supported image path.')
+              return
+            }
+            toAdd.push({
+              name: path.basename(abs),
+              mime: String(file.mime),
+              bytes: Buffer.isBuffer(file.buf) ? file.buf.byteLength : 0,
+              dataUrl: String(file.dataUrl),
+              source: tok.startsWith('/') ? 'paste' : 'path',
+            })
+          }
+          catch (err) {
+            process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+            return
+          }
+        }
+        if (toAdd.length === 0)
+          return
+        pendingImages.push(...toAdd)
+        setPromptForMode()
+        refreshPrompt()
+        showInlineHint(`Attached ${toAdd.length} image(s).`)
+
+        const sendAns = await new Promise(resolve => rl.question('Send now? [y/N] ', resolve))
+        const ok = String(sendAns ?? '').trim().toLowerCase()
+        if (ok === 'y' || ok === 'yes') {
+          const msgAns = await new Promise(resolve => rl.question('Message (optional): ', resolve))
+          await runChatTurn(String(msgAns ?? '').trim())
+        }
+        return
+      }
+
+      process.stdout.write(
+        [
+          'Attach images:',
+          '- Paste from iTerm2 to attach (cmd+v).',
+          '- Or run @image to pick images (TTY + clack).',
+          '- Ctrl+O manages pending attachments.',
+          '',
+        ].join('\n'),
+      )
+      return
+    }
+
+    /** @type {null | { kind: 'attach' } | { kind: 'send', line: string }} */
+    let nextAction = null
+    /** @type {null | Array<{ name: string, mime: string, bytes: number, dataUrl: string, source: 'paste'|'path' }>} */
+    let toAdd = null
+
+    await withClack(async () => {
+      const all = await getWorkspaceImages()
+      if (all.length === 0) {
+        process.stdout.write('[no images found]\n')
+        return
+      }
+
+      const filterRes = await textWithClack({ message: 'Search images (substring)', placeholder: 'e.g. assets/logo.png' })
+      if (!filterRes.ok)
+        return
+      const filter = String(filterRes.value ?? '').trim().toLowerCase()
+
+      const filtered = filter
+        ? all.filter(f => String(f).toLowerCase().includes(filter))
+        : all
+
+      if (filtered.length === 0) {
+        process.stdout.write('[no matches]\n')
+        return
+      }
+
+      const maxOptions = 160
+      const sliced = filtered.slice(0, maxOptions)
+      const picked = await multiselectWithClack({
+        message: `Select images (${sliced.length}${filtered.length > maxOptions ? `/${filtered.length}` : ''})`,
+        options: sliced.map(f => ({ value: f, label: f })),
+        required: true,
+      })
+      if (!picked.ok)
+        return
+
+      const imgs = Array.isArray(picked.value) ? picked.value.map(String).filter(Boolean) : []
+      if (imgs.length === 0)
+        return
+
+      const loaded = []
+      const max = 4 * 1024 * 1024
+      for (const rel of imgs) {
+        const abs = ensureAllowedFile(workspaceCwd(), rel)
+        // eslint-disable-next-line no-await-in-loop
+        const buf = await readFile(abs)
+        if (buf.byteLength > max) {
+          process.stdout.write(`Image too large: ${rel} (${humanBytes(buf.byteLength)})\n`)
+          return
+        }
+        const b64 = buf.toString('base64')
+        const mime = mimeFromPath(rel)
+        const dataUrl = `data:${mime};base64,${b64}`
+        loaded.push({ name: path.relative(workspaceCwd(), abs), mime, bytes: buf.byteLength, dataUrl, source: 'path' })
+      }
+      toAdd = loaded
+
+      const apply = await selectWithClack({
+        message: 'Apply',
+        options: [
+          { value: 'attach', label: 'Attach (keep editing)' },
+          { value: 'send', label: 'Attach and send now' },
+        ],
+        initialValue: 0,
+      })
+      if (!apply.ok)
+        return
+
+      if (apply.value === 'send') {
+        const msg = await textWithClack({ message: 'Message', placeholder: 'Optional message to send with images' })
+        if (!msg.ok)
+          return
+        nextAction = { kind: 'send', line: String(msg.value ?? '').trim() }
+        return
+      }
+
+      nextAction = { kind: 'attach' }
+    })
+
+    if (!nextAction)
+      return
+
+    if (Array.isArray(toAdd) && toAdd.length > 0) {
+      pendingImages.push(...toAdd)
+      setPromptForMode()
+      refreshPrompt()
+    }
+
+    if (nextAction.kind === 'send') {
+      await runChatTurn(nextAction.line)
+    }
+  }
+
+  async function openCommandPalette() {
+    if (commandPaletteInFlight)
+      return
+    commandPaletteInFlight = true
+    try {
+    if (!useClack()) {
+      buildProgram(version).outputHelp()
+      process.stdout.write(getReplHelpText())
+      return
+    }
+    await withClack(async () => {
+      const res = await selectWithClack({
+        message: 'Command palette',
+        options: [
+          { value: 'continue', label: label('▶️', 'Continue (implement now)') },
+          { value: 'edit', label: label('📝', 'Compose message in editor…') },
+          { value: 'multiline', label: label('✍️', 'Multiline input…') },
+          { value: 'sessions', label: label('🗂️', 'Sessions…') },
+          { value: 'workspace', label: label('📁', 'Switch workspace…') },
+          { value: 'files', label: label('📎', 'Attach file(s)…') },
+          { value: 'images', label: label('🖼️', 'Attach image(s)…') },
+          { value: 'model', label: label('🤖', 'Switch model…') },
+          { value: 'settings', label: label('⚙️', 'Settings…') },
+          { value: 'output', label: label('🎛️', 'Output / UX…') },
+          { value: 'diag', label: label('🧾', 'Diagnostics') },
+        ],
+        initialValue: 0,
+      })
+      if (!res.ok)
+        return
+
+      if (res.value === 'continue') {
+        const continuePrompt = '继续。不要只说计划：请立刻开始实现，使用 Write/Edit 创建或修改文件。'
+        await runChatTurn(continuePrompt)
+        return
+      }
+      if (res.value === 'edit') {
+        await openEditorFlow()
+        return
+      }
+      if (res.value === 'multiline') {
+        multiline = { lines: [] }
+        setPromptForMode()
+        showInlineHint('Multiline mode: type .send to send, .cancel to cancel.')
+        return
+      }
+      if (res.value === 'sessions') {
+        await handleSlash('/sessions')
+        return
+      }
+      if (res.value === 'workspace')
+        return openWorkspaceFlow()
+      if (res.value === 'files')
+        return openFilesFlow()
+      if (res.value === 'images')
+        return openImagesFlow()
+      if (res.value === 'model')
+        return openModelFlow()
+      if (res.value === 'settings')
+        return openSettingsFlow()
+      if (res.value === 'output')
+        return openOutputFlow()
+      if (res.value === 'diag')
+        return openDiagnosticsFlow()
+    })
+    }
+    finally {
+      commandPaletteInFlight = false
+    }
+  }
+
+  const handleAt = async (raw) => {
+    const atRaw = String(raw ?? '').trim()
+    if (!atRaw.startsWith('@'))
+      return false
+
+    const direct = atRaw.toLowerCase()
+    if (direct === '@continue') {
+      const continuePrompt = '继续。不要只说计划：请立刻开始实现，使用 Write/Edit 创建或修改文件。'
+      await runChatTurn(continuePrompt)
+      return true
+    }
+
+    if (direct === '@clear') {
+      pendingImages = []
+      itermPasteBuffer = ''
+      clipboardAttachInFlight = null
+      setPromptForMode()
+      refreshPrompt()
+      showInlineHint('Cleared pending attachments.')
+      return true
+    }
+
+    if (direct === '@workspace') {
+      await openWorkspaceFlow()
+      return true
+    }
+
+    if (direct === '@file') {
+      await openFilesFlow()
+      return true
+    }
+
+    if (direct === '@image' || direct === '@img') {
+      await openImagesFlow()
+      return true
+    }
+
+    if (!useClack()) {
+      process.stdout.write(
+        [
+          'Mentions:',
+          '- @continue (continue and implement now)',
+          '- @clear (clear pending attachments)',
+          '- @workspace (switch workspace root)',
+          '- @file (attach file(s) to the next prompt)',
+          '- @image/@img (attach image(s) to the next prompt)',
+          '- Use /help, /sessions, /model, /set, /base-url, /api-key',
+          '',
+        ].join('\n'),
+      )
+      return true
+    }
+
+    await withClack(async () => {
+      if (direct === '@sessions') {
+        await handleSlash('/sessions')
+        return
+      }
+      if (direct === '@model')
+        return openModelFlow()
+      if (direct === '@settings')
+        return openSettingsFlow()
+
+      const action = await selectWithClack({
+        message: 'Quick actions',
+        options: [
+          { value: 'continue', label: label('▶️', 'Continue (implement now)') },
+          { value: 'edit', label: label('📝', 'Compose message in editor…') },
+          { value: 'multiline', label: label('✍️', 'Multiline input…') },
+          { value: 'clear', label: label('🧹', 'Clear pending attachments') },
+          { value: 'sessions', label: label('🗂️', 'Sessions…') },
+          { value: 'workspace', label: label('📁', 'Switch workspace…') },
+          { value: 'files', label: label('📎', 'Attach file(s)…') },
+          { value: 'images', label: label('🖼️', 'Attach image(s)…') },
+          { value: 'model', label: label('🤖', 'Switch model…') },
+          { value: 'settings', label: label('⚙️', 'Settings…') },
+          { value: 'output', label: label('🎛️', 'Output / UX…') },
+        ],
+        initialValue: 0,
+      })
+      if (!action.ok)
+        return
+
+      if (action.value === 'continue') {
+        const continuePrompt = '继续。不要只说计划：请立刻开始实现，使用 Write/Edit 创建或修改文件。'
+        await runChatTurn(continuePrompt)
+        return
+      }
+      if (action.value === 'edit') {
+        await openEditorFlow()
+        return
+      }
+      if (action.value === 'multiline') {
+        multiline = { lines: [] }
+        setPromptForMode()
+        showInlineHint('Multiline mode: type .send to send, .cancel to cancel.')
+        return
+      }
+      if (action.value === 'clear') {
+        pendingImages = []
+        itermPasteBuffer = ''
+        setPromptForMode()
+        refreshPrompt()
+        showInlineHint('Cleared pending attachments.')
+        return
+      }
+      if (action.value === 'sessions')
+        return handleSlash('/sessions')
+      if (action.value === 'workspace')
+        return openWorkspaceFlow()
+      if (action.value === 'files')
+        return openFilesFlow()
+      if (action.value === 'images')
+        return openImagesFlow()
+      if (action.value === 'model')
+        return openModelFlow()
+      if (action.value === 'settings')
+        return openSettingsFlow()
+      if (action.value === 'output')
+        return openOutputFlow()
+    })
+
+    return true
+  }
+
+  const handleLine = async (line) => {
+    if (multiline) {
+      if (busy) {
+        process.stdout.write(`${icon('⏳')}busy (Ctrl+C to cancel)\n`)
+        rl.prompt()
+        return
+      }
+      const raw = String(line ?? '')
+      const trimmed = raw.trim()
+      if (trimmed === '.cancel') {
+        multiline = null
+        setPromptForMode()
+        showInlineHint('Canceled multiline input.')
+        rl.prompt()
+        return
+      }
+      if (trimmed === '.send') {
+        const text = multiline.lines.join('\n').replace(/\s+$/, '')
+        multiline = null
+        setPromptForMode()
+        if (!text.trim()) {
+          showInlineHint('Canceled (empty message).')
+          rl.prompt()
+          return
+        }
+        await runChatTurn(text)
+        setPromptForMode()
+        rl.prompt()
+        return
+      }
+      multiline.lines.push(raw)
+      rl.prompt()
+      return
+    }
+
+    const trimmed = line.trim()
+    if (!trimmed) {
+      if (uiMode === 'select_session') {
+        leaveSessionPickerUi()
+        uiMode = 'normal'
+        sessionPicker = null
+        setPromptForMode()
+      }
+      rl.prompt()
+      return
+    }
+
+    if (busy) {
+      process.stdout.write(`${icon('⏳')}busy (Ctrl+C to cancel)\n`)
+      rl.prompt()
+      return
+    }
+
+    // If the user is typing a mention (@...), don't suggest slash commands.
+    if (uiMode === 'normal' && !trimmed.startsWith('/') && !trimmed.startsWith('@') && !/\s/.test(trimmed)) {
+      const resolved = resolveCommand(trimmed)
+      if (resolved.kind === 'exact') {
+        process.stdout.write(`${icon('💡')}Tip: commands start with '/'. Did you mean /${resolved.cmd}?\n`)
+        rl.prompt()
+        return
+      }
+      if (resolved.kind === 'prefix') {
+        process.stdout.write(`${icon('💡')}Tip: commands start with '/'. Did you mean /${resolved.cmd}?\n`)
+        rl.prompt()
+        return
+      }
+      if (resolved.kind === 'ambiguous') {
+        process.stdout.write(`${icon('💡')}Tip: commands start with '/'. Possible matches: ${resolved.matches.map(m => `/${m}`).join(', ')}\n`)
+        rl.prompt()
+        return
+      }
+      if (resolved.kind === 'fuzzy' || resolved.kind === 'contains') {
+        process.stdout.write(`${icon('💡')}Tip: commands start with '/'. Did you mean ${resolved.matches.map(m => `/${m}`).join(', ')}?\n`)
+        rl.prompt()
+        return
+      }
+    }
+
+    if (trimmed.startsWith('/')) {
+      if (uiMode === 'select_session') {
+        leaveSessionPickerUi()
+        uiMode = 'normal'
+        sessionPicker = null
+      }
+      await handleSlash(trimmed)
+      setPromptForMode()
+      rl.prompt()
+      return
+    }
+
+    if (uiMode === 'normal' && trimmed.startsWith('@')) {
+      const lower = trimmed.toLowerCase()
+      const handled = !/\s/.test(trimmed) && KNOWN_MENTIONS.includes(lower)
+        ? await handleAt(lower)
+        : false
+      if (handled) {
+        setPromptForMode()
+        rl.prompt()
+        return
+      }
+    }
+
+    if (uiMode === 'select_session' && sessionPicker) {
+      const sessions = sessionPicker.sessions
+      const filtered = getFilteredSessions(sessions, sessionPicker.filter)
+
+      const maybeIndex = Number.parseInt(trimmed, 10)
+      if (Number.isFinite(maybeIndex) && maybeIndex >= 1 && maybeIndex <= filtered.length) {
+        leaveSessionPickerUi()
+        await handleSlash(`/use ${filtered[maybeIndex - 1].sessionId}`)
+        rl.prompt()
+        return
+      }
+
+      sessionPicker.filter = trimmed
+      renderSessionPicker({
+        sessions,
+        currentSessionId: options.session.sessionId,
+        filter: sessionPicker.filter,
+        alt: sessionPickerAlt,
+        emoji: uiPrefs?.emoji,
+      })
+      rl.prompt()
+      return
+    }
+
+    await runChatTurn(trimmed)
+    rl.prompt()
+  }
+
+  rl.on('line', (line) => {
+    if (exiting)
+      return
+    lineQueue = lineQueue.then(() => handleLine(line)).catch((err) => {
+      process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`)
+    })
+  })
+}