pond-db 0.11.0

Lossless storage and hybrid search for sessions from any AI agent client
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
83

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

`--session-id` returns the whole session as a conversational transcript (user/assistant text + one-line tool/file refs). `--message-id` returns that one message with its full parts (tool bodies included) plus conversational neighbors. Params are prefixed by scope.

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 (with its full parts). Mutually exclusive with `--session-id`

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

      --session-limit <SESSION_LIMIT>
          Session scope: max messages per page
          
          [default: 20]

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

      --session-after-message-id <ID>
          Session scope: page forward - messages after this id (from a prior page's bottom marker)

      --session-before-message-id <ID>
          Session scope: page backward - messages before this id (from a prior page's top marker)

      --message-context-before <MESSAGE_CONTEXT_BEFORE>
          Message scope: conversational siblings before the target (grep -B)
          
          [default: 3]

      --message-context-after <MESSAGE_CONTEXT_AFTER>
          Message scope: conversational siblings after the target (grep -A)
          
          [default: 3]

      --format <FORMAT>
          [default: text]
          [possible values: text, 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://`, `az://`, or the keyword `local` (the platform default local data dir). Default: `[storage].path` from config, then the platform data dir (`~/.local/share/pond`).
          
          [env: POND_STORAGE_PATH]

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

  -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
  pond get --session-id <ID> --session-after-message-id <ID>    page down
  pond get --message-id <ID> --message-context-before 3 --message-context-after 3