repi
c5a1b800fc
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-Claude) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
61 lines
2.2 KiB
TypeScript
61 lines
2.2 KiB
TypeScript
import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
|
|
|
|
export type ErrorClassification =
|
|
| 'auth_error'
|
|
| 'timeout'
|
|
| 'not_found'
|
|
| 'connection_error'
|
|
| 'x3_error'
|
|
| 'unknown';
|
|
|
|
export function formatToolError(error: unknown, hint?: string): CallToolResult {
|
|
const message = error instanceof Error ? error.message : String(error);
|
|
const parts = [`Error: ${message}`];
|
|
if (hint) {
|
|
parts.push(`\nHint: ${hint}`);
|
|
}
|
|
return {
|
|
isError: true as const,
|
|
content: [{ type: 'text' as const, text: parts.join('') }],
|
|
};
|
|
}
|
|
|
|
export function classifyError(error: unknown): ErrorClassification {
|
|
if (!(error instanceof Error)) return 'unknown';
|
|
|
|
const msg = error.message.toLowerCase();
|
|
const statusMatch = msg.match(/status[:\s]*(\d{3})/);
|
|
const status = statusMatch ? parseInt(statusMatch[1], 10) : undefined;
|
|
|
|
if (status === 401 || status === 403 || msg.includes('unauthorized') || msg.includes('authentication')) {
|
|
return 'auth_error';
|
|
}
|
|
if (msg.includes('timeout') || msg.includes('etimedout') || msg.includes('econnaborted')) {
|
|
return 'timeout';
|
|
}
|
|
if (status === 404 || msg.includes('not found')) {
|
|
return 'not_found';
|
|
}
|
|
if (msg.includes('econnrefused') || msg.includes('enotfound') || msg.includes('connect')) {
|
|
return 'connection_error';
|
|
}
|
|
if (msg.includes('x3') || msg.includes('sage') || msg.includes('business')) {
|
|
return 'x3_error';
|
|
}
|
|
|
|
return 'unknown';
|
|
}
|
|
|
|
const ERROR_HINTS: Record<ErrorClassification, string> = {
|
|
auth_error: 'Check SAGE_X3_USER and SAGE_X3_PASSWORD. Ensure the web service user has API access.',
|
|
timeout: 'The X3 server is slow to respond. Try a simpler query or smaller count.',
|
|
not_found: 'Record not found. Verify the entity name and key. Use sage_list_entities to discover available entities.',
|
|
connection_error: 'Cannot connect to X3 server. Check SAGE_X3_URL and network connectivity.',
|
|
x3_error: 'X3 returned a business error. Check the error messages for details.',
|
|
unknown: 'An unexpected error occurred. Check server logs for details.',
|
|
};
|
|
|
|
export function getErrorHint(classification: ErrorClassification): string {
|
|
return ERROR_HINTS[classification];
|
|
}
|