rust-kgdb 0.3.8 → 0.3.9

package/README.md

@@ -581,6 +581,42 @@ HyperMind is a **production-grade neuro-symbolic agentic framework** built on ru
 - **Neural Planning**: LLM-based planning (Claude, GPT-4o)
 - **Symbolic Execution**: rust-kgdb knowledge graph operations
 
+### Quick Start: Create an Agent in 3 Lines
+
+```typescript
+const { HyperMindAgent } = require('rust-kgdb')
+
+// 1. Spawn an agent
+const agent = await HyperMindAgent.spawn({
+  name: 'university-explorer',
+  model: 'mock',                        // 'mock' | 'claude-sonnet-4' | 'gpt-4o'
+  tools: ['kg.sparql.query'],           // Available tools
+  endpoint: 'http://localhost:30080'    // rust-kgdb cluster endpoint
+})
+
+// 2. Ask natural language questions
+const result = await agent.call('Find all professors in the database')
+
+// 3. Get results
+console.log(result.sparql)   // "PREFIX ub: <...> SELECT ?x WHERE { ?x a ub:Professor }"
+console.log(result.results)  // [{ bindings: { x: 'http://...' } }, ...]
+console.log(result.success)  // true
+```
+
+### Run the Benchmark Suite
+
+```typescript
+const { runHyperMindBenchmark } = require('rust-kgdb')
+
+// Run 12 LUBM benchmark tests
+const stats = await runHyperMindBenchmark('http://localhost:30080', 'mock', {
+  saveResults: true  // Saves to hypermind_benchmark_*.json
+})
+
+console.log(`Success Rate: ${stats.hypermindSyntaxRate}%`)  // 100%
+console.log(`Avg Latency: ${stats.avgLatencyMs}ms`)         // ~6.58ms
+```
+
 ### Architecture Overview
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rust-kgdb",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "High-performance RDF/SPARQL database with GraphFrames analytics, vector embeddings, Datalog reasoning, Pregel BSP processing, and HyperMind neuro-symbolic agentic framework",
   "main": "index.js",
   "types": "index.d.ts",