docs: document peer/ operations (touch/rm/write)

This commit is contained in:
lkn 2026-07-21 14:56:40 +02:00
parent 4a87d25f22
commit 88a4119707
3 changed files with 13 additions and 4 deletions

View File

@ -48,7 +48,7 @@ ollie/
fifo.out read: pop the next queued prompt
models read: available models from the backend
offset read: byte offset in chat immediately after the last user prompt
peer/ dir: peer session references
peer/ dir: peer links (touch to add, rm to remove — both sides; write to send prompt)
plan r/w: scratch space for agent planning (persisted per session)
proc/ dir: detached background processes
prompt write: submit a prompt to the agent

View File

@ -82,7 +82,7 @@ Sessions live at `${OLLIE}/s/`. Each session is a directory; all operations are
| `fifo.out` | read | Pop queued prompt (FIFO output) |
| `models` | read | Available models for current backend |
| `offset` | read | Byte offset after last user prompt |
| `peer/` | dir | Peer session references |
| `peer/` | dir | Peer links. `touch` to add, `rm` to remove (both sides updated). Write to send prompt to peer. |
| `plan` | r/w | Session-scoped markdown checklist; survives compaction; visible to peers |
| `proc/` | dir | Detached background processes |
| `prompt` | write | Submit a prompt to the agent |
@ -143,4 +143,13 @@ cat $OLLIE/s/{id}/state
# Discover available models
cat $OLLIE/s/{id}/models
# Add a peer link (bidirectional)
touch $OLLIE/s/{id}/peer/{peerid}
# Send a prompt to a peer
echo "your message" > $OLLIE/s/{id}/peer/{peerid}
# Remove a peer link (bidirectional)
rm $OLLIE/s/{id}/peer/{peerid}
```

View File

@ -71,8 +71,8 @@ All session operations go through the D-Bus interface.
| Method | Args | Returns | Purpose |
|---|---|---|---|
| `PeerAdd` | session_id, peer_id | bool | Add peer relationship |
| `PeerRemove` | session_id, peer_id | bool | Remove peer relationship |
| `PeerAdd` | session_id, peer_id | bool | Add bidirectional peer link (both sides updated) |
| `PeerRemove` | session_id, peer_id | bool | Remove bidirectional peer link (both sides updated) |
| `PeerList` | session_id | array of peer_ids | List peers |
| `PeerSubmit` | session_id, peer_id, prompt | bool | Send prompt to peer |