superbrain-distributed-sdk 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +17 -14
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -90,22 +90,25 @@ const received = JSON.parse((await clientB.read(ctxPtr, 0, 0)).toString());
90
90
  ## 📊 Architecture
91
91
 
92
92
  ```
93
- Your LLM App SuperBrain Cluster
94
- ┌──────────────┐ ┌──────────────────────┐
95
- │ Node.js SDK │──gRPC──>│ Coordinator │
96
- │ │ │ (Control Plane) │
97
- │ allocate() │ └──────────┬───────────┘
98
- │ write() │ │ pointer map
99
- │ read() │ ┌──────────▼───────────┐
100
- │ free() │──gRPC──>│ Memory Nodes │
101
- └──────────────┘ │ (Data Plane) │
102
- │ 1TB+ pooled RAM │
103
- └──────────────────────┘
93
+ Your LLM App (SDK) SuperBrain Cluster
94
+ ┌─────────────────────────┐
95
+ │ allocate(size) ────────┼──(1)──► Coordinator (Control Plane)
96
+ │ free(ptr_id) ────────┼──(5)──► Maps pointers → node locations
97
+ │ │ │
98
+ │ │ (2) pointer map returned
99
+ │ │ │
100
+ │ write(ptr_id, data) ───┼──(3)──►┌───────▼──────────────┐
101
+ │ read(ptr_id) ────────┼──(4)──►│ Memory Nodes │
102
+ └─────────────────────────┘ │ (Data Plane) │
103
+ │ 1TB+ pooled RAM │
104
+ └──────────────────────┘
105
+
106
+ CRITICAL: write() and read() bypass the Coordinator entirely.
107
+ They stream directly to the Memory Nodes over gRPC for maximum throughput (~100 MB/s).
108
+ The Coordinator is ONLY in the control path (allocate + free).
104
109
  ```
105
110
 
106
- **Control plane** (Coordinator): Routes allocation requests, maintains node registry.
107
- **Data plane** (Memory Nodes): Direct gRPC streams for maximum throughput.
108
- **Client**: Talks to nodes directly after allocation — Coordinator is never in the hot path.
111
+ **Why this matters**: The Coordinator never becomes a bottleneck for your data. 1000 agents can read/write simultaneously to different nodes without fighting for the same control plane.
109
112
 
110
113
  ---
111
114
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "superbrain-distributed-sdk",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Premium High-Performance Distributed Memory SDK for AI Agents",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",