René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Introduce typed error classes with metadata","articleBody":"## Summary\n\nReplace generic exceptions with SDK-native error classes that include useful metadata like fault attribution, retryability, and HTTP details.\n\n## Problem\n\nThe SDK currently raises generic exceptions from various layers (httpx, anyio, task groups) with no context about:\n- Whether the error is retryable\n- Who is at fault (client, server, network, protocol violation)\n- HTTP status codes and response bodies (often discarded)\n\nThis makes it hard for users to build robust error handling.\n\n## Goal\n\nA hierarchy of typed errors like:\n- `McpError` (base) with `fault`, `is_retryable`, `http_status_code`, `response_body`\n- `McpTransportError` for connection/network issues\n- `McpProtocolError` for invalid JSON-RPC responses\n- `McpAuthError` for 401/403 responses\n\n---\n\n\u003csub\u003e[AI Disclaimer](https://gist.github.com/maxisbey/6123d132484e4c533eab519a2800693d)\u003c/sub\u003e","author":{"url":"https://github.com/maxisbey","@type":"Person","name":"maxisbey"},"datePublished":"2025-12-05T17:02:41.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/1742/python-sdk/issues/1742"}