@qduc/term2 0.1.2 → 0.1.4

package/dist/utils/conversation-event-handler.test.js

@@ -0,0 +1,281 @@
+import test from 'ava';
+import { createConversationEventHandler, } from './conversation-event-handler.js';
+import { createStreamingState } from './conversation-utils.js';
+function createMockDeps() {
+    const calls = {
+        liveResponsePushes: [],
+        liveResponseCancelled: false,
+        liveResponseFlushed: false,
+        reasoningPushes: [],
+        reasoningFlushed: false,
+        appendedMessages: [],
+        setMessagesCalls: [],
+        liveResponses: [],
+    };
+    return {
+        calls,
+        liveResponseUpdater: {
+            push: (text) => calls.liveResponsePushes.push(text),
+            cancel: () => {
+                calls.liveResponseCancelled = true;
+            },
+            flush: () => {
+                calls.liveResponseFlushed = true;
+            },
+        },
+        reasoningUpdater: {
+            push: (text) => calls.reasoningPushes.push(text),
+            cancel: () => { },
+            flush: () => {
+                calls.reasoningFlushed = true;
+            },
+        },
+        appendMessages: (messages) => calls.appendedMessages.push(messages),
+        setMessages: (updater) => calls.setMessagesCalls.push(updater),
+        setLiveResponse: (response) => calls.liveResponses.push(response),
+        trimMessages: (messages) => messages,
+        annotateCommandMessage: (msg) => ({ ...msg, annotated: true }),
+    };
+}
+// =============================================================================
+// text_delta tests
+// =============================================================================
+test('text_delta: accumulates text and pushes to live response', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({ type: 'text_delta', delta: 'Hello ' });
+    handler({ type: 'text_delta', delta: 'world!' });
+    t.is(state.accumulatedText, 'Hello world!');
+    t.deepEqual(deps.calls.liveResponsePushes, ['Hello ', 'Hello world!']);
+});
+// =============================================================================
+// reasoning_delta tests
+// =============================================================================
+test('reasoning_delta: accumulates reasoning after flushed position', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'reasoning_delta',
+        delta: 'ing',
+        fullText: 'Thinking',
+    });
+    t.is(state.accumulatedReasoningText, 'Thinking');
+    t.deepEqual(deps.calls.reasoningPushes, ['Thinking']);
+});
+test('reasoning_delta: skips already flushed reasoning', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    state.flushedReasoningLength = 5; // Already flushed "Think"
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'reasoning_delta',
+        delta: 'ing',
+        fullText: 'Thinking',
+    });
+    t.is(state.accumulatedReasoningText, 'ing');
+    t.deepEqual(deps.calls.reasoningPushes, ['ing']);
+});
+test('reasoning_delta: ignores empty reasoning', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'reasoning_delta',
+        delta: '',
+        fullText: '   ',
+    });
+    t.is(state.accumulatedReasoningText, '   ');
+    t.deepEqual(deps.calls.reasoningPushes, []);
+});
+// =============================================================================
+// tool_started tests
+// =============================================================================
+test('tool_started: flushes accumulated text before showing tool', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    state.accumulatedText = 'Some text before tool';
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'tool_started',
+        toolCallId: 'call-1',
+        toolName: 'shell',
+        arguments: { command: 'ls' },
+    });
+    t.is(state.accumulatedText, '');
+    t.is(state.textWasFlushed, true);
+    t.true(deps.calls.liveResponseCancelled);
+    // Should append text message and command message
+    t.is(deps.calls.appendedMessages.length, 2);
+    t.is(deps.calls.appendedMessages[0][0].sender, 'bot');
+    t.is(deps.calls.appendedMessages[0][0].text, 'Some text before tool');
+});
+test('tool_started: flushes accumulated reasoning before showing tool', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    state.accumulatedReasoningText = 'Some reasoning';
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'tool_started',
+        toolCallId: 'call-1',
+        toolName: 'shell',
+        arguments: { command: 'ls' },
+    });
+    t.true(deps.calls.reasoningFlushed);
+    t.is(state.accumulatedReasoningText, '');
+    t.is(state.flushedReasoningLength, 14); // 'Some reasoning'.length
+    t.is(state.currentReasoningMessageId, null);
+});
+test('tool_started: creates pending command message with shell command', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'tool_started',
+        toolCallId: 'call-1',
+        toolName: 'shell',
+        arguments: { command: 'echo hello' },
+    });
+    t.is(deps.calls.appendedMessages.length, 1);
+    const cmdMsg = deps.calls.appendedMessages[0][0];
+    t.is(cmdMsg.sender, 'command');
+    t.is(cmdMsg.status, 'running');
+    t.is(cmdMsg.command, 'echo hello');
+    t.is(cmdMsg.toolName, 'shell');
+    t.is(cmdMsg.callId, 'call-1');
+});
+test('tool_started: parses JSON string arguments', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'tool_started',
+        toolCallId: 'call-1',
+        toolName: 'shell',
+        arguments: '{"command": "pwd"}',
+    });
+    const cmdMsg = deps.calls.appendedMessages[0][0];
+    t.is(cmdMsg.command, 'pwd');
+    t.deepEqual(cmdMsg.toolArgs, { command: 'pwd' });
+});
+test('tool_started: formats grep command correctly', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'tool_started',
+        toolCallId: 'call-1',
+        toolName: 'grep',
+        arguments: { pattern: 'TODO', path: 'src/' },
+    });
+    const cmdMsg = deps.calls.appendedMessages[0][0];
+    t.is(cmdMsg.command, 'grep "TODO" src/');
+});
+// =============================================================================
+// command_message tests
+// =============================================================================
+test('command_message: annotates and updates existing pending message', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'command_message',
+        message: {
+            id: 'call-1',
+            sender: 'command',
+            status: 'completed',
+            command: 'ls',
+            output: 'file.txt',
+            callId: 'call-1',
+            toolName: 'shell',
+        },
+    });
+    t.is(deps.calls.setMessagesCalls.length, 1);
+    // The annotateCommandMessage should have been called
+    const updater = deps.calls.setMessagesCalls[0];
+    const existingMessages = [
+        { id: 'call-1', sender: 'command', status: 'running', callId: 'call-1' },
+    ];
+    const result = updater(existingMessages);
+    t.true(result[0].annotated);
+    t.is(result[0].status, 'completed');
+});
+test('command_message: adds new message if no pending exists', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'command_message',
+        message: {
+            id: 'call-new',
+            sender: 'command',
+            status: 'completed',
+            command: 'ls',
+            output: 'file.txt',
+            callId: 'call-new',
+            toolName: 'shell',
+        },
+    });
+    const updater = deps.calls.setMessagesCalls[0];
+    const existingMessages = [{ id: 1, sender: 'user', text: 'hi' }];
+    const result = updater(existingMessages);
+    t.is(result.length, 2);
+    t.true(result[1].annotated);
+});
+test('command_message: flushes accumulated text before adding', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    state.accumulatedText = 'Partial response';
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'command_message',
+        message: {
+            id: 'call-1',
+            sender: 'command',
+            status: 'completed',
+            command: 'ls',
+            output: '',
+            callId: 'call-1',
+        },
+    });
+    t.is(state.accumulatedText, '');
+    t.is(state.textWasFlushed, true);
+    t.is(deps.calls.appendedMessages.length, 1);
+    t.is(deps.calls.appendedMessages[0][0].text, 'Partial response');
+});
+// =============================================================================
+// retry tests
+// =============================================================================
+test('retry: adds system message about hallucination retry', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    handler({
+        type: 'retry',
+        toolName: 'shell',
+        attempt: 1,
+        maxRetries: 2,
+        errorMessage: 'Tool hallucination detected',
+    });
+    t.is(deps.calls.setMessagesCalls.length, 1);
+    const updater = deps.calls.setMessagesCalls[0];
+    const result = updater([]);
+    t.is(result.length, 1);
+    t.is(result[0].sender, 'system');
+    t.true(result[0].text.includes('shell'));
+    t.true(result[0].text.includes('1/2'));
+});
+// =============================================================================
+// unknown event tests
+// =============================================================================
+test('unknown event: is ignored without error', t => {
+    const deps = createMockDeps();
+    const state = createStreamingState();
+    const handler = createConversationEventHandler(deps, state);
+    // Should not throw
+    handler({ type: 'unknown_event' });
+    t.is(deps.calls.appendedMessages.length, 0);
+    t.is(deps.calls.setMessagesCalls.length, 0);
+});
+//# sourceMappingURL=conversation-event-handler.test.js.map

package/dist/utils/conversation-event-handler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-event-handler.test.js","sourceRoot":"","sources":["../../source/utils/conversation-event-handler.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/conversation-utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure utility functions extracted from use-conversation.ts for testability.
+ * These contain no React state or side effects.
+ */
+/**
+ * State tracked during streaming event processing.
+ */
+export interface StreamingState {
+    accumulatedText: string;
+    accumulatedReasoningText: string;
+    flushedReasoningLength: number;
+    textWasFlushed: boolean;
+    currentReasoningMessageId: number | null;
+}
+/**
+ * Normalize tool arguments from JSON string or object.
+ * Provider implementations may send arguments as either format.
+ */
+export declare function parseToolArguments(rawArgs: unknown): unknown;
+/**
+ * Build a human-readable command string for display in the UI.
+ * Each tool has its own formatting logic.
+ */
+export declare function formatToolCommand(toolName: string, args: Record<string, unknown> | null | undefined): string;
+/**
+ * Create initial streaming state for a new message send/approval flow.
+ */
+export declare function createStreamingState(): StreamingState;
+/**
+ * Enhance error messages for common API key issues.
+ */
+export declare function enhanceApiKeyError(message: string): string;
+/**
+ * Check if an error message indicates max turns exceeded.
+ */
+export declare function isMaxTurnsError(message: string): boolean;
+/**
+ * Format shell command output for display.
+ */
+export declare function createShellMessageOutput(returnCode: number | null, stdout: string, stderr: string): string;
+//# sourceMappingURL=conversation-utils.d.ts.map

package/dist/utils/conversation-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-utils.d.ts","sourceRoot":"","sources":["../../source/utils/conversation-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAa5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9C,MAAM,CAoCR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAQrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAW1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACvC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,MAAM,CAsBR"}

package/dist/utils/conversation-utils.js

@@ -0,0 +1,109 @@
+/**
+ * Pure utility functions extracted from use-conversation.ts for testability.
+ * These contain no React state or side effects.
+ */
+/**
+ * Normalize tool arguments from JSON string or object.
+ * Provider implementations may send arguments as either format.
+ */
+export function parseToolArguments(rawArgs) {
+    if (typeof rawArgs !== 'string') {
+        return rawArgs;
+    }
+    const trimmed = rawArgs.trim();
+    if (!trimmed) {
+        return rawArgs;
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return rawArgs;
+    }
+}
+/**
+ * Build a human-readable command string for display in the UI.
+ * Each tool has its own formatting logic.
+ */
+export function formatToolCommand(toolName, args) {
+    if (!args) {
+        return toolName;
+    }
+    if (toolName === 'shell') {
+        const cmd = args.command ?? args.commands;
+        if (typeof cmd === 'string' && cmd.trim()) {
+            return cmd;
+        }
+        if (Array.isArray(cmd) && cmd.length > 0) {
+            return cmd.join('\n');
+        }
+        return toolName;
+    }
+    if (toolName === 'grep') {
+        if (args.pattern) {
+            return `grep "${args.pattern}" ${args.path ?? '.'}`;
+        }
+        return toolName;
+    }
+    if (toolName === 'search_replace') {
+        return `search_replace "${args.search_content ?? ''}" → "${args.replace_content ?? ''}" ${args.path ?? ''}`;
+    }
+    if (toolName === 'apply_patch') {
+        return `apply_patch ${args.type ?? 'unknown'} ${args.path ?? ''}`;
+    }
+    if (toolName === 'ask_mentor') {
+        return `ask_mentor: ${args.question ?? ''}`;
+    }
+    return toolName;
+}
+/**
+ * Create initial streaming state for a new message send/approval flow.
+ */
+export function createStreamingState() {
+    return {
+        accumulatedText: '',
+        accumulatedReasoningText: '',
+        flushedReasoningLength: 0,
+        textWasFlushed: false,
+        currentReasoningMessageId: null,
+    };
+}
+/**
+ * Enhance error messages for common API key issues.
+ */
+export function enhanceApiKeyError(message) {
+    if (message.includes('OPENAI_API_KEY') ||
+        (message.includes('401') && message.toLowerCase().includes('unauthorized'))) {
+        return ('OpenAI API key is not configured or invalid. Please set the OPENAI_API_KEY environment variable. ' +
+            'Get your API key from: https://platform.openai.com/api-keys');
+    }
+    return message;
+}
+/**
+ * Check if an error message indicates max turns exceeded.
+ */
+export function isMaxTurnsError(message) {
+    return message.includes('Max turns') && message.includes('exceeded');
+}
+/**
+ * Format shell command output for display.
+ */
+export function createShellMessageOutput(returnCode, stdout, stderr) {
+    const parts = [];
+    // Combine stdout and stderr
+    const trimmedStdout = stdout.replace(/\n+$/, '');
+    const trimmedStderr = stderr.replace(/\n+$/, '');
+    if (trimmedStdout) {
+        parts.push(trimmedStdout);
+    }
+    if (trimmedStderr) {
+        parts.push(trimmedStderr);
+    }
+    let output = parts.join('\n');
+    // Add return code if available
+    if (returnCode !== null) {
+        output += `\n\nReturn code: ${returnCode}`;
+    }
+    return output;
+}
+//# sourceMappingURL=conversation-utils.js.map

package/dist/utils/conversation-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-utils.js","sourceRoot":"","sources":["../../source/utils/conversation-utils.ts"],"names":[],"mappings":"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"}

package/dist/utils/conversation-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversation-utils.test.d.ts.map

package/dist/utils/conversation-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-utils.test.d.ts","sourceRoot":"","sources":["../../source/utils/conversation-utils.test.ts"],"names":[],"mappings":""}

package/dist/utils/conversation-utils.test.js

@@ -0,0 +1,190 @@
+import test from 'ava';
+import { parseToolArguments, formatToolCommand, createStreamingState, enhanceApiKeyError, isMaxTurnsError, createShellMessageOutput, } from './conversation-utils.js';
+// =============================================================================
+// parseToolArguments tests
+// =============================================================================
+test('parseToolArguments: returns object as-is', t => {
+    const args = { command: 'echo hi' };
+    t.deepEqual(parseToolArguments(args), args);
+});
+test('parseToolArguments: parses valid JSON string', t => {
+    const args = '{"command": "echo hi"}';
+    t.deepEqual(parseToolArguments(args), { command: 'echo hi' });
+});
+test('parseToolArguments: returns invalid JSON string as-is', t => {
+    const args = 'not valid json';
+    t.is(parseToolArguments(args), args);
+});
+test('parseToolArguments: returns empty string as-is', t => {
+    t.is(parseToolArguments(''), '');
+});
+test('parseToolArguments: returns whitespace-only string as-is', t => {
+    t.is(parseToolArguments('   '), '   ');
+});
+test('parseToolArguments: handles null', t => {
+    t.is(parseToolArguments(null), null);
+});
+test('parseToolArguments: handles undefined', t => {
+    t.is(parseToolArguments(undefined), undefined);
+});
+test('parseToolArguments: parses array JSON', t => {
+    const args = '["a", "b", "c"]';
+    t.deepEqual(parseToolArguments(args), ['a', 'b', 'c']);
+});
+// =============================================================================
+// formatToolCommand tests
+// =============================================================================
+test('formatToolCommand: shell with string command', t => {
+    const result = formatToolCommand('shell', { command: 'echo hello' });
+    t.is(result, 'echo hello');
+});
+test('formatToolCommand: shell with commands (plural) string', t => {
+    const result = formatToolCommand('shell', { commands: 'ls -la' });
+    t.is(result, 'ls -la');
+});
+test('formatToolCommand: shell with array commands', t => {
+    const result = formatToolCommand('shell', { commands: ['cd /tmp', 'ls'] });
+    t.is(result, 'cd /tmp\nls');
+});
+test('formatToolCommand: shell with empty command returns tool name', t => {
+    const result = formatToolCommand('shell', { command: '' });
+    t.is(result, 'shell');
+});
+test('formatToolCommand: grep with pattern and path', t => {
+    const result = formatToolCommand('grep', {
+        pattern: 'TODO',
+        path: 'src/',
+    });
+    t.is(result, 'grep "TODO" src/');
+});
+test('formatToolCommand: grep with pattern only uses default path', t => {
+    const result = formatToolCommand('grep', { pattern: 'FIXME' });
+    t.is(result, 'grep "FIXME" .');
+});
+test('formatToolCommand: grep without pattern returns tool name', t => {
+    const result = formatToolCommand('grep', {});
+    t.is(result, 'grep');
+});
+test('formatToolCommand: search_replace with all args', t => {
+    const result = formatToolCommand('search_replace', {
+        search_content: 'old',
+        replace_content: 'new',
+        path: 'file.ts',
+    });
+    t.is(result, 'search_replace "old" → "new" file.ts');
+});
+test('formatToolCommand: search_replace with missing args', t => {
+    const result = formatToolCommand('search_replace', {});
+    t.is(result, 'search_replace "" → "" ');
+});
+test('formatToolCommand: apply_patch with type and path', t => {
+    const result = formatToolCommand('apply_patch', {
+        type: 'create',
+        path: 'newfile.ts',
+    });
+    t.is(result, 'apply_patch create newfile.ts');
+});
+test('formatToolCommand: apply_patch with missing args', t => {
+    const result = formatToolCommand('apply_patch', {});
+    t.is(result, 'apply_patch unknown ');
+});
+test('formatToolCommand: ask_mentor with question', t => {
+    const result = formatToolCommand('ask_mentor', {
+        question: 'How do I refactor this?',
+    });
+    t.is(result, 'ask_mentor: How do I refactor this?');
+});
+test('formatToolCommand: ask_mentor with empty question', t => {
+    const result = formatToolCommand('ask_mentor', {});
+    t.is(result, 'ask_mentor: ');
+});
+test('formatToolCommand: unknown tool returns tool name', t => {
+    const result = formatToolCommand('custom_tool', { foo: 'bar' });
+    t.is(result, 'custom_tool');
+});
+test('formatToolCommand: handles null/undefined args', t => {
+    const result = formatToolCommand('shell', null);
+    t.is(result, 'shell');
+});
+// =============================================================================
+// createStreamingState tests
+// =============================================================================
+test('createStreamingState: returns correct initial values', t => {
+    const state = createStreamingState();
+    t.is(state.accumulatedText, '');
+    t.is(state.accumulatedReasoningText, '');
+    t.is(state.flushedReasoningLength, 0);
+    t.is(state.textWasFlushed, false);
+    t.is(state.currentReasoningMessageId, null);
+});
+test('createStreamingState: returns new object each call', t => {
+    const state1 = createStreamingState();
+    const state2 = createStreamingState();
+    t.not(state1, state2);
+});
+// =============================================================================
+// enhanceApiKeyError tests
+// =============================================================================
+test('enhanceApiKeyError: enhances OPENAI_API_KEY message', t => {
+    const result = enhanceApiKeyError('Missing OPENAI_API_KEY');
+    t.true(result.includes('OpenAI API key is not configured'));
+    t.true(result.includes('platform.openai.com/api-keys'));
+});
+test('enhanceApiKeyError: enhances 401 unauthorized message', t => {
+    const result = enhanceApiKeyError('Error 401: Unauthorized access');
+    t.true(result.includes('OpenAI API key is not configured'));
+});
+test('enhanceApiKeyError: passes through other errors', t => {
+    const result = enhanceApiKeyError('Network timeout');
+    t.is(result, 'Network timeout');
+});
+test('enhanceApiKeyError: handles empty string', t => {
+    const result = enhanceApiKeyError('');
+    t.is(result, '');
+});
+// =============================================================================
+// isMaxTurnsError tests
+// =============================================================================
+test('isMaxTurnsError: returns true for max turns exceeded', t => {
+    t.true(isMaxTurnsError('Max turns (10) exceeded'));
+});
+test('isMaxTurnsError: returns false for partial match - only Max turns', t => {
+    t.false(isMaxTurnsError('Max turns reached'));
+});
+test('isMaxTurnsError: returns false for partial match - only exceeded', t => {
+    t.false(isMaxTurnsError('Rate limit exceeded'));
+});
+test('isMaxTurnsError: returns false for unrelated message', t => {
+    t.false(isMaxTurnsError('Something went wrong'));
+});
+test('isMaxTurnsError: returns false for empty string', t => {
+    t.false(isMaxTurnsError(''));
+});
+// =============================================================================
+// createShellMessageOutput tests
+// =============================================================================
+test('createShellMessageOutput: stdout only', t => {
+    const result = createShellMessageOutput(0, 'hello world', '');
+    t.is(result, 'hello world\n\nReturn code: 0');
+});
+test('createShellMessageOutput: stderr only', t => {
+    const result = createShellMessageOutput(1, '', 'error occurred');
+    t.is(result, 'error occurred\n\nReturn code: 1');
+});
+test('createShellMessageOutput: both stdout and stderr', t => {
+    const result = createShellMessageOutput(0, 'output', 'warning');
+    t.is(result, 'output\nwarning\n\nReturn code: 0');
+});
+test('createShellMessageOutput: null return code', t => {
+    const result = createShellMessageOutput(null, 'output', '');
+    t.is(result, 'output');
+});
+test('createShellMessageOutput: empty output with return code', t => {
+    const result = createShellMessageOutput(0, '', '');
+    t.is(result, '\n\nReturn code: 0');
+});
+test('createShellMessageOutput: trims trailing newlines from stdout', t => {
+    const result = createShellMessageOutput(0, 'hello\n\n', '');
+    t.is(result, 'hello\n\nReturn code: 0');
+});
+//# sourceMappingURL=conversation-utils.test.js.map