@leviyuan/lodestar 0.2.4 → 0.2.6

package/README.md

@@ -50,9 +50,9 @@ AI 不是帮手,是倍率。它放大的不是体力,是你——你的直觉、
 | --- | --- |
 | `hi` | 未运行时启动;运行中弹一张**状态卡片** |
 | `stop` | 软打断当前 turn + 清空 type-ahead 排队;子进程保活,刚排队中的消息会被打 `CrossMark` 反应表示取消 |
-| `kill` | 优雅关闭 Claude 进程;记住 `sessionId`,下次 `restart` 还能 resume |
-| `restart` | 用上一次的 `sessionId` 重启会话(保留上下文) |
-| `clear` | 杀掉进程并启动一个全新 session(等价于 Claude Code 的 `/clear`) |
+| `kill` | 优雅关闭 Claude 进程;`sessionId` 仍记在磁盘,下次 `restart` 还能 resume |
+| `restart` | 用上一次的 `sessionId` 重启会话(保留上下文);无进程时也能用,等于"恢复上一会话" |
+| `clear` | 杀掉当前进程并启动一个全新 session(等价于 Claude Code 的 `/clear`);**无进程时无效** |
 
 > 这五个词被全局保留:在群里发 "hi" 当问候也会触发控制台卡片,不会到 Claude 那边。换来的是手机上单手打字的便利。
 

package/daemon.ts

@@ -11,13 +11,13 @@
  */
 
 import * as lark from '@larksuiteoapi/node-sdk'
-import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs'
+import { chmodSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs'
 import { dirname } from 'node:path'
 import { Session } from './src/session'
 import * as feishu from './src/feishu'
 import { config } from './src/config'
 import { log } from './src/log'
-import { PID_FILE } from './src/paths'
+import { DEBUG_CTX_FILE, DEBUG_SOCK_FILE, PID_FILE } from './src/paths'
 
 // ── PID guard ───────────────────────────────────────────────────────────
 try {
@@ -44,6 +44,7 @@ const cleanup = () => {
     if (alive.length > 0) log(`alive marker: [${alive.join(', ')}]`)
   } catch (e) { log(`alive marker write failed: ${e}`) }
   try { unlinkSync(PID_FILE) } catch {}
+  try { unlinkSync(DEBUG_SOCK_FILE) } catch {}
 }
 process.on('exit', cleanup)
 process.on('SIGTERM', () => { log('SIGTERM'); cleanup(); process.exit(0) })
@@ -126,6 +127,29 @@ async function handleMessage(data: any): Promise<void> {
   }
 
   const chatId = message.chat_id as string
+
+  // `[DEBUG]` prefix — seed the inject context with the real chat/sender
+  // captured from a live WS event, then strip the prefix and continue as
+  // normal. The injector script (scripts/test-inject.ts) reads this
+  // context to replay arbitrary messages without the user touching Feishu.
+  let contentObjForDebug: any = {}
+  try { contentObjForDebug = JSON.parse(message.content ?? '{}') } catch {}
+  const debugTextRaw = (message.message_type === 'text' ? contentObjForDebug.text ?? '' : '')
+  if (typeof debugTextRaw === 'string' && debugTextRaw.startsWith('[DEBUG]')) {
+    try {
+      writeFileSync(DEBUG_CTX_FILE, JSON.stringify({
+        chat_id: chatId,
+        sender_open_id: userOpenId,
+        seeded_at: new Date().toISOString(),
+        seeded_msg_id: msgId ?? '',
+      }, null, 2))
+      log(`debug: seeded inject context chat=${chatId.slice(0, 8)}… sender=${userOpenId.slice(0, 8)}…`)
+    } catch (e) { log(`debug: seed context failed: ${e}`) }
+    const stripped = debugTextRaw.slice('[DEBUG]'.length)
+    contentObjForDebug.text = stripped
+    message.content = JSON.stringify(contentObjForDebug)
+  }
+
   let groupName = feishu.chatNameCache.get(chatId)
   if (!groupName) {
     await feishu.refreshChatList()
@@ -192,9 +216,6 @@ async function handleCardAction(data: any): Promise<any> {
     case 'permission':
       await session.onPermissionDecision(value.request_id, value.decision, userId)
       return { toast: { type: value.decision === 'deny' ? 'error' : 'success', content: '已处理' } }
-    case 'console':
-      await session.onConsoleAction(value.action)
-      return { toast: { type: 'info', content: value.action } }
     case 'menu':
       await session.onUserMessage(`(menu choice ${value.choice + 1})`)
       return { toast: { type: 'success', content: 'OK' } }
@@ -221,6 +242,55 @@ function fmt(m: any[]): string {
   return m.map(x => typeof x === 'string' ? x : JSON.stringify(x)).join(' ')
 }
 
+// ── Debug message injection ─────────────────────────────────────────────
+// Listens on a unix socket so scripts/test-inject.ts can replay messages
+// through the same `handleMessage` path that real WS events take. Seeded
+// by a one-time `[DEBUG]<anything>` from the real Feishu user; from then
+// on the injector reuses that chat_id + sender_open_id.
+function startDebugSocket(): void {
+  try { if (existsSync(DEBUG_SOCK_FILE)) unlinkSync(DEBUG_SOCK_FILE) } catch {}
+  try {
+    Bun.serve({
+      unix: DEBUG_SOCK_FILE,
+      fetch: async (req: Request) => {
+        if (req.method !== 'POST') return new Response('use POST', { status: 405 })
+        let body: any = {}
+        try { body = await req.json() } catch { return new Response('bad json', { status: 400 }) }
+        if (!existsSync(DEBUG_CTX_FILE)) {
+          return new Response('no debug context yet — send `[DEBUG]hi` from Feishu first', { status: 412 })
+        }
+        let ctx: any = {}
+        try { ctx = JSON.parse(readFileSync(DEBUG_CTX_FILE, 'utf8')) } catch (e) {
+          return new Response(`ctx read failed: ${e}`, { status: 500 })
+        }
+        const text: string = String(body.text ?? '')
+        if (!text) return new Response('text required', { status: 400 })
+        const fakeMsgId = `om_DEBUG_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`
+        const payload = {
+          sender: { sender_id: { open_id: ctx.sender_open_id } },
+          message: {
+            message_id: fakeMsgId,
+            chat_id: ctx.chat_id,
+            message_type: 'text',
+            content: JSON.stringify({ text }),
+            create_time: String(Date.now()),
+          },
+        }
+        log(`debug: inject text=${JSON.stringify(text).slice(0, 80)} fake_id=${fakeMsgId}`)
+        // Don't await — match real WS dispatcher behavior (fire-and-forget per event).
+        handleMessage(payload).catch(e => log(`debug: handleMessage rejected: ${e}`))
+        return new Response(JSON.stringify({ ok: true, fake_msg_id: fakeMsgId }), {
+          headers: { 'content-type': 'application/json' },
+        })
+      },
+    })
+    try { chmodSync(DEBUG_SOCK_FILE, 0o600) } catch {}
+    log(`debug: inject socket listening at ${DEBUG_SOCK_FILE}`)
+  } catch (e) {
+    log(`debug: socket bind failed: ${e}`)
+  }
+}
+
 async function boot(): Promise<void> {
   log(`lodestar-daemon: pid ${process.pid} starting`)
   feishu.loadSessionChatMap()
@@ -272,6 +342,8 @@ async function boot(): Promise<void> {
   ws.start({ eventDispatcher: dispatcher })
   log(`lodestar-daemon: WS started, watching ${feishu.chatNameCache.size} groups`)
 
+  startDebugSocket()
+
   // Auto-revive sessions that were running when we last went down.
   // Runs AFTER the WS is up so any 🔁 revive message lands in the
   // right chat instead of disappearing into the void.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviyuan/lodestar",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/src/cardkit.ts

@@ -73,11 +73,64 @@ async function call(method: string, path: string, body?: object): Promise<any> {
   })
   const json = await res.json() as any
   if (json?.code && json.code !== 0) {
-    throw new Error(`cardkit ${method} ${path}: code=${json.code} msg=${json.msg}`)
+    const e = new Error(`cardkit ${method} ${path}: code=${json.code} msg=${json.msg}`) as Error & { code: number }
+    e.code = json.code
+    throw e
   }
   return json?.data
 }
 
+function isStreamingClosed(e: unknown): boolean {
+  return typeof e === 'object' && e !== null && (e as any).code === 300309
+}
+
+/** Reopen streaming_mode on a card that Feishu auto-closed after its
+ * 10-minute streaming TTL (no keepalive, no idle reset — the timer
+ * starts when streaming is opened and fires regardless of activity).
+ * Called from inside the per-card queue's catch path, so it allocates
+ * its own sequence and runs inline without re-enqueueing. */
+async function reopenStreaming(cardId: string): Promise<void> {
+  const seq = nextSeq(cardId)
+  await call('PATCH', `/cards/${cardId}/settings`, {
+    settings: JSON.stringify({ config: { streaming_mode: true } }),
+    sequence: seq,
+  })
+}
+
+/** Run `op` inside the per-card queue. If it fails with code=300309
+ * (Feishu auto-closed streaming after the 10-minute TTL), reopen
+ * streaming inline and retry `op` exactly once. Anything else — non-
+ * 300309 failure, reopen failure, retry failure — is logged and
+ * swallowed, matching the fire-and-forget contract every cardkit op
+ * already has at the call sites. */
+async function withReopenOnStreamingClosed(
+  cardId: string,
+  label: string,
+  op: () => Promise<void>,
+): Promise<void> {
+  try {
+    await op()
+    return
+  } catch (e) {
+    if (!isStreamingClosed(e)) {
+      log(`cardkit ${label} ${cardId}: ${e}`)
+      return
+    }
+    log(`cardkit ${label} ${cardId}: streaming closed (300309) — reopening`)
+  }
+  try {
+    await reopenStreaming(cardId)
+  } catch (re) {
+    log(`cardkit STREAMING_REOPEN_FAILED ${cardId}: ${re}`)
+    return
+  }
+  try {
+    await op()
+  } catch (e2) {
+    log(`cardkit ${label} ${cardId} retry-after-reopen: ${e2}`)
+  }
+}
+
 /** Convert a sent interactive message into a card entity. */
 export async function convertMessageToCard(messageId: string): Promise<string> {
   const data = await call('POST', '/cards/id_convert', { message_id: messageId })
@@ -101,17 +154,17 @@ export async function createCardEntity(card: object): Promise<string> {
 export function streamText(cardId: string, elementId: string, content: string): Promise<void> {
   if (!content || !content.trim()) return Promise.resolve()
   const s = state(cardId)
-  const seq = nextSeq(cardId)
-  s.queue = s.queue.then(async () => {
-    try {
+  s.queue = s.queue.then(() => withReopenOnStreamingClosed(
+    cardId,
+    `streamText ${elementId}`,
+    async () => {
+      const seq = nextSeq(cardId)
       await call('PUT', `/cards/${cardId}/elements/${elementId}/content`, {
         content, sequence: seq,
       })
       s.lastSent.set(elementId, content)
-    } catch (e) {
-      log(`cardkit streamText ${cardId}/${elementId}: ${e}`)
-    }
-  })
+    },
+  ))
   return s.queue
 }
 
@@ -155,46 +208,52 @@ export function addElement(
   opts: { type?: 'append' | 'insert_before' | 'insert_after'; targetElementId?: string } = {},
 ): Promise<void> {
   const s = state(cardId)
-  const seq = nextSeq(cardId)
-  s.queue = s.queue.then(async () => {
-    try {
+  s.queue = s.queue.then(() => withReopenOnStreamingClosed(
+    cardId,
+    `addElement`,
+    async () => {
+      const seq = nextSeq(cardId)
       await call('POST', `/cards/${cardId}/elements`, {
         type: opts.type ?? 'append',
         ...(opts.targetElementId ? { target_element_id: opts.targetElementId } : {}),
         elements: JSON.stringify([element]),
         sequence: seq,
       })
-    } catch (e) { log(`cardkit addElement ${cardId}: ${e}`) }
-  })
+    },
+  ))
   return s.queue
 }
 
 /** Replace an entire element (used to swap a tool placeholder with its result). */
 export function replaceElement(cardId: string, elementId: string, element: object): Promise<void> {
   const s = state(cardId)
-  const seq = nextSeq(cardId)
-  s.queue = s.queue.then(async () => {
-    try {
+  s.queue = s.queue.then(() => withReopenOnStreamingClosed(
+    cardId,
+    `replaceElement ${elementId}`,
+    async () => {
+      const seq = nextSeq(cardId)
       await call('PUT', `/cards/${cardId}/elements/${elementId}`, {
         element: JSON.stringify(element),
         sequence: seq,
       })
-    } catch (e) { log(`cardkit replaceElement ${cardId}/${elementId}: ${e}`) }
-  })
+    },
+  ))
   return s.queue
 }
 
 /** Delete an element by id. */
 export function deleteElement(cardId: string, elementId: string): Promise<void> {
   const s = state(cardId)
-  const seq = nextSeq(cardId)
-  s.queue = s.queue.then(async () => {
-    try {
+  s.queue = s.queue.then(() => withReopenOnStreamingClosed(
+    cardId,
+    `deleteElement ${elementId}`,
+    async () => {
+      const seq = nextSeq(cardId)
       await call('DELETE', `/cards/${cardId}/elements/${elementId}`, {
         sequence: seq,
       })
-    } catch (e) { log(`cardkit deleteElement ${cardId}/${elementId}: ${e}`) }
-  })
+    },
+  ))
   return s.queue
 }
 
@@ -235,12 +294,22 @@ export function cancelSummary(cardId: string): void {
   summaryStates.delete(cardId)
 }
 
-/** Patch settings — used to flip streaming_mode off when a turn finishes. */
+/** Patch settings — used to flip streaming_mode off when a turn finishes.
+ *
+ * `nextSeq` is called inside the queued task (not at enqueue time) to
+ * match streamText/addElement/replaceElement/deleteElement above. Mixing
+ * call-time and execution-time seq allocation interleaves badly: a
+ * patchSettings enqueued right after a replaceElement would grab the
+ * smaller seq number, but the replaceElement's then-block would grab
+ * the larger one when it ran first, so the patchSettings PATCH lands
+ * with a stale seq and Feishu rejects 300317 "sequence number compare
+ * failed". Keeping all writes on execution-time allocation makes the
+ * seq order match the queue order. */
 export function patchSettings(cardId: string, settings: object): Promise<void> {
   const s = state(cardId)
-  const seq = nextSeq(cardId)
   s.queue = s.queue.then(async () => {
     try {
+      const seq = nextSeq(cardId)
       await call('PATCH', `/cards/${cardId}/settings`, {
         settings: JSON.stringify(settings),
         sequence: seq,

package/src/cards.ts

@@ -74,7 +74,7 @@ export function summarizeToolInput(name: string, input: any): string {
     return truncate(summarizeTaskWorkflow(name, input), 80)
   }
   switch (name) {
-    case 'Bash':       return truncate(String(input.command ?? ''), 80)
+    case 'Bash':       return truncate(String(input.description ?? input.command ?? ''), 80)
     case 'Read':
     case 'Write':
     case 'Edit':
@@ -181,7 +181,7 @@ interface MainCardOpts {
 /** Initial card sent at the start of each turn. Streaming on. */
 export function mainConversationCard(opts: MainCardOpts): object {
   const banner = opts.kind === 'scheduled'
-    ? [{ tag: 'markdown', content: '⏰ **定时任务触发** — Claude 在 idle 间隙被 CronCreate / ScheduleWakeup 唤醒' }]
+    ? [{ tag: 'markdown', content: '⏰ 触发' }]
     : []
   return {
     schema: '2.0',
@@ -276,6 +276,30 @@ export function toolCallElement(
   }
 }
 
+/** Merged panel for a run of consecutive `Read` tool calls in one turn.
+ * Header shows the dynamic count (`Read · 3 次`), body lists one row per
+ * Read with its own status + file path. Replaces the individual panels
+ * once a second Read joins the batch — single Reads still render as the
+ * full `toolCallElement` (with file-contents dump on completion). */
+export function readBatchElement(
+  i: number,
+  items: Array<{ input: any; output: string | null; isError: boolean }>,
+): object {
+  const n = items.length
+  const anyError = items.some(it => it.isError)
+  const allDone = items.every(it => it.output !== null)
+  const status = anyError ? '❌' : allDone ? '✅' : '⏳'
+  const headerText = `${status} 🔧 Read · ${n} 次`
+  const lines = items.map(it => `\`${String(it.input.file_path ?? '(无 path)')}\``)
+  return {
+    tag: 'collapsible_panel',
+    element_id: ELEMENTS.tool(i),
+    header: { title: { tag: 'plain_text', content: headerText } },
+    expanded: false,
+    elements: [{ tag: 'markdown', content: lines.join('\n') }],
+  }
+}
+
 /** Same tool panel as `toolCallElement`, but with the 🔐 status and
  * three inline action buttons (allow / allow_always / deny). Expanded
  * by default so the user can read the request without clicking through.
@@ -550,7 +574,6 @@ interface ConsoleOpts {
   cumStats?: { tokens: number; costUsd: number; turns: number }
   lastTurn?: { tokens: number; costUsd: number; durationMs: number }
   sessionId?: string | null
-  hasSession: boolean
 }
 
 /** Format token counts as a compact human-readable string: 1,234 → 1.2K. */
@@ -656,7 +679,7 @@ export function consoleUsageContent(
 export function consoleCard(opts: ConsoleOpts): object {
   const {
     sessionName, status, model, effort, uptimeMs, peers, usage,
-    contextTokens, contextLimit, cumStats, lastTurn, sessionId, hasSession,
+    contextTokens, contextLimit, cumStats, lastTurn, sessionId,
   } = opts
   const statusEmoji = {
     idle: '🟢 闲', working: '⚙️ 工作中', awaiting_permission: '🔐 等审批',
@@ -698,12 +721,6 @@ export function consoleCard(opts: ConsoleOpts): object {
     lines.push(`**🆔 session**　\`${sessionId.slice(0, 8)}…\``)
   }
 
-  void hasSession // accept the field for caller compat; lifecycle is now
-  // driven by bare-word commands (`hi` / `kill` / `restart` / `clear`),
-  // not buttons — keeps the panel pure-readout and one-handed mobile-
-  // friendly. The 'refresh' / 'ls' actions stay in onConsoleAction for
-  // backward compat with any still-floating older cards in chat history.
-
   const template = status === 'working' ? 'blue'
     : status === 'awaiting_permission' ? 'orange'
     : status === 'stopped' ? 'grey'

package/src/paths.ts

@@ -47,3 +47,11 @@ export const SESSION_RESUME_MAP_FILE = join(DATA_DIR, 'session-resume-map.json')
  * Lodestar's "you have to send a message to re-spawn it" default. */
 export const ALIVE_MARKER_FILE = join(DATA_DIR, 'alive-on-shutdown.json')
 export const INBOX_DIR = join(DATA_DIR, 'inbox')
+/** Unix-socket endpoint the daemon listens on for debug message
+ * injection (see scripts/test-inject.ts). A real Feishu user sends
+ * a `[DEBUG]…` text once to seed `DEBUG_CTX_FILE` with chat_id +
+ * sender_open_id; the injector then POSTs `{text}` here and the
+ * daemon replays it through `handleMessage` as if WS had delivered
+ * it. File mode 0600 — daemon-private, never network-exposed. */
+export const DEBUG_SOCK_FILE = join(DATA_DIR, 'debug.sock')
+export const DEBUG_CTX_FILE = join(DATA_DIR, 'debug-context.json')

package/src/session.ts

@@ -47,7 +47,23 @@ interface TurnState {
     resolvedNote?: string
     output?: string
     isError?: boolean
+    /** Set when this tool is part of a merged Read batch — points to the
+     * batch's slot in `readBatches[i].items`. completeTool uses it to
+     * update the right row instead of rendering a standalone panel. */
+    readBatchSlot?: number
   }>
+  /** Consecutive `Read` calls collapse into a single panel rendered by
+   * `cards.readBatchElement`. Keyed by element index `i` so completeTool
+   * can find the batch after its open-window closed (a non-Read tool or
+   * new assistant segment has since arrived).
+   *
+   * `openReadBatchI` is the i of the batch currently accepting new Reads;
+   * null once the run ends. Subsequent Read calls open a fresh batch at a
+   * new i. */
+  readBatches: Map<number, {
+    items: Array<{ toolUseId: string; input: any; output: string | null; isError: boolean }>
+  }>
+  openReadBatchI: number | null
   assistantSegmentCount: number
   currentAssistantSegmentId: string | null
   currentAssistantText: string
@@ -112,6 +128,15 @@ export class Session {
    * turns from cron-fired scheduled wakeups: count > 0 ⇒ user;
    * count === 0 ⇒ scheduled (and `initCount > 1`). */
   private pendingUserMessageCount = 0
+  /** Mid-turn user messages buffered DAEMON-SIDE (not yet sendUserText'd
+   * to the SDK). Drained in the `result` handler by writing each to SDK
+   * stdin, which doubles as the `priority="now"` wake signal the SDK
+   * polling loop needs to start the next batch turn (the SDK won't
+   * auto-dequeue queued type-ahead msgs after `result` — confirmed via
+   * claude-code issue #39632). Buffering also keeps mid-turn msgs out
+   * of any AskUserQuestion `QUEUE remove` storm, since they were never
+   * in the SDK queue to begin with. */
+  private pendingMidTurnMsgs: Array<{ wireText: string; files: string[]; userOpenId: string; msgId: string }> = []
   /** Most recent userOpenId seen via `onUserMessage`. Used only when a
    * merged batch fires its init event and the daemon needs *some* open_id
    * to scope the eventual `urgent_app` push — there's no obviously right
@@ -288,6 +313,7 @@ export class Session {
     this.proc = null
     this.currentTurn = null
     this.pendingUserMessageCount = 0
+    this.pendingMidTurnMsgs = []
     this.lastUserOpenId = ''
     this.pendingReactionIds = new Map()
     this.currentBatchReactionIds = new Map()
@@ -308,6 +334,7 @@ export class Session {
     }
     this.currentTurn = null
     this.pendingUserMessageCount = 0
+    this.pendingMidTurnMsgs = []
     this.lastUserOpenId = ''
     this.pendingReactionIds = new Map()
     this.currentBatchReactionIds = new Map()
@@ -372,11 +399,11 @@ export class Session {
         // but the daemon can't reach into it directly; in practice the
         // sendInterrupt() control_request causes the SDK to discard
         // queued input alongside the in-flight call.
-        if (!this.currentTurn && this.pendingUserMessageCount === 0) {
+        if (!this.currentTurn && this.pendingUserMessageCount === 0 && this.pendingMidTurnMsgs.length === 0) {
           await feishu.sendText(this.chatId, '⚪ 当前没有正在执行的 turn')
           return true
         }
-        log(`session "${this.sessionName}": stop command — interrupt + drop count=${this.pendingUserMessageCount}`)
+        log(`session "${this.sessionName}": stop command — interrupt + drop count=${this.pendingUserMessageCount} midBuffer=${this.pendingMidTurnMsgs.length}`)
         // Cancelled queued msgs: remove the OneSecond (no longer waiting)
         // and stamp a CrossMark (explicit cancelled state, distinct from
         // a natural release where reactions just disappear). Cancelled
@@ -388,19 +415,42 @@ export class Session {
           if (rid) void feishu.deleteReaction(msgId, rid)
           void feishu.addReaction(msgId, 'CrossMark')
         }
+        // Mid-turn buffer never reached SDK — cancel those too.
+        for (const msg of this.pendingMidTurnMsgs) {
+          if (msg.msgId) void feishu.addReaction(msg.msgId, 'CrossMark')
+        }
         this.pendingUserMessageCount = 0
+        this.pendingMidTurnMsgs = []
         this.lastUserOpenId = ''
         this.pendingReactionIds = new Map()
         this.currentBatchReactionIds = new Map()
         this.interrupt()
+        // SDK 收到 interrupt 后不发 `result`,没人会触发 closeTurnCard。
+        // 这里主动封口,把 footer 改成 🛑 打断、折叠 thinking、把
+        // streaming_mode 翻回 false,否则卡片会僵在 `⏳ working…`。
+        await this.closeTurnCard('🛑 打断')
         return true
       case 'kill':
         await this.stop()
         return true
       case 'restart':
+        // resume the prior conversation — kills the current proc (if
+        // any) and spawns a new one with `--resume <lastSessionId>`.
+        // If no process is running, this is how the user gets back the
+        // previous conversation after a `kill` or a daemon crash.
         await this.restart(true)
         return true
       case 'clear':
+        // "throw away current conversation, start a new one". By design
+        // this only makes sense when there IS a current conversation:
+        // calling clear from stopped state is a no-op (user-confirmed
+        // 2026-05-16) — we don't want a stray `clear` to silently spawn
+        // a fresh session the user didn't ask for. To start from cold,
+        // use `hi`.
+        if (!this.isRunning()) {
+          await feishu.sendText(this.chatId, `⚪ session "${this.sessionName}" 当前未运行,clear 无效;用 \`hi\` 启动或 \`restart\` 恢复上一会话`)
+          return true
+        }
         await this.restart(false)
         return true
     }
@@ -438,7 +488,6 @@ export class Session {
           }
         : undefined,
       sessionId: this.proc?.sessionId ?? this.lastSessionId,
-      hasSession: this.isRunning(),
     })
     const messageId = await feishu.sendCard(this.chatId, card)
     if (!messageId) return
@@ -519,8 +568,8 @@ export class Session {
     // reaction) and the model would see e.g. "123" + "321" + "1"
     // glued into a single string "1233211" (2026-05-16 accumulator
     // bug).
-    const wasBusy = this.currentTurn !== null || this.openingTurn || this.pendingUserMessageCount > 0
-    this.pendingUserMessageCount++
+    const wasBusy = this.currentTurn !== null || this.openingTurn
+      || this.pendingUserMessageCount > 0 || this.pendingMidTurnMsgs.length > 0
     this.lastUserOpenId = userOpenId
     // When the SDK will merge this msg with siblings into a multi-
     // content user turn, wrap it in `<u>...</u>` so the model sees a
@@ -534,51 +583,53 @@ export class Session {
     // skips the wrap — no sibling, no merge, no need. Contract
     // declared in CHANNEL_INSTRUCTIONS.
     const wireText = wasBusy ? `<u>${text}</u>` : text
-    this.proc!.sendUserText(wireText, files)
-    if (wasBusy && msgId) {
-      // Hold the slot in the map even if the API call hasn't returned
-      // yet — empty string is a sentinel meaning "we tried to react;
-      // reaction_id pending". When deleteReaction time comes, an empty
-      // string is a no-op (deleteReaction guards against it), which is
-      // the right behavior if the add failed.
-      this.pendingReactionIds.set(msgId, '')
+
+    // Reaction helper: track the OneSecond reaction so deleteReaction can
+    // clear it later. Use empty-string sentinel until addReaction returns.
+    const trackReaction = (id: string) => {
+      this.pendingReactionIds.set(id, '')
       void (async () => {
-        const rid = await feishu.addReaction(msgId, 'OneSecond')
+        const rid = await feishu.addReaction(id, 'OneSecond')
         if (!rid) return
-        if (this.pendingReactionIds.has(msgId)) {
-          this.pendingReactionIds.set(msgId, rid)
-        } else if (this.currentBatchReactionIds.has(msgId)) {
-          // Init handler renamed the sentinel into the batch map while
-          // addReaction was in flight — record the rid there so the
-          // batch's close-time deleteReaction sees it.
-          this.currentBatchReactionIds.set(msgId, rid)
+        if (this.pendingReactionIds.has(id)) {
+          this.pendingReactionIds.set(id, rid)
+        } else if (this.currentBatchReactionIds.has(id)) {
+          this.currentBatchReactionIds.set(id, rid)
         } else {
-          // Orphan: both maps cleared (closeTurnCard already released
-          // them) before our add returned. The reaction is now stuck
-          // on the Feishu message with no one tracking it — delete
+          // Orphan: both maps cleared before our add returned. Delete
           // directly so the user doesn't see a stale ⏳ forever.
-          // (Observed bug 2026-05-16: 8 OneSeconds added during a M0
-          // turn, 2 addReaction callbacks landed after close fired the
-          // release loop, those rids never made it back into either
-          // map → 2 stuck ⏳ in chat.)
-          void feishu.deleteReaction(msgId, rid)
+          void feishu.deleteReaction(id, rid)
         }
       })()
     }
-    // Mid-turn user messages don't touch the in-flight card — the SDK
-    // queues them and dequeues them on its next turn boundary, at
-    // which point `result` closes the current card with `📨 转交新卡`
-    // and `init` opens a fresh card for the merged batch turn. The
-    // user's own message bubble in the chat (plus the OneSecond ⏳
-    // reaction added above) is the only mid-flight feedback they get;
-    // no card edit, no echo inside the card.
-    if (!this.currentTurn && !this.openingTurn && this.initCount >= 1) {
-      // Eager open: this message is going to be processed solo (no current
-      // turn to merge with on the SDK side, so SDK runs it as its own turn).
-      // Claim one count and open the card with this message's own text +
-      // sender; any *additional* messages arriving during the open's
-      // Feishu API await will pile up in the count and get batched by the
-      // SDK into the NEXT turn (handled by the init handler).
+
+    if (this.currentTurn !== null) {
+      // Mid-turn — BUFFER instead of immediate sendUserText. The SDK polling
+      // loop will not auto-dequeue queued type-ahead msgs after `result`
+      // (only `priority="now"` writes wake it — claude-code issue #39632),
+      // so writing here would leave the msg stuck until the next user msg
+      // arrives. Drain happens in the `result` handler, which both wakes
+      // the SDK and opens a fresh card for the new batch turn.
+      this.pendingMidTurnMsgs.push({ wireText, files, userOpenId, msgId })
+      if (msgId) trackReaction(msgId)
+      return
+    }
+
+    // No in-flight turn: send straight to SDK. This path handles
+    //   - first message after spawn (init not yet fired)
+    //   - bootstrap race (sibling msgs landing before init#1)
+    //   - solo message after a prior turn has fully closed
+    this.proc!.sendUserText(wireText, files)
+    this.pendingUserMessageCount++
+    if (wasBusy && msgId) {
+      // Bootstrap race: the init handler will open the card for us; until
+      // then the OneSecond ⏳ is the only ack the user gets.
+      trackReaction(msgId)
+    }
+    if (!this.openingTurn && this.initCount >= 1) {
+      // Eager open: SDK is healthy and idle, open card now. Any extra
+      // messages arriving during the open's Feishu API await pile up in
+      // the count and the init handler batches them.
       this.openingTurn = true
       this.pendingUserMessageCount--
       try {
@@ -642,7 +693,7 @@ export class Session {
    * acknowledgement that their type-ahead message landed (the card
    * doesn't open until the current turn finishes). */
   isBusy(): boolean {
-    return this.currentTurn !== null || this.pendingUserMessageCount > 0
+    return this.currentTurn !== null || this.pendingUserMessageCount > 0 || this.pendingMidTurnMsgs.length > 0
   }
 
   /** Funnel an arbitrary chat message into the *current* question
@@ -777,19 +828,6 @@ export class Session {
     }
   }
 
-  async onConsoleAction(action: string): Promise<void> {
-    log(`session "${this.sessionName}": console action=${action}`)
-    switch (action) {
-      case 'interrupt': this.interrupt(); break
-      case 'clear':     await this.restart(false); break
-      case 'stop':      await this.stop(); break
-      case 'start':     await this.start(); break
-      case 'resume':    await this.restart(true); break
-      case 'refresh':   await this.showConsole(); break
-      case 'ls':        await feishu.sendText(this.chatId, `📁 ${this.workDir}`); break
-    }
-  }
-
   // ── Wiring Claude → Feishu ─────────────────────────────────────────
   private wireProc(p: ClaudeProcess): void {
     p.on('init', () => {
@@ -801,6 +839,7 @@ export class Session {
         feishu.bindSessionResume(this.sessionName, p.sessionId)
       }
       this.initCount++
+      log(`session "${this.sessionName}": SDK init#${this.initCount} pendingCount=${this.pendingUserMessageCount} midBuffer=${this.pendingMidTurnMsgs.length} currentTurn=${this.currentTurn ? 'yes' : 'no'} openingTurn=${this.openingTurn}`)
 
       // Boot init (initCount === 1) is claimed by `onUserMessage`'s
       // eager-open path — if a user message landed before the init
@@ -861,21 +900,28 @@ export class Session {
     })
     p.on('result', () => {
       this.accumulateResultStats()
-      // SDK-driven rotation: if any mid-turn user messages stacked up
-      // (the SDK is about to dequeue them into a fresh merged-batch
-      // turn), close the in-flight card with `📨 转交新卡` so the user
-      // sees the cut. The next `init` for that batch turn will open a
-      // new card whose top panel echoes those queued messages. No
-      // pending → natural ✅ close.
-      const suffix = this.pendingUserMessageCount > 0 ? '📨 转交新卡' : undefined
+      // Daemon-driven rotation: mid-turn msgs were buffered (not yet
+      // sent to SDK) — close the in-flight card with `📨 转交新卡` and
+      // drain the buffer in one shot. The drain writes each buffered
+      // msg to SDK stdin, which is the `priority="now"` wake the SDK
+      // polling loop needs (claude-code issue #39632) AND constitutes
+      // the input for the new batch turn. We open the new card here
+      // ourselves rather than waiting on init — the SDK init for this
+      // batch will fire shortly but `currentTurn` will already be set,
+      // so the init handler will return without double-opening.
+      const hasMidTurn = this.pendingMidTurnMsgs.length > 0
+      const suffix = hasMidTurn ? '📨 转交新卡' : undefined
+      log(`session "${this.sessionName}": SDK result midBuffer=${this.pendingMidTurnMsgs.length} suffix=${suffix ?? '<✅>'}`)
       void this.closeTurnCard(suffix)
       this.status = 'idle'
+      if (hasMidTurn) void this.drainMidTurnAndOpen()
     })
     p.on('exit', ({ code, signal, expected }: any) => {
       log(`session "${this.sessionName}": claude exited code=${code} signal=${signal} expected=${expected}`)
       this.proc = null
       this.currentTurn = null
       this.pendingUserMessageCount = 0
+      this.pendingMidTurnMsgs = []
       this.lastUserOpenId = ''
       this.pendingReactionIds = new Map()
       this.currentBatchReactionIds = new Map()
@@ -932,8 +978,39 @@ export class Session {
     return this.proc?.lastContextWindow ?? 200_000
   }
 
+  /** Drain `pendingMidTurnMsgs` to the SDK and open a fresh card for the
+   * resulting batch turn. Called from the `result` handler when buffered
+   * mid-turn messages need to start their own turn. The `sendUserText`
+   * calls wake the SDK polling loop (priority="now" semantics) and
+   * comprise the input for the new turn. Opens the card here rather
+   * than deferring to init because the init for this batch will arrive
+   * with `currentTurn` already set and bail. */
+  private async drainMidTurnAndOpen(): Promise<void> {
+    if (this.pendingMidTurnMsgs.length === 0) return
+    const batch = this.pendingMidTurnMsgs
+    this.pendingMidTurnMsgs = []
+    this.openingTurn = true
+    try {
+      for (const msg of batch) {
+        this.proc!.sendUserText(msg.wireText, msg.files)
+        if (msg.msgId) {
+          const rid = this.pendingReactionIds.get(msg.msgId) ?? ''
+          this.currentBatchReactionIds.set(msg.msgId, rid)
+          this.pendingReactionIds.delete(msg.msgId)
+        }
+      }
+      const last = batch[batch.length - 1]
+      const userOpenId = last?.userOpenId ?? this.lastUserOpenId
+      await this.openTurnCard(userOpenId, 'user_message')
+      this.status = 'working'
+    } finally {
+      this.openingTurn = false
+    }
+  }
+
   private async openTurnCard(userOpenId: string, trigger: 'user_message' | 'scheduled'): Promise<void> {
     const turn = ++this.turnCounter
+    log(`session "${this.sessionName}": openTurnCard turn=${turn} trigger=${trigger}`)
     const card = cards.mainConversationCard({
       sessionName: this.sessionName,
       turn,
@@ -972,6 +1049,8 @@ export class Session {
       thinkingText: '',
       toolCount: 0,
       toolByUseId: new Map(),
+      readBatches: new Map(),
+      openReadBatchI: null,
       assistantSegmentCount: 0,
       currentAssistantSegmentId: null,
       currentAssistantText: '',
@@ -988,6 +1067,10 @@ export class Session {
   private appendAssistant(delta: string): void {
     if (!this.currentTurn) return
     if (!this.currentTurn.currentAssistantSegmentId) {
+      // New assistant segment opens a visual break — any prior Read run
+      // is now visually separated from future Reads, so close the batch
+      // window. Future Reads will start a fresh batch at a new i.
+      this.currentTurn.openReadBatchI = null
       const i = this.currentTurn.assistantSegmentCount++
       const segId = cards.ELEMENTS.assistant(i)
       this.currentTurn.currentAssistantSegmentId = segId
@@ -1039,7 +1122,37 @@ export class Session {
       this.currentTurn.currentAssistantSegmentId = null
       this.currentTurn.currentAssistantText = ''
     }
+    // Consecutive Read merger: if a Read run is already open, append to
+    // its batch and re-render the panel instead of inserting a new one.
+    // Any other tool name closes the run (handled below).
+    if (name === 'Read' && this.currentTurn.openReadBatchI !== null) {
+      const batchI = this.currentTurn.openReadBatchI
+      const batch = this.currentTurn.readBatches.get(batchI)!
+      const slot = batch.items.length
+      batch.items.push({ toolUseId, input, output: null, isError: false })
+      this.currentTurn.toolByUseId.set(toolUseId, { i: batchI, name, input, readBatchSlot: slot })
+      const el = cards.readBatchElement(batchI, batch.items)
+      void cardkit.replaceElement(this.currentTurn.cardId, cards.ELEMENTS.tool(batchI), el)
+      return
+    }
+    if (name !== 'Read') this.currentTurn.openReadBatchI = null
     const i = this.currentTurn.toolCount++
+    if (name === 'Read') {
+      // First Read of a potential run — render the existing single-tool
+      // panel (which keeps the full file-contents dump on completion). If
+      // a second Read arrives, completeTool/addTool will switch it to
+      // `readBatchElement`.
+      this.currentTurn.openReadBatchI = i
+      this.currentTurn.readBatches.set(i, {
+        items: [{ toolUseId, input, output: null, isError: false }],
+      })
+      this.currentTurn.toolByUseId.set(toolUseId, { i, name, input, readBatchSlot: 0 })
+      const el = cards.toolCallElement(i, name, input, null, '⏳', undefined, undefined)
+      void cardkit.addElement(this.currentTurn.cardId, el, {
+        type: 'insert_before', targetElementId: cards.ELEMENTS.footer,
+      })
+      return
+    }
     this.currentTurn.toolByUseId.set(toolUseId, { i, name, input })
     // AskUserQuestion is a client-side tool — daemon renders the choice
     // UI in-line and supplies the tool_result itself once the user
@@ -1116,6 +1229,22 @@ export class Session {
     // via toolCallElement would clobber the nice option-row layout
     // with a generic JSON dump. Bail out; the panel is done.
     if (meta.name === 'AskUserQuestion') return
+    // Read batch path: update this row's status in the shared batch then
+    // re-render. Single-item batches keep the original full-output panel
+    // (file-contents dump); 2+ items switch to the compact `Read · N 次`
+    // listing, which overwrites whatever was last drawn at this i.
+    if (meta.name === 'Read' && meta.readBatchSlot != null) {
+      const batch = this.currentTurn.readBatches.get(meta.i)
+      if (batch) {
+        const row = batch.items[meta.readBatchSlot]
+        if (row) { row.output = output; row.isError = isError }
+        const el = batch.items.length >= 2
+          ? cards.readBatchElement(meta.i, batch.items)
+          : cards.toolCallElement(meta.i, meta.name, meta.input, output, isError ? '❌' : '✅', meta.resolvedNote, undefined)
+        void cardkit.replaceElement(this.currentTurn.cardId, cards.ELEMENTS.tool(meta.i), el)
+      }
+      return
+    }
     // Update the local todo mirror BEFORE rendering so the just-
     // completed panel shows the new state too (e.g. a TaskCreate panel
     // already lists the task it just created).