@robosystems/client 0.2.23 → 0.2.25

package/sdk-extensions/README.md

@@ -1,6 +1,6 @@
 # RoboSystems Typescript Client Extensions
 
-🚀 **Enhanced SSE and Real-time Features** for the RoboSystems Typescript Client
+**Enhanced SSE and Real-time Features** for the RoboSystems Typescript Client
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -17,7 +17,7 @@ The RoboSystems Typescript Client Extensions provide production-ready enhancemen
 - **React Hooks** for seamless UI integration
 - **Full TypeScript Support** with comprehensive type definitions
 
-## 🚀 Quick Start
+## Quick Start
 
 ### Installation
 
@@ -137,7 +137,7 @@ if (result.success) {
 }
 ```
 
-## 📊 SSE Event Types
+## SSE Event Types
 
 The SDK supports all RoboSystems SSE event types:
 
@@ -162,7 +162,7 @@ enum EventType {
 }
 ```
 
-## 🔄 Advanced SSE Features
+## Advanced SSE Features
 
 ### Automatic Reconnection
 
@@ -227,7 +227,7 @@ try {
 }
 ```
 
-## 📤 Table Ingestion
+## Table Ingestion
 
 ### TableIngestClient for Parquet File Uploads
 
@@ -250,9 +250,9 @@ const result = await tableClient.uploadParquetFile('graph-id', 'Entity', Buffer.
 })
 
 if (result.success) {
-  console.log(`✅ Uploaded ${result.rowCount} rows to ${result.tableName}`)
+  console.log(`Uploaded ${result.rowCount} rows to ${result.tableName}`)
 } else {
-  console.error(`❌ Upload failed: ${result.error}`)
+  console.error(`Upload failed: ${result.error}`)
 }
 ```
 
@@ -331,7 +331,7 @@ if (result.success) {
 }
 ```
 
-## 🎯 Operation Monitoring
+## Operation Monitoring
 
 ### OperationClient for Long-Running Tasks
 
@@ -420,7 +420,7 @@ await operationClient.monitor('operation-id', {
 })
 ```
 
-## ⚛️ React Integration
+## React Integration
 
 ### useSSE Hook
 
@@ -569,7 +569,7 @@ function DataImporter({ graphId }: { graphId: string }) {
 
       {result && result.status === 'completed' && (
         <div style={{ color: 'green' }}>
-          <p>✅ Successfully imported {result.rowsImported} rows</p>
+          <p>Successfully imported {result.rowsImported} rows</p>
           <p>Execution time: {(result.executionTimeMs / 1000).toFixed(2)}s</p>
         </div>
       )}
@@ -578,7 +578,7 @@ function DataImporter({ graphId }: { graphId: string }) {
 }
 ```
 
-## 🛡️ Error Handling & Resilience
+## Error Handling & Resilience
 
 ### Circuit Breaker Pattern
 
@@ -649,7 +649,7 @@ sseClient.on('connection_recycled', ({ old, new }) => {
 })
 ```
 
-## 🔧 Configuration
+## Configuration
 
 ### Environment Variables
 
@@ -713,7 +713,7 @@ const result = await extensions.files.upload('graph-id', 'TableName', fileBuffer
 })
 ```
 
-## 📊 Performance Optimization
+## Performance Optimization
 
 ### Stream Processing for Large Datasets
 
@@ -761,7 +761,7 @@ cachedClient.on('cache_invalidated', (query) => {
 })
 ```
 
-## 🧪 Testing
+## Testing
 
 ### Mock SSE for Testing
 
@@ -796,7 +796,7 @@ describe('SSE Integration', () => {
 })
 ```
 
-## 📚 API Reference
+## API Reference
 
 ### Core Classes
 
@@ -826,7 +826,7 @@ describe('SSE Integration', () => {
 - **`formatDuration`** - Human-readable duration formatting
 - **`parseSSEEvent`** - SSE event parsing utility
 
-## 🐛 Troubleshooting
+## Troubleshooting
 
 ### Common Issues
 
@@ -882,15 +882,15 @@ sseClient.on('*', (event, data) => {
 })
 ```
 
-## 📄 License
+## License
 
 MIT License - see [LICENSE](../../LICENSE) file for details.
 
-## 🤝 Contributing
+## Contributing
 
 See the [Contributing Guide](../../CONTRIBUTING.md) for development setup and guidelines.
 
-## 📞 Support
+## Support
 
 - **API Reference**: [api.robosystems.ai/docs](https://api.robosystems.ai/docs)
 - **Discord**: [Join our community](https://discord.gg/V9vjcqstxX)
@@ -899,5 +899,3 @@ See the [Contributing Guide](../../CONTRIBUTING.md) for development setup and gu
 ---
 
 **RoboSystems Typescript Client Extensions** - Production-ready SSE streaming and real-time monitoring for financial knowledge graphs.
-
-_Built with ❤️ by the RoboSystems team_

package/sdk.gen.d.ts

@@ -433,7 +433,7 @@ export declare const listAgents: <ThrowOnError extends boolean = false>(options:
  * **Execution Strategies (automatic):**
  * - Fast operations (<5s): Immediate synchronous response
  * - Medium operations (5-30s): SSE streaming with progress updates
- * - Long operations (>30s): Async Celery worker with operation tracking
+ * - Long operations (>30s): Background queue with operation tracking
  *
  * **Response Mode Override:**
  * Use query parameter `?mode=sync|async` to override automatic strategy selection.
@@ -494,7 +494,7 @@ export declare const getAgentMetadata: <ThrowOnError extends boolean = false>(op
  * **Execution Strategies (automatic):**
  * - Fast operations (<5s): Immediate synchronous response
  * - Medium operations (5-30s): SSE streaming with progress updates
- * - Long operations (>30s): Async Celery worker with operation tracking
+ * - Long operations (>30s): Background queue with operation tracking
  *
  * **Response Mode Override:**
  * Use query parameter `?mode=sync|async` to override automatic strategy selection.
@@ -1708,7 +1708,7 @@ export declare const getFile: <ThrowOnError extends boolean = false>(options: Op
  * **What Happens (status='uploaded'):**
  * 1. File validated in S3
  * 2. Row count calculated
- * 3. DuckDB staging triggered immediately (Celery task)
+ * 3. DuckDB staging triggered immediately (background task)
  * 4. If ingest_to_graph=true, graph ingestion queued
  * 5. File queryable in DuckDB within seconds
  *

package/sdk.gen.js

@@ -1079,7 +1079,7 @@ exports.listAgents = listAgents;
  * **Execution Strategies (automatic):**
  * - Fast operations (<5s): Immediate synchronous response
  * - Medium operations (5-30s): SSE streaming with progress updates
- * - Long operations (>30s): Async Celery worker with operation tracking
+ * - Long operations (>30s): Background queue with operation tracking
  *
  * **Response Mode Override:**
  * Use query parameter `?mode=sync|async` to override automatic strategy selection.
@@ -1176,7 +1176,7 @@ exports.getAgentMetadata = getAgentMetadata;
  * **Execution Strategies (automatic):**
  * - Fast operations (<5s): Immediate synchronous response
  * - Medium operations (5-30s): SSE streaming with progress updates
- * - Long operations (>30s): Async Celery worker with operation tracking
+ * - Long operations (>30s): Background queue with operation tracking
  *
  * **Response Mode Override:**
  * Use query parameter `?mode=sync|async` to override automatic strategy selection.
@@ -3130,7 +3130,7 @@ exports.getFile = getFile;
  * **What Happens (status='uploaded'):**
  * 1. File validated in S3
  * 2. Row count calculated
- * 3. DuckDB staging triggered immediately (Celery task)
+ * 3. DuckDB staging triggered immediately (background task)
  * 4. If ingest_to_graph=true, graph ingestion queued
  * 5. File queryable in DuckDB within seconds
  *

package/sdk.gen.ts

@@ -1092,7 +1092,7 @@ export const listAgents = <ThrowOnError extends boolean = false>(options: Option
  * **Execution Strategies (automatic):**
  * - Fast operations (<5s): Immediate synchronous response
  * - Medium operations (5-30s): SSE streaming with progress updates
- * - Long operations (>30s): Async Celery worker with operation tracking
+ * - Long operations (>30s): Background queue with operation tracking
  *
  * **Response Mode Override:**
  * Use query parameter `?mode=sync|async` to override automatic strategy selection.
@@ -1189,7 +1189,7 @@ export const getAgentMetadata = <ThrowOnError extends boolean = false>(options:
  * **Execution Strategies (automatic):**
  * - Fast operations (<5s): Immediate synchronous response
  * - Medium operations (5-30s): SSE streaming with progress updates
- * - Long operations (>30s): Async Celery worker with operation tracking
+ * - Long operations (>30s): Background queue with operation tracking
  *
  * **Response Mode Override:**
  * Use query parameter `?mode=sync|async` to override automatic strategy selection.
@@ -3143,7 +3143,7 @@ export const getFile = <ThrowOnError extends boolean = false>(options: Options<G
  * **What Happens (status='uploaded'):**
  * 1. File validated in S3
  * 2. Row count calculated
- * 3. DuckDB staging triggered immediately (Celery task)
+ * 3. DuckDB staging triggered immediately (background task)
  * 4. If ingest_to_graph=true, graph ingestion queued
  * 5. File queryable in DuckDB within seconds
  *

package/types.gen.d.ts

@@ -3018,43 +3018,24 @@ export type MaterializeRequest = {
 };
 /**
  * MaterializeResponse
+ * Response for queued materialization operation.
  */
 export type MaterializeResponse = {
     /**
      * Status
-     * Materialization status
+     * Operation status
      */
-    status: string;
+    status?: string;
     /**
      * Graph Id
      * Graph database identifier
      */
     graph_id: string;
     /**
-     * Was Stale
-     * Whether graph was stale before materialization
-     */
-    was_stale: boolean;
-    /**
-     * Stale Reason
-     * Reason graph was stale
-     */
-    stale_reason?: string | null;
-    /**
-     * Tables Materialized
-     * List of tables successfully materialized
-     */
-    tables_materialized: Array<string>;
-    /**
-     * Total Rows
-     * Total rows materialized across all tables
-     */
-    total_rows: number;
-    /**
-     * Execution Time Ms
-     * Total materialization time
+     * Operation Id
+     * SSE operation ID for progress tracking
      */
-    execution_time_ms: number;
+    operation_id: string;
     /**
      * Message
      * Human-readable status message

package/types.gen.ts

@@ -3112,43 +3112,24 @@ export type MaterializeRequest = {
 
 /**
  * MaterializeResponse
+ * Response for queued materialization operation.
  */
 export type MaterializeResponse = {
     /**
      * Status
-     * Materialization status
+     * Operation status
      */
-    status: string;
+    status?: string;
     /**
      * Graph Id
      * Graph database identifier
      */
     graph_id: string;
     /**
-     * Was Stale
-     * Whether graph was stale before materialization
-     */
-    was_stale: boolean;
-    /**
-     * Stale Reason
-     * Reason graph was stale
-     */
-    stale_reason?: string | null;
-    /**
-     * Tables Materialized
-     * List of tables successfully materialized
-     */
-    tables_materialized: Array<string>;
-    /**
-     * Total Rows
-     * Total rows materialized across all tables
-     */
-    total_rows: number;
-    /**
-     * Execution Time Ms
-     * Total materialization time
+     * Operation Id
+     * SSE operation ID for progress tracking
      */
-    execution_time_ms: number;
+    operation_id: string;
     /**
      * Message
      * Human-readable status message