rust-kgdb 0.6.9 → 0.6.13
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.
- package/CHANGELOG.md +46 -0
- package/README.archive.md +2632 -0
- package/README.md +839 -2267
- package/examples/fraud-detection-agent.js +458 -7
- package/examples/underwriting-agent.js +651 -20
- package/hypermind-agent.js +2221 -76
- package/index.js +28 -0
- package/ontology/agent-memory.ttl +421 -0
- package/package.json +10 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,52 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to the rust-kgdb TypeScript SDK will be documented in this file.
|
|
4
4
|
|
|
5
|
+
## [0.6.10] - 2025-12-15
|
|
6
|
+
|
|
7
|
+
### Complete KG Configuration & Default Settings Documentation
|
|
8
|
+
|
|
9
|
+
Added comprehensive documentation to examples explaining KG storage modes and defaults:
|
|
10
|
+
|
|
11
|
+
#### Knowledge Graph Storage Modes
|
|
12
|
+
```javascript
|
|
13
|
+
// MODE 1: IN-MEMORY (Default)
|
|
14
|
+
const db = new GraphDB('http://example.org/') // Zero config
|
|
15
|
+
// - Storage: RAM (HashMap-based SPOC indexes)
|
|
16
|
+
// - Performance: 2.78µs lookups, 146K triples/sec
|
|
17
|
+
// - Persistence: None (data lost on restart)
|
|
18
|
+
|
|
19
|
+
// MODE 2: ENDPOINT (Distributed Cluster)
|
|
20
|
+
const agent = await HyperMindAgent.spawn({
|
|
21
|
+
endpoint: 'http://rust-kgdb-coordinator:8080', // K8s service
|
|
22
|
+
...
|
|
23
|
+
})
|
|
24
|
+
// - Storage: HDRF-partitioned across executors
|
|
25
|
+
// - Persistence: RocksDB/LMDB per executor
|
|
26
|
+
// - Consensus: Raft for distributed writes
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
#### Default Settings (When Not Specified)
|
|
30
|
+
| Setting | Default | Description |
|
|
31
|
+
|---------|---------|-------------|
|
|
32
|
+
| `storage` | `'inmemory'` | Not 'rocksdb' or 'lmdb' |
|
|
33
|
+
| `endpoint` | `null` | Local mode, no network |
|
|
34
|
+
| `graphUri` | `null` | Default graph |
|
|
35
|
+
| `working.maxSize` | `1MB` | Current task context |
|
|
36
|
+
| `episodic.retentionDays` | `30` | Conversation history |
|
|
37
|
+
| `weights` | `{recency: 0.3, relevance: 0.5, importance: 0.2}` | Memory scoring |
|
|
38
|
+
| `sandbox` | `null` | **⚠️ NO SANDBOX = full access** |
|
|
39
|
+
|
|
40
|
+
#### Sandbox Warning
|
|
41
|
+
```javascript
|
|
42
|
+
// ⚠️ WITHOUT .withSandbox(), agent has UNRESTRICTED capabilities!
|
|
43
|
+
// Always use sandbox in production:
|
|
44
|
+
.withSandbox({
|
|
45
|
+
capabilities: ['ReadKG', 'ExecuteTool'], // Whitelist only
|
|
46
|
+
fuelLimit: 1_000_000, // Gas limit
|
|
47
|
+
maxExecTime: 30_000 // Timeout
|
|
48
|
+
})
|
|
49
|
+
```
|
|
50
|
+
|
|
5
51
|
## [0.6.9] - 2025-12-15
|
|
6
52
|
|
|
7
53
|
### Deep Technical Comparison: Why rust-kgdb Wins
|