feat: enhance API client robustness with improved error handling (#55)

## Summary
This PR significantly enhances the robustness and reliability of the
RoboSystems API client by implementing comprehensive error handling
improvements and safer URL parameter handling across all API endpoints.

## Key Accomplishments
- **Enhanced Error Handling**: Improved HTTP response error handling in
the QueryClient to provide better error messages and more graceful
failure modes
- **Safer URL Parameter Handling**: Updated URL formatting across all
API calls to use proper quoting mechanisms, preventing issues with
special characters and improving security
- **Comprehensive Coverage**: Applied improvements consistently across
80 API endpoint files covering all major service areas:
- Agent operations (auto-select, batch processing, execution, metadata)
  - Backup and restore functionality
  - Billing and subscription management
  - Connection management and OAuth flows
  - Credits and storage monitoring
  - File operations
  - Graph health, info, and limits
  - Materialization processes
  - MCP tool integration
  - Operations management
  - Organization and member management
  - Query execution
  - Schema operations
  - Subgraph management
  - Subscription handling
  - Table operations
  - Usage analytics
  - User management
  - View operations

## Breaking Changes
None. These changes are backward-compatible and only enhance the
existing functionality without modifying public APIs.

## Testing Notes
- All existing API functionality should continue to work as expected
- Error responses should now provide more informative messages
- URLs with special characters in parameters should be handled more
reliably
- Test cases involving malformed parameters or edge cases should show
improved behavior

## Infrastructure Considerations
- The QueryClient improvements may change the format of error messages,
which could affect logging and monitoring
- URL encoding changes ensure better compliance with HTTP standards and
may resolve issues with certain parameter values
- These changes improve the overall stability and security posture of
API communications

---
🤖 Generated with [Claude Code](https://claude.ai/code)

**Branch Info:**
- Source: `feature/more-robust-gen`
- Target: `main`
- Type: feature

Co-Authored-By: Claude <noreply@anthropic.com>

Author: jfrench9

robosystems_client/api/agent/auto_select_agent.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any, cast
+from urllib.parse import quote
 
 import httpx
 
@@ -36,7 +37,9 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "post",
-    "url": f"/v1/graphs/{graph_id}/agent",
+    "url": "/v1/graphs/{graph_id}/agent".format(
+      graph_id=quote(str(graph_id), safe=""),
+    ),
     "params": params,
   }
 

robosystems_client/api/agent/batch_process_queries.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any, cast
+from urllib.parse import quote
 
 import httpx
 
@@ -20,7 +21,9 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "post",
-    "url": f"/v1/graphs/{graph_id}/agent/batch",
+    "url": "/v1/graphs/{graph_id}/agent/batch".format(
+      graph_id=quote(str(graph_id), safe=""),
+    ),
   }
 
   _kwargs["json"] = body.to_dict()

robosystems_client/api/agent/execute_specific_agent.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any, cast
+from urllib.parse import quote
 
 import httpx
 
@@ -37,7 +38,10 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "post",
-    "url": f"/v1/graphs/{graph_id}/agent/{agent_type}",
+    "url": "/v1/graphs/{graph_id}/agent/{agent_type}".format(
+      graph_id=quote(str(graph_id), safe=""),
+      agent_type=quote(str(agent_type), safe=""),
+    ),
     "params": params,
   }
 

robosystems_client/api/agent/get_agent_metadata.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any, cast
+from urllib.parse import quote
 
 import httpx
 
@@ -16,7 +17,10 @@ def _get_kwargs(
 ) -> dict[str, Any]:
   _kwargs: dict[str, Any] = {
     "method": "get",
-    "url": f"/v1/graphs/{graph_id}/agent/{agent_type}",
+    "url": "/v1/graphs/{graph_id}/agent/{agent_type}".format(
+      graph_id=quote(str(graph_id), safe=""),
+      agent_type=quote(str(agent_type), safe=""),
+    ),
   }
 
   return _kwargs

robosystems_client/api/agent/list_agents.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any, cast
+from urllib.parse import quote
 
 import httpx
 
@@ -28,7 +29,9 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "get",
-    "url": f"/v1/graphs/{graph_id}/agent",
+    "url": "/v1/graphs/{graph_id}/agent".format(
+      graph_id=quote(str(graph_id), safe=""),
+    ),
     "params": params,
   }
 

robosystems_client/api/agent/recommend_agent.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any, cast
+from urllib.parse import quote
 
 import httpx
 
@@ -20,7 +21,9 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "post",
-    "url": f"/v1/graphs/{graph_id}/agent/recommend",
+    "url": "/v1/graphs/{graph_id}/agent/recommend".format(
+      graph_id=quote(str(graph_id), safe=""),
+    ),
   }
 
   _kwargs["json"] = body.to_dict()

robosystems_client/api/backup/create_backup.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any
+from urllib.parse import quote
 
 import httpx
 
@@ -20,7 +21,9 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "post",
-    "url": f"/v1/graphs/{graph_id}/backups",
+    "url": "/v1/graphs/{graph_id}/backups".format(
+      graph_id=quote(str(graph_id), safe=""),
+    ),
   }
 
   _kwargs["json"] = body.to_dict()

robosystems_client/api/backup/get_backup_download_url.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any, cast
+from urllib.parse import quote
 
 import httpx
 
@@ -24,7 +25,10 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "get",
-    "url": f"/v1/graphs/{graph_id}/backups/{backup_id}/download",
+    "url": "/v1/graphs/{graph_id}/backups/{backup_id}/download".format(
+      graph_id=quote(str(graph_id), safe=""),
+      backup_id=quote(str(backup_id), safe=""),
+    ),
     "params": params,
   }
 

robosystems_client/api/backup/get_backup_stats.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any
+from urllib.parse import quote
 
 import httpx
 
@@ -15,7 +16,9 @@ def _get_kwargs(
 ) -> dict[str, Any]:
   _kwargs: dict[str, Any] = {
     "method": "get",
-    "url": f"/v1/graphs/{graph_id}/backups/stats",
+    "url": "/v1/graphs/{graph_id}/backups/stats".format(
+      graph_id=quote(str(graph_id), safe=""),
+    ),
   }
 
   return _kwargs

robosystems_client/api/backup/list_backups.py

@@ -1,5 +1,6 @@
 from http import HTTPStatus
 from typing import Any
+from urllib.parse import quote
 
 import httpx
 
@@ -26,7 +27,9 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "get",
-    "url": f"/v1/graphs/{graph_id}/backups",
+    "url": "/v1/graphs/{graph_id}/backups".format(
+      graph_id=quote(str(graph_id), safe=""),
+    ),
     "params": params,
   }