summaryrefslogtreecommitdiff
path: root/packages/cli/src/ui/components/messages
diff options
context:
space:
mode:
authorJacob Richman <[email protected]>2025-05-24 00:44:17 -0700
committerGitHub <[email protected]>2025-05-24 00:44:17 -0700
commitb4c16d1f56f4e19fffd3d7608b410570f35045f9 (patch)
treedfda3634f4d266f5472bd37b78362abebe6a9c9e /packages/cli/src/ui/components/messages
parent1c3d9d7623ecff0437db0627cace0cbb421b458a (diff)
Code review comment fixes and some refactors. (#525)
No intentional different behavior aside for tweaks suggested from the code review of #506 Refactor: Extract console message logic to custom hook This commit refactors the console message handling from App.tsx into a new custom hook useConsoleMessages. This change improves the testability of the console message logic and declutters the main App component. Created useConsoleMessages.ts to encapsulate console message state and update logic. Updated App.tsx to utilize the new useConsoleMessages hook. Added unit tests for useConsoleMessages.ts to ensure its functionality. I deleted and started over on LoadingIndicator.test.tsx as I spent way too much time trying to fix it before just regenerating the tests as the code was easier to write tests for from scratch and the existing tests were not that good (I added them in the previous pull request).
Diffstat (limited to 'packages/cli/src/ui/components/messages')
-rw-r--r--packages/cli/src/ui/components/messages/ToolGroupMessage.tsx9
-rw-r--r--packages/cli/src/ui/components/messages/ToolMessage.test.tsx82
-rw-r--r--packages/cli/src/ui/components/messages/ToolMessage.tsx77
3 files changed, 85 insertions, 83 deletions
diff --git a/packages/cli/src/ui/components/messages/ToolGroupMessage.tsx b/packages/cli/src/ui/components/messages/ToolGroupMessage.tsx
index c6c8b874..8bcde3bb 100644
--- a/packages/cli/src/ui/components/messages/ToolGroupMessage.tsx
+++ b/packages/cli/src/ui/components/messages/ToolGroupMessage.tsx
@@ -6,11 +6,7 @@
import React, { useMemo } from 'react';
import { Box } from 'ink';
-import {
- IndividualToolCallDisplay,
- StreamingState,
- ToolCallStatus,
-} from '../../types.js';
+import { IndividualToolCallDisplay, ToolCallStatus } from '../../types.js';
import { ToolMessage } from './ToolMessage.js';
import { ToolConfirmationMessage } from './ToolConfirmationMessage.js';
import { Colors } from '../../colors.js';
@@ -19,14 +15,12 @@ interface ToolGroupMessageProps {
groupId: number;
toolCalls: IndividualToolCallDisplay[];
availableTerminalHeight: number;
- streamingState?: StreamingState;
}
// Main component renders the border and maps the tools using ToolMessage
export const ToolGroupMessage: React.FC<ToolGroupMessageProps> = ({
toolCalls,
availableTerminalHeight,
- streamingState,
}) => {
const hasPending = !toolCalls.every(
(t) => t.status === ToolCallStatus.Success,
@@ -78,7 +72,6 @@ export const ToolGroupMessage: React.FC<ToolGroupMessageProps> = ({
? 'low'
: 'medium'
}
- streamingState={streamingState}
/>
</Box>
{tool.status === ToolCallStatus.Confirming &&
diff --git a/packages/cli/src/ui/components/messages/ToolMessage.test.tsx b/packages/cli/src/ui/components/messages/ToolMessage.test.tsx
index 1c81cc36..10380ad4 100644
--- a/packages/cli/src/ui/components/messages/ToolMessage.test.tsx
+++ b/packages/cli/src/ui/components/messages/ToolMessage.test.tsx
@@ -8,6 +8,7 @@ import { render } from 'ink-testing-library';
import { ToolMessage, ToolMessageProps } from './ToolMessage.js';
import { StreamingState, ToolCallStatus } from '../../types.js';
import { Text } from 'ink';
+import { StreamingContext } from '../../contexts/StreamingContext.js';
// Mock child components or utilities if they are complex or have side effects
vi.mock('ink-spinner', () => ({
@@ -28,6 +29,17 @@ vi.mock('../../utils/MarkdownDisplay.js', () => ({
},
}));
+// Helper to render with context
+const renderWithContext = (
+ ui: React.ReactElement,
+ streamingState: StreamingState,
+) =>
+ render(
+ <StreamingContext.Provider value={{ streamingState }}>
+ {ui}
+ </StreamingContext.Provider>,
+ );
+
describe('<ToolMessage />', () => {
const baseProps: ToolMessageProps = {
callId: 'tool-123',
@@ -38,11 +50,13 @@ describe('<ToolMessage />', () => {
availableTerminalHeight: 20,
confirmationDetails: undefined,
emphasis: 'medium',
- streamingState: StreamingState.Idle,
};
it('renders basic tool information', () => {
- const { lastFrame } = render(<ToolMessage {...baseProps} />);
+ const { lastFrame } = renderWithContext(
+ <ToolMessage {...baseProps} />,
+ StreamingState.Idle,
+ );
const output = lastFrame();
expect(output).toContain('✔'); // Success indicator
expect(output).toContain('test-tool');
@@ -52,73 +66,72 @@ describe('<ToolMessage />', () => {
describe('ToolStatusIndicator rendering', () => {
it('shows ✔ for Success status', () => {
- const { lastFrame } = render(
+ const { lastFrame } = renderWithContext(
<ToolMessage {...baseProps} status={ToolCallStatus.Success} />,
+ StreamingState.Idle,
);
expect(lastFrame()).toContain('✔');
});
it('shows o for Pending status', () => {
- const { lastFrame } = render(
+ const { lastFrame } = renderWithContext(
<ToolMessage {...baseProps} status={ToolCallStatus.Pending} />,
+ StreamingState.Idle,
);
expect(lastFrame()).toContain('o');
});
it('shows ? for Confirming status', () => {
- const { lastFrame } = render(
+ const { lastFrame } = renderWithContext(
<ToolMessage {...baseProps} status={ToolCallStatus.Confirming} />,
+ StreamingState.Idle,
);
expect(lastFrame()).toContain('?');
});
it('shows - for Canceled status', () => {
- const { lastFrame } = render(
+ const { lastFrame } = renderWithContext(
<ToolMessage {...baseProps} status={ToolCallStatus.Canceled} />,
+ StreamingState.Idle,
);
expect(lastFrame()).toContain('-');
});
it('shows x for Error status', () => {
- const { lastFrame } = render(
+ const { lastFrame } = renderWithContext(
<ToolMessage {...baseProps} status={ToolCallStatus.Error} />,
+ StreamingState.Idle,
);
expect(lastFrame()).toContain('x');
});
- it('shows MockSpinner for Executing status when streamingState is Idle', () => {
- const { lastFrame } = render(
- <ToolMessage
- {...baseProps}
- status={ToolCallStatus.Executing}
- streamingState={StreamingState.Idle}
- />,
+ it('shows paused spiner for Executing status when streamingState is Idle', () => {
+ const { lastFrame } = renderWithContext(
+ <ToolMessage {...baseProps} status={ToolCallStatus.Executing} />,
+ StreamingState.Idle,
);
- expect(lastFrame()).toContain('MockSpinner');
+ expect(lastFrame()).toContain('⠇');
+ expect(lastFrame()).not.toContain('MockSpinner');
expect(lastFrame()).not.toContain('✔');
});
- it('shows MockSpinner for Executing status when streamingState is undefined (default behavior)', () => {
- const { lastFrame } = render(
+ it('shows paused spiner for Executing status when streamingState is WaitingForConfirmation', () => {
+ const { lastFrame } = renderWithContext(
<ToolMessage {...baseProps} status={ToolCallStatus.Executing} />,
+ StreamingState.WaitingForConfirmation,
);
- expect(lastFrame()).toContain('MockSpinner');
+ expect(lastFrame()).toContain('⠇');
+ expect(lastFrame()).not.toContain('MockSpinner');
expect(lastFrame()).not.toContain('✔');
});
- it('shows ✔ (paused/confirmed look) for Executing status when streamingState is Responding', () => {
- // This is the key change from the commit: if the overall app is still responding
- // (e.g., waiting for other tool confirmations), an already confirmed and executing tool
- // should show a static checkmark to avoid spinner flicker.
- const { lastFrame } = render(
- <ToolMessage
- {...baseProps}
- status={ToolCallStatus.Executing}
- streamingState={StreamingState.Responding} // Simulate app still responding
- />,
+ it('shows MockSpinner for Executing status when streamingState is Responding', () => {
+ const { lastFrame } = renderWithContext(
+ <ToolMessage {...baseProps} status={ToolCallStatus.Executing} />,
+ StreamingState.Responding, // Simulate app still responding
);
- expect(lastFrame()).toContain('✔'); // Should be a checkmark, not spinner
- expect(lastFrame()).not.toContain('MockSpinner');
+ expect(lastFrame()).toContain('MockSpinner');
+ expect(lastFrame()).not.toContain('✔');
});
});
@@ -127,22 +140,25 @@ describe('<ToolMessage />', () => {
fileDiff: '--- a/file.txt\n+++ b/file.txt\n@@ -1 +1 @@\n-old\n+new',
fileName: 'file.txt',
};
- const { lastFrame } = render(
+ const { lastFrame } = renderWithContext(
<ToolMessage {...baseProps} resultDisplay={diffResult} />,
+ StreamingState.Idle,
);
// Check that the output contains the MockDiff content as part of the whole message
expect(lastFrame()).toMatch(/MockDiff:--- a\/file\.txt/);
});
it('renders emphasis correctly', () => {
- const { lastFrame: highEmphasisFrame } = render(
+ const { lastFrame: highEmphasisFrame } = renderWithContext(
<ToolMessage {...baseProps} emphasis="high" />,
+ StreamingState.Idle,
);
// Check for trailing indicator or specific color if applicable (Colors are not easily testable here)
expect(highEmphasisFrame()).toContain('←'); // Trailing indicator for high emphasis
- const { lastFrame: lowEmphasisFrame } = render(
+ const { lastFrame: lowEmphasisFrame } = renderWithContext(
<ToolMessage {...baseProps} emphasis="low" />,
+ StreamingState.Idle,
);
// For low emphasis, the name and description might be dimmed (check for dimColor if possible)
// This is harder to assert directly in text output without color checks.
diff --git a/packages/cli/src/ui/components/messages/ToolMessage.tsx b/packages/cli/src/ui/components/messages/ToolMessage.tsx
index 49743190..775b4177 100644
--- a/packages/cli/src/ui/components/messages/ToolMessage.tsx
+++ b/packages/cli/src/ui/components/messages/ToolMessage.tsx
@@ -15,6 +15,7 @@ import {
import { DiffRenderer } from './DiffRenderer.js';
import { Colors } from '../../colors.js';
import { MarkdownDisplay } from '../../utils/MarkdownDisplay.js';
+import { useStreamingContext } from '../../contexts/StreamingContext.js';
const STATIC_HEIGHT = 1;
const RESERVED_LINE_COUNT = 5; // for tool name, status, padding etc.
@@ -25,7 +26,6 @@ export type TextEmphasis = 'high' | 'medium' | 'low';
export interface ToolMessageProps extends IndividualToolCallDisplay {
availableTerminalHeight: number;
emphasis?: TextEmphasis;
- streamingState?: StreamingState;
}
export const ToolMessage: React.FC<ToolMessageProps> = ({
@@ -35,7 +35,6 @@ export const ToolMessage: React.FC<ToolMessageProps> = ({
status,
availableTerminalHeight,
emphasis = 'medium',
- streamingState,
}) => {
const contentHeightEstimate =
availableTerminalHeight - STATIC_HEIGHT - RESERVED_LINE_COUNT;
@@ -63,7 +62,7 @@ export const ToolMessage: React.FC<ToolMessageProps> = ({
<Box paddingX={1} paddingY={0} flexDirection="column">
<Box minHeight={1}>
{/* Status Indicator */}
- <ToolStatusIndicator status={status} streamingState={streamingState} />
+ <ToolStatusIndicator status={status} />
<ToolInfo
name={name}
status={status}
@@ -107,48 +106,42 @@ export const ToolMessage: React.FC<ToolMessageProps> = ({
type ToolStatusIndicatorProps = {
status: ToolCallStatus;
- streamingState?: StreamingState;
};
const ToolStatusIndicator: React.FC<ToolStatusIndicatorProps> = ({
status,
- streamingState,
-}) => (
- <Box minWidth={STATUS_INDICATOR_WIDTH}>
- {status === ToolCallStatus.Pending && (
- <Text color={Colors.AccentGreen}>o</Text>
- )}
- {status === ToolCallStatus.Executing &&
- (streamingState === StreamingState.Responding ? (
- // If the tool is responding that means the user has already confirmed
- // this tool call, so we can show a checkmark. The call won't complete
- // executing until all confirmations are done. Showing a spinner would
- // be misleading as the task is not actually executing at the moment
- // and also has flickering issues due to Ink rendering limitations.
- // If this hack becomes a problem, we can always add an additional prop
- // indicating that the tool was indeed confirmed. If the tool was not
- // confirmed we could show a paused version of the spinner.
- <Text color={Colors.Gray}>✔</Text>
- ) : (
- <Spinner type="dots" />
- ))}
- {status === ToolCallStatus.Success && (
- <Text color={Colors.AccentGreen}>✔</Text>
- )}
- {status === ToolCallStatus.Confirming && (
- <Text color={Colors.AccentYellow}>?</Text>
- )}
- {status === ToolCallStatus.Canceled && (
- <Text color={Colors.AccentYellow} bold>
- -
- </Text>
- )}
- {status === ToolCallStatus.Error && (
- <Text color={Colors.AccentRed} bold>
- x
- </Text>
- )}
- </Box>
-);
+}) => {
+ const { streamingState } = useStreamingContext();
+ return (
+ <Box minWidth={STATUS_INDICATOR_WIDTH}>
+ {status === ToolCallStatus.Pending && (
+ <Text color={Colors.AccentGreen}>o</Text>
+ )}
+ {status === ToolCallStatus.Executing &&
+ (streamingState === StreamingState.Responding ? (
+ <Spinner type="dots" />
+ ) : (
+ // Paused spinner to avoid flicker.
+ <Text>⠇</Text>
+ ))}
+ {status === ToolCallStatus.Success && (
+ <Text color={Colors.AccentGreen}>✔</Text>
+ )}
+ {status === ToolCallStatus.Confirming && (
+ <Text color={Colors.AccentYellow}>?</Text>
+ )}
+ {status === ToolCallStatus.Canceled && (
+ <Text color={Colors.AccentYellow} bold>
+ -
+ </Text>
+ )}
+ {status === ToolCallStatus.Error && (
+ <Text color={Colors.AccentRed} bold>
+ x
+ </Text>
+ )}
+ </Box>
+ );
+};
type ToolInfo = {
name: string;