@gguf/coder 0.3.1 → 0.3.2

package/source/ai-sdk-client/converters/message-converter.ts

@@ -1,113 +0,0 @@
-import type {Message} from '@/types/index';
-import type {AssistantContent, ModelMessage, TextPart, ToolCallPart} from 'ai';
-import type {TestableMessage} from '../types.js';
-
-/**
- * Checks if an assistant message is empty (no content and no tool calls).
- * Empty assistant messages cause API errors:
- * "400 Bad Request: Assistant message must have either content or tool_calls, but not none."
- *
- * Exported for testing purposes.
- */
-export function isEmptyAssistantMessage(message: TestableMessage): boolean {
-	if (message.role !== 'assistant') {
-		return false;
-	}
-	// Check for content - handle both string and array content formats
-	const hasContent = Array.isArray(message.content)
-		? message.content.length > 0
-		: typeof message.content === 'string' && message.content.trim().length > 0;
-	// Tool calls are in a separate property for AI SDK messages
-	const hasToolCalls =
-		'toolCalls' in message &&
-		Array.isArray(message.toolCalls) &&
-		message.toolCalls.length > 0;
-	return !hasContent && !hasToolCalls;
-}
-
-/**
- * Convert our Message format to AI SDK v6 ModelMessage format
- *
- * Tool messages: Converted to AI SDK tool-result format with proper structure.
- */
-export function convertToModelMessages(messages: Message[]): ModelMessage[] {
-	return messages.map((msg): ModelMessage => {
-		if (msg.role === 'tool') {
-			// Convert to AI SDK tool-result format
-			// AI SDK expects: { role: 'tool', content: [{ type: 'tool-result', toolCallId, toolName, output }] }
-			// where output is { type: 'text', value: string } or { type: 'json', value: JSONValue }
-			return {
-				role: 'tool',
-				content: [
-					{
-						type: 'tool-result',
-						toolCallId: msg.tool_call_id || '',
-						toolName: msg.name || '',
-						output: {
-							type: 'text',
-							value: msg.content,
-						},
-					},
-				],
-			};
-		}
-
-		if (msg.role === 'system') {
-			return {
-				role: 'system',
-				content: msg.content,
-			};
-		}
-
-		if (msg.role === 'user') {
-			return {
-				role: 'user',
-				content: msg.content,
-			};
-		}
-
-		if (msg.role === 'assistant') {
-			// Build content array
-			const content: AssistantContent = [];
-
-			// Add text content if present
-			if (msg.content) {
-				content.push({
-					type: 'text',
-					text: msg.content,
-				} as TextPart);
-			}
-
-			// Add tool calls if present (for auto-executed messages)
-			if (msg.tool_calls && msg.tool_calls.length > 0) {
-				for (const toolCall of msg.tool_calls) {
-					content.push({
-						type: 'tool-call',
-						toolCallId: toolCall.id,
-						toolName: toolCall.function.name,
-						input: toolCall.function.arguments,
-					} as ToolCallPart);
-				}
-			}
-
-			// If no content at all, add empty text to avoid empty message
-			if (content.length === 0) {
-				content.push({
-					type: 'text',
-					text: '',
-				} as TextPart);
-			}
-
-			return {
-				role: 'assistant',
-				content,
-			};
-		}
-
-		// Fallback - should never happen
-		return {
-			role: 'user',
-			content: msg.content,
-		};
-	});
-}

package/source/ai-sdk-client/converters/tool-converter.spec.ts

@@ -1,90 +0,0 @@
-import test from 'ava';
-import {
-	convertAISDKToolCall,
-	convertAISDKToolCalls,
-	generateToolCallId,
-	getToolResultOutput,
-} from './tool-converter.js';
-
-test('generateToolCallId creates unique IDs', t => {
-	const id1 = generateToolCallId();
-	const id2 = generateToolCallId();
-
-	t.true(id1.startsWith('tool_'));
-	t.true(id2.startsWith('tool_'));
-	t.not(id1, id2);
-});
-
-test('convertAISDKToolCall uses provided toolCallId', t => {
-	const aiToolCall = {
-		toolCallId: 'call_123',
-		toolName: 'test_tool',
-		input: {arg: 'value'},
-	};
-
-	const result = convertAISDKToolCall(aiToolCall);
-
-	t.is(result.id, 'call_123');
-	t.is(result.function.name, 'test_tool');
-	t.deepEqual(result.function.arguments, {arg: 'value'});
-});
-
-test('convertAISDKToolCall generates ID when missing', t => {
-	const aiToolCall = {
-		toolName: 'test_tool',
-		input: {arg: 'value'},
-	};
-
-	const result = convertAISDKToolCall(aiToolCall);
-
-	t.true(result.id.startsWith('tool_'));
-	t.is(result.function.name, 'test_tool');
-	t.deepEqual(result.function.arguments, {arg: 'value'});
-});
-
-test('convertAISDKToolCalls converts multiple tool calls', t => {
-	const aiToolCalls = [
-		{
-			toolCallId: 'call_1',
-			toolName: 'tool_1',
-			input: {a: 1},
-		},
-		{
-			toolName: 'tool_2',
-			input: {b: 2},
-		},
-	];
-
-	const result = convertAISDKToolCalls(aiToolCalls);
-
-	t.is(result.length, 2);
-	t.is(result[0].id, 'call_1');
-	t.is(result[0].function.name, 'tool_1');
-	t.true(result[1].id.startsWith('tool_'));
-	t.is(result[1].function.name, 'tool_2');
-});
-
-test('convertAISDKToolCalls handles empty array', t => {
-	const result = convertAISDKToolCalls([]);
-	t.deepEqual(result, []);
-});
-
-test('getToolResultOutput returns string as-is', t => {
-	const result = getToolResultOutput('test output');
-	t.is(result, 'test output');
-});
-
-test('getToolResultOutput converts object to JSON string', t => {
-	const result = getToolResultOutput({key: 'value'});
-	t.is(result, '{"key":"value"}');
-});
-
-test('getToolResultOutput converts array to JSON string', t => {
-	const result = getToolResultOutput([1, 2, 3]);
-	t.is(result, '[1,2,3]');
-});
-
-test('getToolResultOutput converts number to JSON string', t => {
-	const result = getToolResultOutput(42);
-	t.is(result, '42');
-});

package/source/ai-sdk-client/converters/tool-converter.ts

@@ -1,46 +0,0 @@
-import {randomBytes} from 'node:crypto';
-import type {ToolCall} from '@/types/index';
-
-/**
- * Generates a unique tool call ID
- */
-export function generateToolCallId(): string {
-	return `tool_${Date.now()}_${randomBytes(8).toString('hex')}`;
-}
-
-/**
- * Converts AI SDK tool call format to our ToolCall format
- */
-export function convertAISDKToolCall(toolCall: {
-	toolCallId?: string;
-	toolName: string;
-	input: unknown;
-}): ToolCall {
-	return {
-		id: toolCall.toolCallId || generateToolCallId(),
-		function: {
-			name: toolCall.toolName,
-			arguments: toolCall.input as Record<string, unknown>,
-		},
-	};
-}
-
-/**
- * Converts multiple AI SDK tool calls to our ToolCall format
- */
-export function convertAISDKToolCalls(
-	toolCalls: Array<{
-		toolCallId?: string;
-		toolName: string;
-		input: unknown;
-	}>,
-): ToolCall[] {
-	return toolCalls.map(convertAISDKToolCall);
-}
-
-/**
- * Gets the tool result output as a string
- */
-export function getToolResultOutput(output: unknown): string {
-	return typeof output === 'string' ? output : JSON.stringify(output);
-}

package/source/ai-sdk-client/error-handling/error-extractor.spec.ts

@@ -1,55 +0,0 @@
-import test from 'ava';
-import {RetryError} from 'ai';
-import {extractRootError} from './error-extractor.js';
-
-test('extractRootError returns error unchanged if not a RetryError', t => {
-	const error = new Error('Test error');
-	const result = extractRootError(error);
-	t.is(result, error);
-});
-
-test('extractRootError extracts lastError from RetryError', t => {
-	const rootError = new Error('Root cause');
-	const retryError = new RetryError({
-		message: 'Retry failed',
-		reason: 'maxRetriesExceeded',
-		errors: [rootError],
-	});
-
-	const result = extractRootError(retryError);
-	t.is(result, rootError);
-});
-
-test('extractRootError handles nested RetryErrors', t => {
-	const rootError = new Error('Root cause');
-	const innerRetryError = new RetryError({
-		message: 'Inner retry failed',
-		reason: 'maxRetriesExceeded',
-		errors: [rootError],
-	});
-	const outerRetryError = new RetryError({
-		message: 'Outer retry failed',
-		reason: 'maxRetriesExceeded',
-		errors: [innerRetryError],
-	});
-
-	const result = extractRootError(outerRetryError);
-	t.is(result, rootError);
-});
-
-test('extractRootError handles RetryError with no lastError', t => {
-	const retryError = new RetryError({
-		message: 'Retry failed',
-		reason: 'maxRetriesExceeded',
-		errors: [],
-	});
-
-	const result = extractRootError(retryError);
-	t.is(result, retryError);
-});
-
-test('extractRootError handles non-Error values', t => {
-	const nonError = 'string error';
-	const result = extractRootError(nonError);
-	t.is(result, nonError);
-});

package/source/ai-sdk-client/error-handling/error-extractor.ts

@@ -1,15 +0,0 @@
-import {RetryError} from 'ai';
-
-/**
- * Extracts the root cause error from AI SDK error wrappers.
- * AI SDK wraps errors in RetryError which contains lastError.
- */
-export function extractRootError(error: unknown): unknown {
-	// Handle AI SDK RetryError - extract the last error
-	if (RetryError.isInstance(error)) {
-		if (error.lastError) {
-			return extractRootError(error.lastError);
-		}
-	}
-	return error;
-}

package/source/ai-sdk-client/error-handling/error-parser.spec.ts

@@ -1,169 +0,0 @@
-import test from 'ava';
-import {APICallError} from 'ai';
-import {parseAPIError} from './error-parser.js';
-
-test('parseAPIError handles non-Error values', t => {
-	const result = parseAPIError('not an error');
-	t.is(result, 'An unknown error occurred while communicating with the model');
-});
-
-test('parseAPIError handles APICallError with 400 status', t => {
-	const error = new APICallError({
-		message: 'Invalid request',
-		url: 'https://api.example.com',
-		requestBodyValues: {},
-		statusCode: 400,
-		responseBody: JSON.stringify({error: {message: 'Bad input'}}),
-		responseHeaders: {},
-		isRetryable: false,
-	});
-
-	const result = parseAPIError(error);
-	t.is(result, 'Bad request: Bad input');
-});
-
-test('parseAPIError handles APICallError with 401 status', t => {
-	const error = new APICallError({
-		message: 'Unauthorized',
-		url: 'https://api.example.com',
-		requestBodyValues: {},
-		statusCode: 401,
-		responseBody: '{}',
-		responseHeaders: {},
-		isRetryable: false,
-	});
-
-	const result = parseAPIError(error);
-	t.is(result, 'Authentication failed: Invalid API key or credentials');
-});
-
-test('parseAPIError handles APICallError with 404 status', t => {
-	const error = new APICallError({
-		message: 'Not found',
-		url: 'https://api.example.com',
-		requestBodyValues: {},
-		statusCode: 404,
-		responseBody: '{}',
-		responseHeaders: {},
-		isRetryable: false,
-	});
-
-	const result = parseAPIError(error);
-	t.is(
-		result,
-		'Model not found: The requested model may not exist or is unavailable',
-	);
-});
-
-test('parseAPIError handles APICallError with 429 status and quota message', t => {
-	const error = new APICallError({
-		message: 'Rate limited',
-		url: 'https://api.example.com',
-		requestBodyValues: {},
-		statusCode: 429,
-		responseBody: JSON.stringify({
-			error: {message: 'You have exceeded your usage limit'},
-		}),
-		responseHeaders: {},
-		isRetryable: true,
-	});
-
-	const result = parseAPIError(error);
-	t.is(result, 'Rate limit: You have exceeded your usage limit');
-});
-
-test('parseAPIError handles APICallError with 429 status without quota message', t => {
-	const error = new APICallError({
-		message: 'Rate limited',
-		url: 'https://api.example.com',
-		requestBodyValues: {},
-		statusCode: 429,
-		responseBody: '{}',
-		responseHeaders: {},
-		isRetryable: true,
-	});
-
-	const result = parseAPIError(error);
-	t.is(
-		result,
-		'Rate limit exceeded: Too many requests. Please wait and try again',
-	);
-});
-
-test('parseAPIError handles APICallError with 500 status', t => {
-	const error = new APICallError({
-		message: 'Server error',
-		url: 'https://api.example.com',
-		requestBodyValues: {},
-		statusCode: 500,
-		responseBody: JSON.stringify({message: 'Internal server error'}),
-		responseHeaders: {},
-		isRetryable: true,
-	});
-
-	const result = parseAPIError(error);
-	t.is(result, 'Server error: Internal server error');
-});
-
-test('parseAPIError handles Error with status code in message', t => {
-	const error = new Error('400 Bad Request: Invalid parameters');
-	const result = parseAPIError(error);
-	t.is(result, 'Bad request: Invalid parameters');
-});
-
-test('parseAPIError handles Ollama unmarshal errors', t => {
-	const error = new Error(
-		'invalid character after top-level value: unmarshal error',
-	);
-	const result = parseAPIError(error);
-	t.true(result.includes('Ollama server error'));
-	t.true(result.includes('malformed JSON'));
-});
-
-test('parseAPIError handles timeout errors', t => {
-	const error = new Error('Request timeout: ETIMEDOUT');
-	const result = parseAPIError(error);
-	t.is(result, 'Request timed out: The model took too long to respond');
-});
-
-test('parseAPIError handles connection errors', t => {
-	const error = new Error('ECONNREFUSED: connection refused');
-	const result = parseAPIError(error);
-	t.is(result, 'Connection failed: Unable to reach the model server');
-});
-
-test('parseAPIError handles context length errors', t => {
-	const error = new Error('context length exceeded');
-	const result = parseAPIError(error);
-	t.is(
-		result,
-		'Context too large: Please reduce the conversation length or message size',
-	);
-});
-
-test('parseAPIError handles token limit errors', t => {
-	const error = new Error('Please reduce the number of tokens in your message');
-	const result = parseAPIError(error);
-	t.is(
-		result,
-		'Too many tokens: Please shorten your message or clear conversation history',
-	);
-});
-
-test('parseAPIError handles generic errors', t => {
-	const error = new Error('Something went wrong');
-	const result = parseAPIError(error);
-	t.is(result, 'Something went wrong');
-});
-
-test('parseAPIError removes "Error:" prefix from generic errors', t => {
-	const error = new Error('Error: Something went wrong');
-	const result = parseAPIError(error);
-	t.is(result, 'Something went wrong');
-});
-
-test('parseAPIError extracts first line from multiline errors', t => {
-	const error = new Error('First line\nSecond line\nThird line');
-	const result = parseAPIError(error);
-	t.is(result, 'First line');
-});

package/source/ai-sdk-client/error-handling/error-parser.ts

@@ -1,161 +0,0 @@
-import {APICallError} from 'ai';
-import {extractRootError} from './error-extractor.js';
-
-/**
- * Parses API errors into user-friendly messages.
- * Exported for testing purposes.
- */
-export function parseAPIError(error: unknown): string {
-	// First extract the root error from any wrappers
-	const rootError = extractRootError(error);
-
-	if (!(rootError instanceof Error)) {
-		return 'An unknown error occurred while communicating with the model';
-	}
-
-	// Handle AI SDK APICallError - it has statusCode and responseBody
-	if (APICallError.isInstance(rootError)) {
-		const statusCode = rootError.statusCode;
-		// Try to extract a clean message from responseBody or use the error message
-		let cleanMessage = rootError.message;
-
-		// Parse the response body if available for more details
-		if (rootError.responseBody) {
-			try {
-				const body = JSON.parse(rootError.responseBody) as {
-					error?: {message?: string};
-					message?: string;
-				};
-				if (body.error?.message) {
-					cleanMessage = body.error.message;
-				} else if (body.message) {
-					cleanMessage = body.message;
-				}
-			} catch {
-				// If not JSON, try to extract message from the raw response
-				const msgMatch = rootError.responseBody.match(
-					/["']?message["']?\s*[:=]\s*["']([^"']+)["']/i,
-				);
-				if (msgMatch) {
-					cleanMessage = msgMatch[1];
-				}
-			}
-		}
-
-		// Format based on status code
-		if (statusCode) {
-			switch (statusCode) {
-				case 400:
-					return `Bad request: ${cleanMessage}`;
-				case 401:
-					return 'Authentication failed: Invalid API key or credentials';
-				case 403:
-					return 'Access forbidden: Check your API permissions';
-				case 404:
-					return 'Model not found: The requested model may not exist or is unavailable';
-				case 429:
-					if (
-						cleanMessage.includes('usage limit') ||
-						cleanMessage.includes('quota')
-					) {
-						return `Rate limit: ${cleanMessage}`;
-					}
-					return 'Rate limit exceeded: Too many requests. Please wait and try again';
-				case 500:
-				case 502:
-				case 503:
-					return `Server error: ${cleanMessage}`;
-				default:
-					return `Request failed (${statusCode}): ${cleanMessage}`;
-			}
-		}
-	}
-
-	const errorMessage = rootError.message;
-
-	// Extract status code and clean message from common error patterns FIRST
-	// This ensures HTTP status codes are properly parsed before falling through
-	// to more generic pattern matching (like Ollama-specific errors)
-	const statusMatch = errorMessage.match(
-		/(?:Error: )?(\d{3})\s+(?:\d{3}\s+)?(?:Bad Request|[^:]+):\s*(.+)/i,
-	);
-	if (statusMatch) {
-		const [, statusCode, message] = statusMatch;
-		const cleanMessage = message.trim();
-
-		switch (statusCode) {
-			case '400':
-				return `Bad request: ${cleanMessage}`;
-			case '401':
-				return 'Authentication failed: Invalid API key or credentials';
-			case '403':
-				return 'Access forbidden: Check your API permissions';
-			case '404':
-				return 'Model not found: The requested model may not exist or is unavailable';
-			case '429':
-				// Include the original message if it has useful details
-				if (
-					cleanMessage.includes('usage limit') ||
-					cleanMessage.includes('quota')
-				) {
-					return `Rate limit: ${cleanMessage}`;
-				}
-				return 'Rate limit exceeded: Too many requests. Please wait and try again';
-			case '500':
-			case '502':
-			case '503':
-				return `Server error: ${cleanMessage}`;
-			default:
-				return `Request failed (${statusCode}): ${cleanMessage}`;
-		}
-	}
-
-	// Handle Ollama-specific unmarshal/JSON parsing errors
-	// This runs AFTER status code parsing to avoid misclassifying HTTP errors
-	// that happen to contain JSON parsing error text in their message
-	if (
-		errorMessage.includes('unmarshal') ||
-		(errorMessage.includes('invalid character') &&
-			errorMessage.includes('after top-level value'))
-	) {
-		return (
-			'Ollama server error: The model returned malformed JSON. ' +
-			'This usually indicates an issue with the Ollama server or model. ' +
-			'Try:\n' +
-			'  1. Restart Ollama: systemctl restart ollama (Linux) or restart the Ollama app\n' +
-			'  2. Re-pull the model: ollama pull <model-name>\n' +
-			'  3. Check Ollama logs for more details\n' +
-			'  4. Try a different model to see if the issue is model-specific\n' +
-			`Original error: ${errorMessage}`
-		);
-	}
-
-	// Handle timeout errors
-	if (errorMessage.includes('timeout') || errorMessage.includes('ETIMEDOUT')) {
-		return 'Request timed out: The model took too long to respond';
-	}
-
-	// Handle network errors
-	if (
-		errorMessage.includes('ECONNREFUSED') ||
-		errorMessage.includes('connect')
-	) {
-		return 'Connection failed: Unable to reach the model server';
-	}
-
-	// Handle context length errors
-	if (
-		errorMessage.includes('context length') ||
-		errorMessage.includes('too many tokens')
-	) {
-		return 'Context too large: Please reduce the conversation length or message size';
-	}
-
-	// Handle token limit errors
-	if (errorMessage.includes('reduce the number of tokens')) {
-		return 'Too many tokens: Please shorten your message or clear conversation history';
-	}
-
-	// If we can't parse it, return a cleaned up version
-	return errorMessage.replace(/^Error:\s*/i, '').split('\n')[0];
-}

package/source/ai-sdk-client/index.ts

@@ -1,7 +0,0 @@
-// Main client export
-export {AISDKClient} from './AISDKClient.js';
-
-// Exported for testing purposes
-export {parseAPIError} from './error-handling/error-parser.js';
-export {isEmptyAssistantMessage} from './converters/message-converter.js';
-export type {TestableMessage} from './types.js';