STU-1873: Improve tool call descriptions

apps/cli/ai/ui.ts

@@ -254,7 +254,7 @@ const editorTheme: EditorTheme = {
 };
 
 function formatToolName( name: string, input?: Record< string, unknown > ): string {
-	const displayName = chalk.bold( getToolDisplayName( name ) );
+	const displayName = chalk.bold( getToolDisplayName( name, input ) );
 	const detail = getToolDetail( name, input );
 	if ( detail ) {
 		return displayName + ' ' + chalk.dim( detail );

apps/studio/src/components/studio-code-session/conversation/index.tsx

@@ -256,7 +256,7 @@ function ToolUseRow( {
 	input?: Record< string, unknown >;
 	result?: NormalizedToolResult;
 } ) {
-	const label = getToolDisplayName( name );
+	const label = getToolDisplayName( name, input );
 	const detail = getToolDetail( name, input );
 	const [ expanded, setExpanded ] = useState( false );
 	const resultText = result?.text?.trim() ?? '';

apps/ui/src/ui-classic/components/session-view/conversation/index.tsx

@@ -232,7 +232,7 @@ function ToolUseRow( {
 	input?: Record< string, unknown >;
 	result?: NormalizedToolResult;
 } ) {
-	const label = getToolDisplayName( name );
+	const label = getToolDisplayName( name, input );
 	const detail = getToolDetail( name, input );
 	const [ expanded, setExpanded ] = useState( false );
 	const resultText = result?.text?.trim() ?? '';

tools/common/ai/tests/tools.test.ts

@@ -0,0 +1,117 @@
+import { describe, expect, it } from 'vitest';
+import { getToolDetail, getToolDisplayName } from '../tools';
+
+describe( 'tool display helpers', () => {
+	it( 'summarizes common WP-CLI commands from their input', () => {
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'post list --post_type=post --post_status=publish',
+			} )
+		).toBe( 'List published posts' );
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'plugin activate jetpack',
+			} )
+		).toBe( 'Activate plugin: Jetpack' );
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'option get blogname',
+			} )
+		).toBe( 'Read site title' );
+	} );
+
+	it( 'formats WP-CLI plugin and theme targets as display names', () => {
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'plugin install woocommerce',
+			} )
+		).toBe( 'Install plugin: WooCommerce' );
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'plugin activate classic-editor',
+			} )
+		).toBe( 'Activate plugin: Classic Editor' );
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'plugin install --activate woocommerce',
+			} )
+		).toBe( 'Install plugin: WooCommerce' );
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'plugin install --version 9.0 woocommerce',
+			} )
+		).toBe( 'Install plugin: WooCommerce' );
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'theme activate my-custom-theme',
+			} )
+		).toBe( 'Activate theme: My Custom Theme' );
+	} );
+
+	it( 'does not treat WP-CLI flags as plugin names', () => {
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'plugin update --all',
+			} )
+		).toBe( 'Update all plugins' );
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'plugin activate --all',
+			} )
+		).toBe( 'Activate all plugins' );
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: 'plugin deactivate --all',
+			} )
+		).toBe( 'Deactivate all plugins' );
+	} );
+
+	it( 'ignores large WP-CLI payload values when deriving labels', () => {
+		expect(
+			getToolDisplayName( 'wp_cli', {
+				command: `post create --post_type=page --post_content=${ 'Block content '.repeat(
+					1000
+				) } --post_type=post`,
+			} )
+		).toBe( 'Create page' );
+	} );
+
+	it( 'keeps the full WP-CLI command available as detail', () => {
+		expect( getToolDetail( 'wp_cli', { command: 'plugin activate jetpack' } ) ).toBe(
+			'wp plugin activate jetpack'
+		);
+	} );
+
+	it( 'keeps terminal command detail available for compact surfaces', () => {
+		expect( getToolDisplayName( 'Bash' ) ).toBe( 'Run' );
+		expect( getToolDetail( 'Bash', { command: 'npm test' } ) ).toBe( 'npm test' );
+	} );
+
+	it( 'truncates long terminal commands', () => {
+		const detail = getToolDetail( 'Bash', {
+			command: "cat > /tmp/now-playing-draft.txt << 'ENDOFPOST' with much more text after it",
+		} );
+
+		expect( detail.length ).toBeLessThanOrEqual( 60 );
+		expect( detail.endsWith( '…' ) ).toBe( true );
+	} );
+
+	it( 'adds human names for Studio-specific visual tools', () => {
+		expect( getToolDisplayName( 'take_screenshot' ) ).toBe( 'Take screenshot' );
+		expect( getToolDisplayName( 'inspect_design' ) ).toBe( 'Inspect design' );
+		expect( getToolDisplayName( 'open_annotation_browser' ) ).toBe( 'Open annotation browser' );
+	} );
+
+	it( 'summarizes Ask User questions without exposing the raw tool name', () => {
+		expect(
+			getToolDetail( 'AskUserQuestion', {
+				questions: [
+					{
+						question: 'What kind of visual direction should this site use?',
+						options: [],
+					},
+				],
+			} )
+		).toBe( 'What kind of visual direction should this site use?' );
+	} );
+} );