pond-db 0.8.0

Lossless storage and hybrid search for sessions from any AI agent client
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

---
source: src/main.rs
expression: sub.render_long_help().to_string()
---
Fetch a session or message.

Returns readable transcripts by id: a whole session (`--session-id`) or one message with optional surrounding context (`--message-id`). Pagination cursors (`after-id:`) print at the end of truncated output.

Usage: pond get [OPTIONS] <--session-id <ID>|--message-id <ID>>

Options:
      --session-id <ID>
          Fetch an entire session by id. Mutually exclusive with `--message-id`

      --message-id <ID>
          Fetch a single message by id. Mutually exclusive with `--session-id`

      --namespace <NAMESPACE>
          Tenant namespace. The personal pond has exactly one; leave at the default
          
          [default: local]

      --context-depth <CONTEXT_DEPTH>
          For `--message-id` mode: include this many sibling messages on each side (grep -C style). Ignored in session mode
          
          [default: 0]

      --limit <LIMIT>
          Cap on returned messages (session mode) or parts (message mode)
          
          [default: 20]

      --response-mode <RESPONSE_MODE>
          Depth: conversational, complete, or verbatim.
          
          conversational = text + part summaries; complete = all messages + summaries; verbatim = full parts inline. With `--message-id` it selects which siblings fill the context window.
          
          [default: conversational]
          [possible values: conversational, complete, verbatim]

      --session-from <SESSION_FROM>
          Session mode only: which end to read from.
          
          start = oldest first (default); end = most recent, e.g. to recover context after compaction.
          
          [default: start]
          [possible values: start, end]

      --after-id <ID>
          Continuation anchor from a prior response: last message id (session) or last part id (message). Exclusive lower bound

      --format <FORMAT>
          [default: pretty]
          [possible values: pretty, json]

  -h, --help
          Print help (see a summary with '-h')

Global options:
      --storage-path <URL>
          Storage destination: a local path or remote URL.
          
          Accepts a bare path, `~/path`, `file://`, `s3://bucket/prefix`, `s3+https://host/bucket/prefix`, `gs://`, or `az://`. Default: `[storage].path` from config, then the platform data dir (`~/.local/share/pond`).
          
          [env: POND_STORAGE_PATH]

      --config <PATH>
          Config file to read (default: `~/.config/pond/config.toml`)
          
          [env: POND_CONFIG]

  -v, --verbose...
          Increase logging verbosity

  -q, --quiet...
          Decrease logging verbosity

Examples:
  pond get --session-id 58a96901-4a4f-40be-a3c1-62419ec8c580
  pond get --session-id <ID> --session-from end      most recent messages first
  pond get --message-id <ID> --context-depth 3       a hit plus its neighbors
  pond get --session-id <ID> --response-mode verbatim --format json