Refactor extensions architecture: replace TableIngestClient with specialized clients (#37)

## Summary
This PR refactors the extensions module architecture by decomposing the
monolithic `TableIngestClient` into three specialized, focused clients:
`FileClient`, `MaterializationClient`, and `TableClient`. This change
improves code organization, maintainability, and follows the single
responsibility principle.

## Key Accomplishments
- **Architectural improvement**: Split single large client (~463 lines)
into three focused clients totaling ~750 lines with better separation of
concerns
- **New specialized clients**:
  - `FileClient`: Handles file operations and management
  - `MaterializationClient`: Manages data materialization processes  
  - `TableClient`: Focuses on table-specific operations
- **Updated module exports**: Modified `__init__.py` and `extensions.py`
to expose the new client architecture
- **Maintained functionality**: All existing capabilities preserved
through the new client structure

## Breaking Changes
⚠️ **Breaking Changes Present**
- `TableIngestClient` has been completely removed
- Import statements referencing `TableIngestClient` will need to be
updated to use the appropriate new client (`FileClient`,
`MaterializationClient`, or `TableClient`)
- Any code directly instantiating `TableIngestClient` will require
refactoring

## Testing Notes
- Updated existing extension tests to work with the new client
architecture
- Removed obsolete `TableIngestClient` tests (112 lines)
- Added new test coverage for the refactored extension structure (41
lines of test updates)
- All functionality should be preserved through the new clients

## Migration Impact
Teams using this library will need to:
1. Update import statements to use the new specialized clients
2. Review existing code for direct `TableIngestClient` usage
3. Refactor instantiation code to use appropriate specialized client(s)
4. Test integrations thoroughly due to the architectural changes

This refactoring provides a cleaner, more maintainable codebase while
preserving all existing functionality through better-organized,
purpose-built clients.

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

**Branch Info:**
- Source: `feature/extension-clients-refactor`
- Target: `main`
- Type: feature

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

Author: jfrench9

robosystems_client/extensions/__init__.py

@@ -28,12 +28,22 @@
   OperationProgress,
   OperationResult,
 )
-from .table_ingest_client import (
-  TableIngestClient,
-  UploadOptions,
-  IngestOptions,
-  UploadResult,
+from .file_client import (
+  FileClient,
+  FileUploadOptions,
+  FileUploadResult,
+  FileInfo,
+)
+from .materialization_client import (
+  MaterializationClient,
+  MaterializationOptions,
+  MaterializationResult,
+  MaterializationStatus,
+)
+from .table_client import (
+  TableClient,
   TableInfo,
+  QueryResult as TableQueryResult,
 )
 from .graph_client import (
   GraphClient,
@@ -177,12 +187,20 @@
   "OperationStatus",
   "OperationProgress",
   "OperationResult",
-  # Table Ingest Client
-  "TableIngestClient",
-  "UploadOptions",
-  "IngestOptions",
-  "UploadResult",
+  # File Client
+  "FileClient",
+  "FileUploadOptions",
+  "FileUploadResult",
+  "FileInfo",
+  # Materialization Client
+  "MaterializationClient",
+  "MaterializationOptions",
+  "MaterializationResult",
+  "MaterializationStatus",
+  # Table Client
+  "TableClient",
   "TableInfo",
+  "TableQueryResult",
   # Graph Client
   "GraphClient",
   "GraphMetadata",

robosystems_client/extensions/extensions.py

@@ -9,7 +9,9 @@
 from .query_client import QueryClient
 from .agent_client import AgentClient
 from .operation_client import OperationClient
-from .table_ingest_client import TableIngestClient
+from .file_client import FileClient
+from .materialization_client import MaterializationClient
+from .table_client import TableClient
 from .graph_client import GraphClient
 from .sse_client import SSEClient
 
@@ -61,7 +63,9 @@ def __init__(self, config: RoboSystemsExtensionConfig = None):
     self.query = QueryClient(self.config)
     self.agent = AgentClient(self.config)
     self.operations = OperationClient(self.config)
-    self.tables = TableIngestClient(self.config)
+    self.files = FileClient(self.config)
+    self.materialization = MaterializationClient(self.config)
+    self.tables = TableClient(self.config)
     self.graphs = GraphClient(self.config)
 
   def monitor_operation(
@@ -92,7 +96,12 @@ def close(self):
     self.query.close()
     self.agent.close()
     self.operations.close_all()
-    self.tables.close()
+    if hasattr(self.files, "close"):
+      self.files.close()
+    if hasattr(self.materialization, "close"):
+      self.materialization.close()
+    if hasattr(self.tables, "close"):
+      self.tables.close()
     self.graphs.close()
 
   # Convenience methods that delegate to the appropriate clients