clawdb-client 0.1.1

Lightweight gRPC client for ClawDB server.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# clawdb-client

Official Rust client for ClawDB.

## Install

```toml
[dependencies]
clawdb-client = "0.1.0"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
```

## Quick Start

```rust
use clawdb_client::{ClawDBBuilder, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let db = ClawDBBuilder::new()
        .endpoint("http://localhost:50050")
        .agent_id("rust-agent")
        .build()
        .await?;

    let memory_id = db.remember_typed("Track the weekly release checklist", None).await?;
    let hits = db.search("release checklist", None).await?;
    let branch = db.branch("release-dry-run", None).await?;

    println!("{} {} {}", memory_id, hits.len(), branch.id);
    Ok(())
}
```

## API Surface

The Rust client covers:
- health and readiness
- session create, validate, revoke, and count
- memory remember, typed remember, update, search, recall, list, and delete
- branch fork, lookup, diff, merge, discard, and archive
- sync run, push, pull, reconcile, and status
- reflection jobs, facts, preferences, contradictions, and resolution
- transaction begin, remember, typed remember, commit, and rollback

## Configuration

Builder fields:
- `endpoint()`
- `api_key()`
- `agent_id()`
- `workspace()`
- `role()`
- `timeout_ms()`
- `tls()`