fix(claude): fill tool cards from can_use_tool; readable AskUserQuestion prompt

Tool cards showed no details in ask mode: the input arrives with the approval
request (can_use_tool carries tool_use_id + full input), but only the summary
used it. Now the adapter also fills/creates the tool card from that input so the
command / diff / path show even before the tool runs — alongside the existing
streamed-input path.

Also parse AskUserQuestion prompts into a readable question + bulleted options
instead of dumping raw {"questions":[...]} JSON into the approval card.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: gaoyu06

src/lib/backends/claude.test.ts

@@ -621,15 +621,19 @@ describe('claude adapter: approvals', () => {
 		const adapter = createClaudeAdapter();
 		boot(adapter, lines);
 		const events = adapter.translate(canUseBash);
-		expect(events).toHaveLength(1);
-		expect(events[0]).toMatchObject({
+		// The approval request also fills the tool card from its input (so the card
+		// shows the command even in ask mode, before it streams/completes).
+		expect(events).toContainEqual({ type: 'tool_start', call_id: 'toolu_01UET', name: 'bash' });
+		expect(events).toContainEqual({ type: 'tool_update', call_id: 'toolu_01UET', output: JSON.stringify({ command: 'mkdir probe-dir' }) });
+		const approval = events.find((e) => e.type === 'approval_request')!;
+		expect(approval).toMatchObject({
 			type: 'approval_request',
 			call_id: 'approval-1',
 			name: 'bash',
 			subagent_id: null,
 			hunks: null
 		});
-		expect(String(events[0].summary)).toContain('mkdir probe-dir');
+		expect(String(approval.summary)).toContain('mkdir probe-dir');
 
 		const frames = adapter.encodeOp({ op: 'approve', call_id: 'approval-1', decision: 'allow' });
 		expect(frames).toHaveLength(1);
@@ -702,8 +706,45 @@ describe('claude adapter: approvals', () => {
 				tool_use_id: 'toolu_w2'
 			}
 		});
-		expect(events[0]).toMatchObject({ type: 'approval_request', name: 'write' });
-		expect(String(events[0].summary)).toBe('/proj/probe-note.txt\n+hello');
+		// The card is filled from the request; the approval_request follows.
+		expect(events).toContainEqual({ type: 'tool_start', call_id: 'toolu_w2', name: 'write' });
+		const approval = events.find((e) => e.type === 'approval_request')!;
+		expect(approval).toMatchObject({ type: 'approval_request', name: 'write' });
+		expect(String(approval.summary)).toBe('/proj/probe-note.txt\n+hello');
+	});
+
+	it('renders an AskUserQuestion prompt as readable question + options (not raw JSON)', () => {
+		const { lines } = makeIo();
+		const adapter = createClaudeAdapter();
+		boot(adapter, lines);
+		const events = adapter.translate({
+			type: 'control_request',
+			request_id: 'req-q',
+			request: {
+				subtype: 'can_use_tool',
+				tool_name: 'AskUserQuestion',
+				tool_use_id: 'toolu_q',
+				input: {
+					questions: [
+						{
+							question: 'How to handle the existing index.html?',
+							header: 'How',
+							options: [
+								{ label: 'New file', description: 'keep index.html, write blog.html' },
+								{ label: 'Overwrite', description: 'replace index.html' }
+							],
+							multiSelect: false
+						}
+					]
+				}
+			}
+		});
+		const approval = events.find((e) => e.type === 'approval_request')!;
+		const summary = String(approval.summary);
+		expect(summary).toContain('How to handle the existing index.html?');
+		expect(summary).toContain('• New file — keep index.html, write blog.html');
+		expect(summary).toContain('• Overwrite — replace index.html');
+		expect(summary).not.toContain('{"questions"'); // no raw JSON
 	});
 
 	it('answers unsupported control requests with an error instead of hanging', () => {

src/lib/backends/claude.ts

@@ -292,6 +292,29 @@ function approvalSummary(req: CanUseToolRequest): string {
 		}
 		case 'Read':
 			return str(input.file_path);
+		case 'AskUserQuestion': {
+			// The model asking the user a multiple-choice question — render the
+			// question(s) + options readably instead of dumping raw JSON.
+			const questions = Array.isArray(input.questions) ? input.questions : [];
+			const text = questions
+				.map((q) => {
+					const m = rec(q);
+					if (!m) return '';
+					const opts = (Array.isArray(m.options) ? m.options : [])
+						.map((o) => {
+							const om = rec(o);
+							if (!om) return '';
+							const d = str(om.description);
+							return `  • ${str(om.label)}${d ? ` — ${d}` : ''}`;
+						})
+						.filter(Boolean)
+						.join('\n');
+					return [str(m.question), opts].filter(Boolean).join('\n');
+				})
+				.filter(Boolean)
+				.join('\n\n');
+			return cap(text || JSON.stringify(req.input));
+		}
 		default: {
 			const detail = str(req.description) || JSON.stringify(req.input);
 			return cap(`${req.tool_name}: ${detail}`);
@@ -788,18 +811,30 @@ export function createClaudeAdapter(): EngineAdapter {
 		const req = frame.request;
 		if (req?.subtype === 'can_use_tool') {
 			const r = req as unknown as CanUseToolRequest;
+			const events: NormalizedEvent[] = [];
+			// The approval request carries the tool's FULL input — fill the tool card
+			// from it (in ask mode the streamed input may not have reached the card),
+			// creating the card if the assistant stream hasn't shown it yet.
+			const tid = str(r.tool_use_id);
+			if (tid) {
+				const input = rec(r.input) ?? {};
+				const name = mapToolName(str(r.tool_name));
+				const known = tools.get(tid);
+				tools.set(tid, { claudeName: str(r.tool_name), name, input });
+				if (!known) events.push({ type: 'tool_start', call_id: tid, name });
+				events.push({ type: 'tool_update', call_id: tid, output: toolCardJson(str(r.tool_name), input) });
+			}
 			const callId = `approval-${++approvalSeq}`;
 			approvals.set(callId, { requestId: str(frame.request_id), request: r });
-			return [
-				{
-					type: 'approval_request',
-					call_id: callId,
-					name: mapToolName(str(r.tool_name)),
-					summary: approvalSummary(r),
-					subagent_id: null,
-					hunks: null
-				}
-			];
+			events.push({
+				type: 'approval_request',
+				call_id: callId,
+				name: mapToolName(str(r.tool_name)),
+				summary: approvalSummary(r),
+				subagent_id: null,
+				hunks: null
+			});
+			return events;
 		}
 		// Unsupported CLI→client request (request_user_dialog, elicitation, …):
 		// answer with an error so the CLI can resolve it instead of hanging.