openzca 0.1.22 → 0.1.25

package/README.md

@@ -76,7 +76,7 @@ You can also open the saved file manually (for example: `open qr.png` on macOS).
 | `openzca msg delete <msgId> <cliMsgId> <uidFrom> <threadId>` | Delete a message |
 | `openzca msg undo <msgId> <cliMsgId> <threadId>` | Recall a sent message |
 | `openzca msg upload <arg1> [arg2]` | Upload and send file(s) |
-| `openzca msg recent <threadId>` | List recent messages (`-n`, `--json`) |
+| `openzca msg recent <threadId>` | List recent messages (`-n`, `--json`); group mode uses direct group-history API |
 
 Media commands accept local files, `file://` paths, and repeatable `--url` options. Add `--group` for group threads.
 Local paths using `~` are expanded automatically (for positional file args, `--url`, and `OPENZCA_LISTEN_MEDIA_DIR`).
@@ -272,12 +272,44 @@ Listener resilience override:
 - `OPENZCA_LISTEN_DOWNLOAD_QUOTE_MEDIA`: download quoted attachment URLs (if present) into inbound media cache.
   - Default: enabled.
   - Set to `0` to keep only quote metadata/URLs without downloading.
+- `OPENZCA_LISTEN_ENFORCE_SINGLE_OWNER`: enforce one `listen` owner process per profile.
+  - Default: enabled.
+  - Set to `0` to allow multiple listeners on the same profile (not recommended).
+- `OPENZCA_LISTEN_IPC`: expose local IPC socket from `listen` so `msg upload` can reuse the active websocket session.
+  - Default: enabled.
+  - Set to `0` to disable IPC.
+- `OPENZCA_LISTEN_KEEPALIVE_RESTART_DELAY_MS`: when `--keep-alive` is on, restart listener after close code `1000`/`3000` with this delay.
+  - Default: `2000`.
+- `OPENZCA_LISTEN_KEEPALIVE_RESTART_ON_ANY_CLOSE`: force keepalive fallback restart for any close code.
+  - Default: disabled.
+  - Set to `1` if your environment closes with non-retry codes.
 
 Supervised mode notes:
 
 - Use `listen --supervised --raw` when an external process manager owns restart logic.
 - In supervised mode, internal websocket retry ownership is disabled (equivalent to forcing `retryOnClose=false`).
 
+Upload/listener coordination overrides:
+
+- `OPENZCA_UPLOAD_IPC`: try upload via active listener IPC first.
+  - Default: enabled.
+  - Set to `0` to disable IPC path.
+- `OPENZCA_UPLOAD_IPC_CONNECT_TIMEOUT_MS`: timeout for connecting to listener IPC socket.
+  - Default: `1000`.
+- `OPENZCA_UPLOAD_IPC_TIMEOUT_MS`: timeout waiting for listener IPC upload response.
+  - Default: `OPENZCA_UPLOAD_TIMEOUT_MS + 5000`.
+- `OPENZCA_UPLOAD_IPC_HANDLER_TIMEOUT_MS`: timeout applied by listener IPC while executing upload.
+  - Default: same as `OPENZCA_UPLOAD_TIMEOUT_MS` (120000 if unset).
+- `OPENZCA_UPLOAD_ENFORCE_SINGLE_OWNER`: when an active listener owner exists but IPC is unavailable, fail fast instead of starting a second listener.
+  - Default: enabled.
+  - Set to `0` to allow fallback listener startup (may disconnect active listener due duplicate websocket ownership).
+- `OPENZCA_UPLOAD_AUTO_THREAD_TYPE`: auto-detect `msg upload` thread type (group/user) when `--group` is not provided.
+  - Default: disabled (`0`) for safer routing.
+  - Set to `1` to enable cache/probe-based detection.
+- `OPENZCA_UPLOAD_GROUP_PROBE`: allow `msg upload` to probe `getGroupInfo` when auto thread-type detection is enabled.
+  - Default: enabled.
+  - Set to `0` to skip probe and rely only on cache matches.
+
 ### account — Multi-account profiles
 
 | Command | Description |