Submit root events through the local socket

[onechat] / README.rst

diff --git a/README.rst b/README.rst
index 8002ea095f9ea275e8ad56b4687c62aa5ee702f6..6b011a872c9ea2d777a7251d5efa0dd5c8617d02 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -77,6 +77,13 @@ or Telegram:
 The session file gives full access to the account. If it leaks, remove
 the device in Linked devices on the phone.
 
+External events
+===============
+
+Use ``onechat notify --source CHECK --id EVENT --text TEXT`` to send
+external data to the root at its next turn. Success means accepted, not
+processed. See ``onechat notify --help`` for the local test limits.
+
 User service
 ============
 
@@ -154,11 +161,14 @@ replies show with Markdown styles and tables. These lines are commands:
 ``/stop NAME``
    Stops the subagent NAME.
 
+``/image PATH [caption]``
+   Sends a JPEG, PNG, or WebP image. Quote a path with spaces.
+
 ``/whatsapp ...``
    The WhatsApp commands above.
 
-In Telegram, write as in the client. ``onechat help`` lists all
-commands.
+In Telegram, write as in the client, also with photos and image files.
+``onechat help`` lists all commands.
 
 *********************
  What the agent does
@@ -190,6 +200,18 @@ WhatsApp
    ask. It proposes to route a chat that is only about one area to the
    child of that area, and sets the route after you agree.
 
+Images
+   Send a photo in Telegram, WhatsApp, or with ``/image`` to the agent.
+   Its memory keeps what the image shows, and it can look at an older
+   image again. Ask it to show an image or send one to a WhatsApp chat.
+
+Voice notes
+   The agent hears Telegram and WhatsApp voice notes through local
+   Whisper. Nix includes the small model. Outside Nix, set
+   ``voice.model`` in ``config.json`` and install ``whisper-cli``.
+   ``voice.transcriber`` selects another executable. No audio goes to a
+   transcription service.
+
 Schedules
    Ask for reminders and timed tasks, such as "every weekday at 8, tell
    me what my groups talked about". Each run uses the quota, so runs are